云监控监控数据上报

您可以使用API或SDK上报监控数据。
注意事项

• SDK支持python（2.6 +）与bash

• userid，是用户的账号ID。
• 监控项名称：创建监控项时填写的“监控项名称”。
• 监控项值：监控项对应的监控数据。
• 字段信息：创建监控项时填写的“字段信息”和它的值。这个参数用于对数据区分维度。

1. 下载SDK
   a.自定义监控SDK（python版） ：cms_post.py
   b. 自定义监控SDK（bash版） ：cms_post.sh
2. 编写脚本。
   a. 在用户的脚本中，import cms_post，调用cms_post的post方法推送数据到云监控。
   b. post方法中传入4个参数，分别为userid, 监控项名称，监控项值，字段信息，您只需添加定时任务即可。
3. 定时调度脚本，按创建监控项时定义的上报周期上报数据。Linux环境可以使用Crontab，Windows环境可以使用quartz.net。
4. 补充说明：请在您的脚本开始处添加对应的解释器，一般默认#!/usr/bin/python，在test.py中，import cms_post，然后调用cms_post.post()上报您的监控数据。请将您的test.py文件和cms_post.py文件放在同一文件夹下，避免import时发生错误。

1. [backcolor=transparent]#!/usr/bin/python
2. [backcolor=transparent]import[backcolor=transparent] cms_post
4. [backcolor=transparent]def[backcolor=transparent] get_mem_usage_percent[backcolor=transparent]():
5. [backcolor=transparent]    [backcolor=transparent]try[backcolor=transparent]:
6. [backcolor=transparent]        f [backcolor=transparent]=[backcolor=transparent] open[backcolor=transparent]([backcolor=transparent]'/proc/meminfo'[backcolor=transparent],[backcolor=transparent] [backcolor=transparent]'r'[backcolor=transparent])
7. [backcolor=transparent]        [backcolor=transparent]for[backcolor=transparent] line [backcolor=transparent]in[backcolor=transparent] f[backcolor=transparent]:
8. [backcolor=transparent]            [backcolor=transparent]if[backcolor=transparent] line[backcolor=transparent].[backcolor=transparent]startswith[backcolor=transparent]([backcolor=transparent]'MemTotal:'[backcolor=transparent]):
9. [backcolor=transparent]                mem_total [backcolor=transparent]=[backcolor=transparent] [backcolor=transparent]int[backcolor=transparent]([backcolor=transparent]line[backcolor=transparent].[backcolor=transparent]split[backcolor=transparent]()[[backcolor=transparent]1[backcolor=transparent]])
10. [backcolor=transparent]            [backcolor=transparent]elif[backcolor=transparent] line[backcolor=transparent].[backcolor=transparent]startswith[backcolor=transparent]([backcolor=transparent]'MemFree:'[backcolor=transparent]):
11. [backcolor=transparent]                mem_free [backcolor=transparent]=[backcolor=transparent] [backcolor=transparent]int[backcolor=transparent]([backcolor=transparent]line[backcolor=transparent].[backcolor=transparent]split[backcolor=transparent]()[[backcolor=transparent]1[backcolor=transparent]])
12. [backcolor=transparent]            [backcolor=transparent]elif[backcolor=transparent] line[backcolor=transparent].[backcolor=transparent]startswith[backcolor=transparent]([backcolor=transparent]'Buffers:'[backcolor=transparent]):
13. [backcolor=transparent]                mem_buffer [backcolor=transparent]=[backcolor=transparent] [backcolor=transparent]int[backcolor=transparent]([backcolor=transparent]line[backcolor=transparent].[backcolor=transparent]split[backcolor=transparent]()[[backcolor=transparent]1[backcolor=transparent]])
14. [backcolor=transparent]            [backcolor=transparent]elif[backcolor=transparent] line[backcolor=transparent].[backcolor=transparent]startswith[backcolor=transparent]([backcolor=transparent]'Cached:'[backcolor=transparent]):
15. [backcolor=transparent]                mem_cache [backcolor=transparent]=[backcolor=transparent] [backcolor=transparent]int[backcolor=transparent]([backcolor=transparent]line[backcolor=transparent].[backcolor=transparent]split[backcolor=transparent]()[[backcolor=transparent]1[backcolor=transparent]])
16. [backcolor=transparent]            [backcolor=transparent]elif[backcolor=transparent] line[backcolor=transparent].[backcolor=transparent]startswith[backcolor=transparent]([backcolor=transparent]'SwapTotal:'[backcolor=transparent]):
17. [backcolor=transparent]                vmem_total [backcolor=transparent]=[backcolor=transparent] [backcolor=transparent]int[backcolor=transparent]([backcolor=transparent]line[backcolor=transparent].[backcolor=transparent]split[backcolor=transparent]()[[backcolor=transparent]1[backcolor=transparent]])
18. [backcolor=transparent]            [backcolor=transparent]elif[backcolor=transparent] line[backcolor=transparent].[backcolor=transparent]startswith[backcolor=transparent]([backcolor=transparent]'SwapFree:'[backcolor=transparent]):
19. [backcolor=transparent]                vmem_free [backcolor=transparent]=[backcolor=transparent] [backcolor=transparent]int[backcolor=transparent]([backcolor=transparent]line[backcolor=transparent].[backcolor=transparent]split[backcolor=transparent]()[[backcolor=transparent]1[backcolor=transparent]])
20. [backcolor=transparent]            [backcolor=transparent]else[backcolor=transparent]:
21. [backcolor=transparent]                [backcolor=transparent]continue
22. [backcolor=transparent]        f[backcolor=transparent].[backcolor=transparent]close[backcolor=transparent]()
23. [backcolor=transparent]    [backcolor=transparent]except[backcolor=transparent]:
24. [backcolor=transparent]        [backcolor=transparent]return[backcolor=transparent] [backcolor=transparent]None
25. [backcolor=transparent]    physical_percent [backcolor=transparent]=[backcolor=transparent] usage_percent[backcolor=transparent]([backcolor=transparent]mem_total [backcolor=transparent]-[backcolor=transparent] [backcolor=transparent]([backcolor=transparent]mem_free [backcolor=transparent]+[backcolor=transparent] mem_buffer [backcolor=transparent]+[backcolor=transparent] mem_cache[backcolor=transparent]),[backcolor=transparent] mem_total[backcolor=transparent])
26. [backcolor=transparent]    virtual_percent [backcolor=transparent]=[backcolor=transparent] [backcolor=transparent]0
27. [backcolor=transparent]    [backcolor=transparent]if[backcolor=transparent] vmem_total [backcolor=transparent]>[backcolor=transparent] [backcolor=transparent]0[backcolor=transparent]:
28. [backcolor=transparent]        virtual_percent [backcolor=transparent]=[backcolor=transparent] usage_percent[backcolor=transparent](([backcolor=transparent]vmem_total [backcolor=transparent]-[backcolor=transparent] vmem_free[backcolor=transparent]),[backcolor=transparent] vmem_total[backcolor=transparent])
29. [backcolor=transparent]    [backcolor=transparent]return[backcolor=transparent] physical_percent
30. [backcolor=transparent]def[backcolor=transparent] usage_percent[backcolor=transparent]([backcolor=transparent]use[backcolor=transparent],[backcolor=transparent] total[backcolor=transparent]):
31. [backcolor=transparent]    [backcolor=transparent]try[backcolor=transparent]:
32. [backcolor=transparent]        ret [backcolor=transparent]=[backcolor=transparent] [backcolor=transparent]([backcolor=transparent]float[backcolor=transparent]([backcolor=transparent]use[backcolor=transparent])[backcolor=transparent] [backcolor=transparent]/[backcolor=transparent] total[backcolor=transparent])[backcolor=transparent] [backcolor=transparent]*[backcolor=transparent] [backcolor=transparent]100
33. [backcolor=transparent]    [backcolor=transparent]except[backcolor=transparent] [backcolor=transparent]ZeroDivisionError[backcolor=transparent]:
34. [backcolor=transparent]        [backcolor=transparent]raise[backcolor=transparent] [backcolor=transparent]Exception[backcolor=transparent]([backcolor=transparent]"ERROR - zero division error"[backcolor=transparent])
35. [backcolor=transparent]    [backcolor=transparent]return[backcolor=transparent] ret
37. [backcolor=transparent]MEMS_usage[backcolor=transparent]=[backcolor=transparent]get_mem_usage_percent[backcolor=transparent]()
39. [backcolor=transparent]if[backcolor=transparent] __name__ [backcolor=transparent]==[backcolor=transparent] [backcolor=transparent]'__main__'[backcolor=transparent]:
40. [backcolor=transparent] cms_post[backcolor=transparent].[backcolor=transparent]post[backcolor=transparent]([backcolor=transparent]"1058019241820815"[backcolor=transparent],[backcolor=transparent]"MEMS_usage"[backcolor=transparent],[backcolor=transparent]MEMS_usage[backcolor=transparent],[backcolor=transparent]"Percent"[backcolor=transparent],[backcolor=transparent]"ecsinstanceId=i-28zdkoobp"[backcolor=transparent])

• metricName：创建监控项时填写的“监控项名称”。
• unit：创建监控项时填写的“单位”。
• dimensions：创建监控项时填写的“字段信息”，允许多个，使用半角逗号分隔。
• namespace：格式为“ACS/CUSTOM/userId”，将userid替换为您的账号ID。
• userId：即您的账号ID。
• timestamp：数据上传的时间，支持两种表示方式：一种方式取时间的长整型表示方式1395556197448，另一种方式按照 ISO8601 标准表示，并使用 UTC 时间，例如 2014-9-11T10:00:00Z，注意它对应的北京时间是 2014-09-11 18:00:00。

1. [backcolor=transparent]userId[backcolor=transparent]=[backcolor=transparent]123456[backcolor=transparent]&[backcolor=transparent]namespace[backcolor=transparent]=[backcolor=transparent]acs[backcolor=transparent]/[backcolor=transparent]custom[backcolor=transparent]/[backcolor=transparent]123456[backcolor=transparent]&[backcolor=transparent]metrics [backcolor=transparent]=
2. [backcolor=transparent][{[backcolor=transparent]"metricName"[backcolor=transparent]:[backcolor=transparent]"vm.cpu"[backcolor=transparent],[backcolor=transparent]"timestamp"[backcolor=transparent]:[backcolor=transparent]"1395556197448"[backcolor=transparent],[backcolor=transparent]"value"[backcolor=transparent]:[backcolor=transparent]80.0[backcolor=transparent],[backcolor=transparent]"unit"[backcolor=transparent]:[backcolor=transparent]"Percen
3. [backcolor=transparent]t"[backcolor=transparent],[backcolor=transparent]"dimensions"[backcolor=transparent]:{[backcolor=transparent]"instanceId"[backcolor=transparent]:[backcolor=transparent]"vm_001"[backcolor=transparent]}}]

1. [backcolor=transparent]http[backcolor=transparent]:[backcolor=transparent]//open.cms.aliyun.com
2. [backcolor=transparent]/[backcolor=transparent]metrics[backcolor=transparent]/[backcolor=transparent]put[backcolor=transparent]?[backcolor=transparent]userId[backcolor=transparent]=[backcolor=transparent]123456[backcolor=transparent]&[backcolor=transparent]namespace[backcolor=transparent]=[backcolor=transparent]acs[backcolor=transparent]/[backcolor=transparent]custom[backcolor=transparent]/[backcolor=transparent]123456[backcolor=transparent]&[backcolor=transparent]metrics[backcolor=transparent]=[{[backcolor=transparent]"metricName"[backcolor=transparent]:
3. [backcolor=transparent]"vm.cpu"[backcolor=transparent],[backcolor=transparent]"timestamp"[backcolor=transparent]:[backcolor=transparent]"1395556197448"[backcolor=transparent],[backcolor=transparent]"value"[backcolor=transparent]:[backcolor=transparent]80.0[backcolor=transparent],[backcolor=transparent]"unit"[backcolor=transparent]:[backcolor=transparent]"Percent"[backcolor=transparent],[backcolor=transparent]"dimensions"
4. [backcolor=transparent]:{[backcolor=transparent]"instanceId"[backcolor=transparent]:[backcolor=transparent]"vm_001"[backcolor=transparent]}},{[backcolor=transparent]"metricName"[backcolor=transparent]:[backcolor=transparent]"vm.mem"[backcolor=transparent],[backcolor=transparent]"timestamp"[backcolor=transparent]:[backcolor=transparent]"1395556197448"[backcolor=transparent],[backcolor=transparent]"v
5. [backcolor=transparent]alue"[backcolor=transparent]:[backcolor=transparent]1280.0[backcolor=transparent],[backcolor=transparent]"unit"[backcolor=transparent]:[backcolor=transparent]"Megabytes"[backcolor=transparent],[backcolor=transparent]"dimensions"[backcolor=transparent]:{[backcolor=transparent]"instanceId"[backcolor=transparent]:[backcolor=transparent]"vm_002"[backcolor=transparent]}}]

1. [backcolor=transparent]{[backcolor=transparent]"code"[backcolor=transparent]:[backcolor=transparent]"InvalidParameterValue"[backcolor=transparent],[backcolor=transparent]"msg"[backcolor=transparent]:[backcolor=transparent]"the metricName is empty."[backcolor=transparent]}