835      阿里云

监控数据上报__自定义监控_用户指南_云监控-阿里云

您可以使用API或SDK上报监控数据。

注意事项

• SDK支持python（2.6 +）与bash

SDK上报数据

参数说明

• 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时发生错误。

脚本示例（Python+linux环境）

#!/usr/bin/python
import cms_post
def get_mem_usage_percent():
    try:
        f = open('/proc/meminfo', 'r')
        for line in f:
            if line.startswith('MemTotal:'):
                mem_total = int(line.split()[1])
            elif line.startswith('MemFree:'):
                mem_free = int(line.split()[1])
            elif line.startswith('Buffers:'):
                mem_buffer = int(line.split()[1])
            elif line.startswith('Cached:'):
                mem_cache = int(line.split()[1])
            elif line.startswith('SwapTotal:'):
                vmem_total = int(line.split()[1])
            elif line.startswith('SwapFree:'):
                vmem_free = int(line.split()[1])
            else:
                continue
        f.close()
    except:
        return None
    physical_percent = usage_percent(mem_total - (mem_free + mem_buffer + mem_cache), mem_total)
    virtual_percent = 0
    if vmem_total > 0:
        virtual_percent = usage_percent((vmem_total - vmem_free), vmem_total)
    return physical_percent
def usage_percent(use, total):
    try:
        ret = (float(use) / total) * 100
    except ZeroDivisionError:
        raise Exception("ERROR - zero division error")
    return ret
MEMS_usage=get_mem_usage_percent()
if __name__ == '__main__':
 cms_post.post("1058019241820815","MEMS_usage",MEMS_usage,"Percent","ecsinstanceId=i-28zdkoobp")

API上报数据

用户可以使用云监控接口 https://open.cms.aliyun.com/metrics/put 上报监控数据。

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

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

{"code":"InvalidParameterValue","msg":"the metricName is empty."}