阿里云監(jiān)控服務(wù)-SDK手冊(cè)-D

1、云監(jiān)控新版SDK使用手冊(cè)云監(jiān)控/新版SDK使用手冊(cè)云監(jiān)控/新版SDK使用手冊(cè) PAGE 14 PAGE 14新版SDK使用手冊(cè)SDK使用手冊(cè)SDK安裝com.aliyunaliyun-java-sdk-core2.1.9com.aliyunaliyun-java-sdk-cms3.1.0SDK下載可通過以下地址直接下載最新版本SDK請(qǐng)下載3.1.0/#nexus-search;quickaliyun-java-sdk-cms 測(cè)試代碼使用時(shí)請(qǐng)將如下示例中的accessKey和accessSecret替換成您的Access Keyimport java.io.UnsupportedEncodin

2、gException; import java.io.UnsupportedEncodingException; import java.text.SimpleDateFormat;import java.util.Calendar;import org.junit.Before;import org.junit.Test;import com.aliyuncs.AcsResponse; import com.aliyuncs.DefaultAcsClient; import com.aliyuncs.IAcsClient; import com.aliyuncs.RpcAcsRequest;

3、import com.aliyuncs.cms.model.v20151020.DescribeMetricDatumRequest; import com.aliyuncs.cms.model.v20151020.DescribeMetricDatumResponse; import com.aliyuncs.cms.model.v20151020.QueryMetricRequest;import com.aliyuncs.cms.model.v20151020.QueryMetricResponse; import com.aliyuncs.exceptions.ClientExcept

4、ion;import com.aliyuncs.http.FormatType; import com.aliyuncs.http.HttpResponse; import file.DefaultProfile; import file.IClientProfile;public class Snippet IAcsClient client = null;Beforepublic void init() throws ClientException / 測(cè)試IClientProfileprofile=DefaultProfile.getProfile(cn-hangzhou,); clie

5、nt = newDefaultAcsClient(profile);/ System.setProperty(xyHost, 49);/ /此設(shè)置用于設(shè)置代理，用fiddler攔截查看http請(qǐng)求，便于調(diào)試。49是云監(jiān)控開發(fā)測(cè)試機(jī)，聯(lián)調(diào)時(shí)可以打開此選項(xiàng)，由云監(jiān)控人員直接trace。/ System.setProperty(xyPort, 8888);protectedKexecute(Trequest) try/ todo something. request.setContentType(FormatType.JSON); request.setAcceptFormat(FormatType

6、.JSON);doAction(request);AcsResponse response = client.getAcsResponse(request); return (K) response; catch (ClientException e) / todo something. e.printStackTrace();return null;protected void doAction(T request) try / todo something.HttpResponse response = client.doAction(request); System.out.printl

7、n(response url:tt + response.getUrl();System.out.println(Response Content: ntt + new String(response.getContent(), UTF-8); catch (ClientException e) / todo something. e.printStackTrace(); catch (UnsupportedEncodingException e) e.printStackTrace();e.printStackTrace();Testpublic void queryMetric() Que

8、ryMetricRequest request = new QueryMetricRequest(); request.setProject(acs_ecs); request.setMetric(vm.MemoryUtilization); request.setPeriod(300); request.setDimensions(instanceId:i-23gp0zfjl); request.setLength(10);request.setPage(1);Calendar cal = Calendar.getInstance(); cal.add(Calendar.DAY_OF_MON

9、TH, -10);cal.add(Calendar.HOUR_OF_DAY, -8);SimpleDateFormat format = new SimpleDateFormat(yyyy-MM-ddTHH:mm:ssZ);/ String endTime = format.format(cal.getTime();cal.add(Calendar.MINUTE, -10);String startTime = format.format(cal.getTime();/ request.setStartTime(2015-11-29 00:00:00); request.setStartTim

10、e(startTime); QueryMetricResponse response = execute(request);返回結(jié)果NextToken: 2, Datapoints: Datapoint: Sum: 113.36,timestamp: 1448070000000,Maximum: 22.71,userId: 1058019241820815,Minimum: 22.51,value: 22.71, instanceId: i-23gp0zfjl, SampleCount: 5,Average: 22.67,Sum: 113.56,timestamp: 1448070300000

11、,Maximum: 22.71,userId: 1058019241820815,Minimum: 22.7,value: 22.71, instanceId: i-23gp0zfjl, SampleCount: 5,Average: 22.71,Sum: 113.55,timestamp: 1448070600000,Maximum: 22.71,userId: 1058019241820815,Minimum: 22.7,value: 22.7,instanceId: i-23gp0zfjl, SampleCount: 5,Average: 22.71,Sum: 113.56,timest

12、amp: 1448070900000,Maximum: 22.71,userId: 1058019241820815,Minimum: 22.7,value: 22.71, instanceId: i-23gp0zfjl, SampleCount: 5,Average: 22.71,Sum: 113.58,timestamp: 1448071200000,Maximum: 22.73,userId: 1058019241820815,Minimum: 22.71,value: 22.71, instanceId: i-23gp0zfjl, SampleCount: 5,Average: 22.

13、72,Sum: 113.57,timestamp: 1448071500000,Maximum: 22.71,userId: 1058019241820815,Minimum: 22.71,value: 22.71, instanceId: i-23gp0zfjl, SampleCount: 5,Average: 22.71,Sum: 113.55,timestamp: 1448071800000,Maximum: 22.71,userId: 1058019241820815,Minimum: 22.7,value: 22.71,instanceId: i-23gp0zfjl, instanc

14、eId: i-23gp0zfjl, SampleCount: 5,Average: 22.71,Sum: 113.56,timestamp: 1448072100000,Maximum: 22.71,userId: 1058019241820815,Minimum: 22.7,value: 22.71, instanceId: i-23gp0zfjl, SampleCount: 5,Average: 22.71,Sum: 113.17,timestamp: 1448072400000,Maximum: 22.72,userId: 1058019241820815,Minimum: 22.51,

15、value: 22.72, instanceId: i-23gp0zfjl, SampleCount: 5,Average: 22.63,Sum: 113.54,timestamp: 1448072700000,Maximum: 22.71,userId: 1058019241820815,Minimum: 22.71,value: 22.71, instanceId: i-23gp0zfjl, SampleCount: 5,Average: 22.71,TraceId: 2A5126FD-5970-4876-9A99-831EABED3E0D,Success: true, Code: 200

16、發(fā)展歷史- 3.0.5 版 新版接口，支持ECS基礎(chǔ)監(jiān)控?cái)?shù)據(jù)查詢- 3.1.0 版 下線3.0.5版的冗余接口SDK使用手冊(cè)前置條件：需要安裝有python2.7版本安裝pip，如果已有pip，或者其他方案，請(qǐng)略過：如何安裝pip（ HYPERLINK /en/latest/installing.html /en/latest/installing.html）pip install aliyunclipip install -Iv aliyun-python-sdk-cms=3.0.5 aliyuncli configure安裝aliyuncli，如果已安裝，請(qǐng)略過：pip install a

17、liyunclipip install -Iv aliyun-python-sdk-cms=3.0.5 aliyuncli configurealiyuncli相關(guān)文檔1 aliyuncli相關(guān)文檔2pip install aliyun-python-sdk-core pip install aliyun-python-sdk-cms安裝cms-python-sdk的依賴：pip install aliyun-python-sdk-core pip install aliyun-python-sdk-cmscode示例：from aliyunsdkcore import clientfrom

18、aliyunsdkcore import clientfrom aliyunsdkcms.request.v20151020 import QueryMetricRequestclt = client.AcsClient(your_access_key,your_access_secret,cn-hangzhou) request = QueryMetricRequest.QueryMetricRequest() request.set_accept_format(json)request.set_Project(acs_slb) request.set_Metric(ActiveConnec

19、tion) request.set_StartTime(2016-02-03T08:00:00Z)request.set_Dimensions(instanceId:1527cf43124-cn-ningxiazhongwei) request.set_Period(60)result = clt.do_action(request) print resultNode.js SDK使用手冊(cè)前置條件var Metrics = require(aliyun-metrics) var client=new Metrics(accesskeyId: your_accesskey_id,accesske

20、ySecret: your_accesskey_secretvar Metrics = require(aliyun-metrics) var client=new Metrics(accesskeyId: your_accesskey_id,accesskeySecret: your_accesskey_secret)client.queryData( project:acs_rds, metric:CpuUsage, period:300,startTime:2016-03-08T07:20:00Z, endTime:2016-03-08T09:20:00Z,dimensions:inst

21、anceId:your_instanceId, function(error, data) if (error)console.log(error) else if (!data)console.log(data is null)elseconsole.log(data);使用須知：的公網(wǎng)流量為例，原單位為KB/min,則統(tǒng)計(jì)周期為5min的求和 計(jì)算，返回結(jié)果為5min的流量總和。新版接口支持ECS基礎(chǔ)監(jiān)控?cái)?shù)據(jù)查詢，舊版接口不支持OpenAPI支持查詢最近31天的監(jiān)控?cái)?shù)據(jù)參數(shù)中的Dimension為json串，例如：instanceId:i-23gyb3kkd云服務(wù)器ECS監(jiān)控項(xiàng)參考ECS基

22、礎(chǔ)監(jiān)控?cái)?shù)據(jù)，無需安裝插件，需使用新版接口才可查詢到Project為acs_ecs60s，Period賦值為60或60的整數(shù)倍Dimensions中的instanceId賦值ecs實(shí)例的instanceIdMetric監(jiān)控項(xiàng)描述單位Dimensions統(tǒng)計(jì)方法CPUUtilizationCPU百分比PercentinstanceId最大值、最小值、平均值InternetInRate New公網(wǎng)入流量平均速率bpsinstanceId最大值、最小值、平均值IntranetInRate New私網(wǎng)入流量平均速率bpsinstanceId最大值、最小值、平均值InternetOutRat eNew公網(wǎng)

23、出流量平均速率bpsinstanceId最大值、最小值、平均值IntranetOutRat eNew私網(wǎng)出流量平均速率bpsinstanceId最大值、最小值、平均值DiskReadBPSN ew系統(tǒng)磁盤總讀BPSbpsinstanceId最大值、最小值、平均值DiskWriteBPSN ew系統(tǒng)磁盤總寫B(tài)PSbpsinstanceId最大值、最小值、平均值DiskReadIOPS系統(tǒng)磁盤讀IOPSCount/SecondinstanceId最大值、最小值、平均值DiskWriteIOPS系統(tǒng)磁盤寫IOPSCount/SecondinstanceId最大值、最小值、平均值InternetInN

24、ew公網(wǎng)入流量BytesinstanceId最大值、最小值、平均值、求和值IntranetInNew私網(wǎng)入流量BytesinstanceId最大值、最小值、平均值、求和值InternetOutNe w公網(wǎng)出流量BytesinstanceId最大值、最小值、平均值、求和值IntranetOutNe w私網(wǎng)出流量BytesinstanceId最大值、最小值、平均值、求和值操作系統(tǒng)級(jí)監(jiān)控?cái)?shù)據(jù)，需要安裝插件才能獲取Project為acs_ecs。采樣周期為60s，Period賦值為60或60的整數(shù)倍Dimensions中的diskname、mountpoint(linux類)或磁盤路徑(windows

25、類)Metric監(jiān)控項(xiàng)描述單位Dimensions統(tǒng)計(jì)方法vm.DiskIORead New磁盤IO讀bpsinstanceId,disk name最大值、最小值、平均值vm.DiskIOWrite New磁盤IO寫bpsinstanceId,disk name最大值、最小值、平均值vm.DiskUtilizati on磁盤使用率PercentinstanceId,mou ntpoint最大值、最小值、平均值、求和值vm.LoadAverag e平均負(fù)載無instanceId,peri od,period有最大值、最小值、平均值1min,5min, 15min三種值vm.MemoryUtil

26、ization內(nèi)存使用率PercentinstanceId最大值、最小值、平均值vm.TcpCounttcp連接數(shù)count/mininstanceId , state,state包括LISTEN、SYN_SENT、ESTABLISHED、SYN_RECV、FIN_WAIT1、CLOSE_WAIT、FIN_WAIT2、LAST_ACK、TIME_WAIT、CLOSING、CLOSED最大值、最小值、平均值vm.ProcessCou nt系統(tǒng)進(jìn)程總數(shù)count/mininstanceId最大值、最小值、平均值vm.Process.nu mber進(jìn)程數(shù)，添加進(jìn)程監(jiān)控后，會(huì)對(duì)指定關(guān)注的進(jìn)程進(jìn)行計(jì)數(shù)，

27、顯示正在運(yùn)行的被關(guān)注進(jìn)程總數(shù)count/mininstanceId,proc essName最大值、最小值、平均值注：裝了新版agent后，查詢vm.DiskIORead和vm.DiskIOWrite時(shí)，diskname的value需賦值為掛載點(diǎn)目錄云數(shù)據(jù)庫RDS監(jiān)控項(xiàng)參考Project為acs_rds。采樣周期為300s，Period賦值為300或300的整數(shù)倍Dimensions中的instanceId賦值RDS實(shí)例的instanceIdMetric監(jiān)控項(xiàng)描述單位DimensionsCpuUsageCPU使用率PercentinstanceId, type= CpuUsageDiskUsa

28、ge磁盤使用率PercentinstanceId, type= DiskUsageIOPSUsageIOPS使用率PercentinstanceId, type= IOPSUsageConnectionUsage連接數(shù)使用率PercentinstanceId, type= ConnectionUsageMemoryUsage內(nèi)存使用率PercentinstanceId, type= MemoryUsageMySQL_NetworkInN ewMysql網(wǎng)絡(luò)入流量bpsinstanceIdMySQL_NetworkOut NewMysql網(wǎng)絡(luò)出流量bpsinstanceIdSQLServer_N

29、etworkI nNewSQLServer網(wǎng)絡(luò)入流量bpsinstanceIdSQLServer_Network OutNewSQLServer網(wǎng)絡(luò)出流量bpsinstanceId負(fù)載均衡Sever Load Balancer監(jiān)控項(xiàng)參考Project為acs_slb，采樣周期為60s，Period賦值為60或60的整數(shù)倍Dimensions中的instanceId賦值SLB實(shí)例的instanceIdDimensions中的port賦值SLB實(shí)例的端口Dimensions中的vip賦值SLB實(shí)例的服務(wù)地址Metric描述單位DimensionsPacketTX端口每秒流出數(shù)據(jù)包數(shù)Count/Se

30、condinstanceId, port, vipPacketRX端口每秒流入數(shù)據(jù)包數(shù)Count/SecondinstanceId, port, vipTrafficRXNew端口每秒流入數(shù)據(jù)量bpsinstanceId, port, vipTrafficTXNew端口每秒流出數(shù)據(jù)量bpsinstanceId, port, vipActiveConnection端口當(dāng)前活躍連接數(shù)，既客戶端正在訪問SLB產(chǎn)生的連接CountinstanceId, port, vipInactiveConnection端口當(dāng)前非活躍連接數(shù)，既訪問SLB后未斷開的空閑的連接CountinstanceId, port

31、, vipNewConnection端口當(dāng)前新建連接數(shù)CountinstanceId, port, vip對(duì)象存儲(chǔ)OSS監(jiān)控項(xiàng)參考參見OSS監(jiān)控項(xiàng)參考云數(shù)據(jù)庫 for Memcache 版 監(jiān)控項(xiàng)參考Project為acs_ocs，采樣周期為60s，Period賦值為60或60的整數(shù)倍Dimensions中的instanceId賦值memcache實(shí)例的instanceIdMetric描述單位DimensionsEvict緩存每秒數(shù)據(jù)逐出量Count/SecondinstanceIdHitRate緩存命中率PercentinstanceIdIntranetIn緩存輸入帶寬Bpsinstance

32、IdIntranetOut緩存輸出帶寬BpsinstanceIdItemCount緩存數(shù)據(jù)個(gè)數(shù)CountinstanceIdUsedMemCache已用緩存BytesinstanceIdUsedQps已使用QPSCountinstanceId彈性IP EIPProject為acs_vpc_eip，采樣周期為60s，Period賦值為60或60的整數(shù)倍Dimensions中的instanceId賦值EIP實(shí)例的instanceIdDimensions中的ipEIP實(shí)例的IP地址Metric描述單位Dimensionsnet.tx流入流量ByteinstanceId，ipnet.rx流出流量Byt

33、einstanceId，ipnet.txPkgs流入數(shù)據(jù)包數(shù)CountinstanceId，ipnet.rxPkgs流出數(shù)據(jù)包數(shù)CountinstanceId，ip云數(shù)據(jù)庫 for Redis版Project為acs_kvstore，采樣周期為60s，Period賦值為60或60的整數(shù)倍Dimensions中的instanceId賦值Redis實(shí)例的instanceIdMetric描述單位DimensionsMemoryUsage已用容量百分比percentinstanceIdQPSUsage已用QPS百分比percentinstanceIdConnectionUsage已用連接數(shù)百分比per

34、centinstanceIdIntranetInRatio寫入網(wǎng)絡(luò)帶寬使用率percentinstanceIdIntranetOutRatio讀取網(wǎng)絡(luò)帶寬使用率percentinstanceIdIntranetIn寫入網(wǎng)絡(luò)速率bpsinstanceIdIntranetOut讀取網(wǎng)絡(luò)速率bpsinstanceIdFailedCount操作KVSTORE失敗次數(shù)Count/SecondinstanceId消息和通知服務(wù)MNSProject為acs_mns，采樣周期為300s，Period賦值為300或300的整數(shù)倍Dimensions中的uid賦值云賬號(hào)的云賬號(hào)ID，注意使用時(shí)需要將uid做36進(jìn)

35、制轉(zhuǎn)換Dimensions中的regionregionDimensions中的bid：公有云用戶統(tǒng)一賦值26842Dimensions中的queue賦值隊(duì)列名稱Metric描述單位DimensionsActiveMessages活躍消息數(shù)Countuid,region,bid,queueInactiveMessages非活躍消息數(shù)Countuid,region,bid,queueDelayMessages延時(shí)消息數(shù)Countuid,region,bid,queue內(nèi)容分發(fā)網(wǎng)絡(luò)CDNProject為acs_cdn，采樣周期為300s，Period賦值為300或300的整數(shù)倍Dimensions中

36、的instanceIdMetric描述單位DimensionsQPS每秒請(qǐng)求數(shù)QPS，時(shí)間粒度內(nèi)的總訪問次數(shù)/時(shí)間粒度CountinstanceIdBPS網(wǎng)絡(luò)帶寬峰值BPS，單位時(shí)間內(nèi)網(wǎng)絡(luò)流量的最大值BpsinstanceIdhitRate字節(jié)命中率，時(shí)間粒度內(nèi)請(qǐng)求的字節(jié)數(shù)命中緩存的概率PercentinstanceIdsrcBps回源帶寬峰值srcBps，單位時(shí)間內(nèi)回源流量的最大值BpsinstanceIdcode2xx返回碼2xx占比，時(shí)間粒度內(nèi)http返回碼2XX占全部返回碼的百分比PercentinstanceIdcode3xx返回碼3xx占比，時(shí)間粒度內(nèi)http返回碼3XX占全部返回碼的百分比PercentinstanceIdcode4xx返回碼4xx占比，時(shí)間粒度內(nèi)http返回碼4XX占全部返回碼的百分比PercentinstanceIdcode5xx返回碼5xx占比，時(shí)間粒度內(nèi)http返回碼5XX占全部返回碼的百分比PercentinstanceIdcodeOther其他返回碼占比，除上述返回碼外，其他http返回碼占全部返回碼的百分比PercentinstanceId分析型數(shù)據(jù)庫 Analytic DBProject為acs_ads，采樣周期為60s，Period賦值為60或60的整數(shù)倍M