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."}