自定义监控快速入门.pdf

云监控——自定义监控快速入门
1.创建自定义监控项
在【自定义监控】标签页，点击【创建监控项】按钮，进入自定义监控项创建页面，
如下图：

【监控项名称】：用户上报的监控数据指标名称，例如pageview,cpuUtilization,
memoryUtilization等。
【单位】：监控数据的单位，在上报数据时不会做校验，只是为了便于展示数据，或
者便于数据信息的沟通，希望用户根据自己的实际情况填写。
【上报频率】：监控数据上报的周期，只允许1分钟，5分钟，15分钟三种上报频
率
【字段信息】：一条监控数据需要附属到某一实例才有意义。如pageview，具体到
某一应用才有意义。因此，字段信息可以填写app_name，在用户上报监控数据时，
需要在上报的数据中填写如app_name=aliyun.com，这样即表示这条数据是应用
aliyun.com上报的。字段信息最多允许五项。
【统计周期】：用户可以告知云监控，上报的监控数据需要以何种频率进行聚合。
【统计方法】：与统计周期结合使用，若您选择了5分钟的统计周期，则云监控会为
您计算这5分钟内上报数据的平均值、求和值、最大值、最小值、采样计数值（上报
了多少条数据）
2.创建报警规则（可选）
点击确认后，用户进入了报警规则设置的页面，如下：

【字段信息】中的app_name即为上一步骤中用户填写的字段信息，用户若填写了
aliyun.com，则表示对上报的监控数据中字段信息app_name=”aliyun.com”设置
了报警规则。
用户也可以此时取消创建。若有需要，可以在左边侧栏【自定义报警管理】中，选择
您要创建的监控项，进行告警规则的设置。

至此，用户在云监控控制台的操作已经完成。
3.编写监控数据上报脚本
我们为用户封装了SDK(请点击此处下载)，当前支持python（2.6+）与bash。用户
可以下载相应的脚本至自定义脚本路径下，详见第4部分。
1）python，cms_post.py
在用户的脚本中，importcms_post，调用cms_post的post方法。
注意：请在您的脚本开始处添加对应的解释器，一般默认#!/usr/bin/python
如图：

在test.py中，importcms_post

post方法中传入4个参数，分别为aliuid,监控项名称，监控项值，字段信息。
最后按照第4部分的说明，添加定时任务即可。
再次强调这些参数的意义，参见云监控控制台自定义监控自定义监控项管理

a.命名空间中的数字串，即是用户的aliuid
b.监控项名称，即是用户创建监控项时填写的名称
c.监控项值，是用户上报到云监控的业务数据
d.字段信息，结合监控项，表示具体业务字段的实际意义。
例如字段信息是machineIp，监控项名称cpuutilization，若当前cpu利
用率80%，那么在上面的示例中传入的参数分别是1301033596187394,
cpuutilization,0.8,machineIp=192.168.1.1
2）bash,cms_post.sh
在您的bash脚本中，请使用cms_post.sh的全路径，否则定时任务调度工具可
能找不到cms_post.sh。请按照下面的示例的使用方式引入cms_post.sh。
test.sh文件的内容：

参数说明参见python方式
3）用户可以一次性上报多条监控数据，详情请参考云监控用户手册
4.脚本定时调度
用户也可以使用自己的定时任务调度工具，如Linux环境下的Crontab，Windows
quartz.net等

若用户使用云监控提供的调度工具，请用户将编写好的脚本放
aegis_quartz/libexec/user下，脚本存放路径为：

操作系统类型自定义脚本存放路径
Windows32bitC:\”programfiles”\alibaba\aegis\aegis_quartz\libexec\user
Windows64bitC:\”programfiles(x86)”\alibaba\aegis\aegis_quartz\libexec\user
linux/usr/local/aegis/aegis_quartz/aegis_quartz/libexec/user
云监控为用户提供了方便的定时任务调度程序，若用户安装了云盾，可以在云盾的目
录下找到aegis_quartz程序。

操作系统类型Quartz路径
Windows32bitC:\”programfiles”\alibaba\aegis\aegis_quartz\aegis_quartz.exe
Windows64bitC:\”programfiles(x86)”\