search
数据采集 采集源配置 阿里云云监控指标采集

阿里云云监控指标采集

简介

使用阿里云 Cloud Monitor Service 提供的API采集阿里云产品监控项数据

前置条件

  • 已安装 DataKit(DataKit 安装文档
  • 需要有"只读访问云监控(CloudMonitor)的权限"的 Access Key ID 和 Access Key Secret(为了保证你的数据安全请不要使用超过只读权限的 Access Key ID 和 Access Key Secret)

配置

进入 DataKit 安装目录下的 conf.d/aliyun 目录,复制 aliyuncms.conf.sample 并命名为 aliyuncms.conf。示例如下: 配置好后,重启 DataKit 即可生效.

配置:

# ##(required)
[[inputs.aliyuncms]]

 # ##(required) 阿里云API访问 access key及区域, 至少拥有 "只读访问云监控(CloudMonitor)"的权限.
 access_key_id = ''
 access_key_secret = ''
 region_id = 'cn-hangzhou'

 # ##(optional) 阿里云临时安全令牌(Security Token Service,STS)
 #security_token = ''

 # ##(optional) 全局的采集间隔,每个指标可以单独配置,默认5分钟.
 #interval = '5m'

 # ##(optional) 阿里云监控项数据可能在当前采集时间点之后才可用,配置此项用于获取该延迟时间段的数据,如果设置为0可能导致数据不完整.  
 # ## 不同的指标可能有不同的延迟时间, 默认为5分钟, 你可以根据使用中的实际采集情况调整该值.
 #delay = '5m'

 # ##(optional) 自定义tag
 #[inputs.aliyuncms.tags]
 #key1 = 'val1'
 #key2 = 'val2'

 # ##(required) [[aliyuncms.project]] 块可以有多个,每个代表一个云产品.
 [[inputs.aliyuncms.project]]
  #    ##(required) 云产品命名空间,可参考: https://help.aliyun.com/document_detail/28619.html?spm=a2c4g.11186623.6.690.9dbe5679uFUe3w
  namespace = 'acs_ecs_dashboard'

  # ##(optional) 配置采集指标,指标名以逗号分隔,如果为空则拉取当前namespace下的所有指标
  #metric = 'CPUUtilization,DiskWriteBPS'

  # ##(optional) 定义每个指标的采集行为
  #[[inputs.aliyuncms.project.property]]

    # ##(optional) 指定设置哪些指标的采集行为, 为空则应用到所有指标名
    #name = 'CPUUtilization,DiskWriteBPS'
    
    # ##(optional) 指标采样周期, 单位为秒.
    # ## 指标项的Period可参考: See: https://help.aliyun.com/document_detail/28619.html?spm=a2c4g.11186623.2.11.6ac47694AjhHt4
    # ## 如果没有配置或配置了不支持的period,默认会使用该监控项支持的最低采样周期(一般为60s).
    #period = 60

    # ##(optional) 可单独配置指标的采集间隔, 没有则使用全局配置
    #interval = '5m'

    # ##(optional) 配置采集维度, 是一个key-value列表的json字符串.
    # ##维度map,用于查询指定资源的监控数据. 格式为key-value键值对形式的集合,常用的key-value集合为instanceId:XXXXXX.key和value的长度为1~64个字节,超过64个字节时截取前64字节.
    # ##如果某个维度不在指标的支持范围内, 则被忽略.
    #dimensions = '''
    #  [
    #    {"instanceId":"i-bp15wj5w33t8vf******"}
    #    ]
    #    '''

    # ##(optional) 可对每个指标自定义tag,比如用于标识用户信息。
    #[inputs.aliyuncms.project.property.tags]
    #key1 = 'val1'
    #key2 = 'val2'

阿里云云产品主要监控项可以参考官方文档

采集指标

指标集名称使用"aliyuncms + project名",如 aliyuncms_acs_ecs_dashboard。

fields:

field名采用"指标+指标值统计方法"的命名规则,比如 CPUUtilization 指标有 Maximum, Minimum, Average 这些统计值,则对应的会有如下的指标: CPUUtilization_Average=xx,CPUUtilization_Minimum=xx,CPUUtilization_Maximum=xx

tags:

除了统计值之外值都作为tag.

采集结果示例:

aliyuncms_acs_ecs_dashboard,instanceId=i-bp14v2sdd3vc******,regionId=cn-hangzhou,userId=1932186612***** CPUUtilization_Average=10.14,CPUUtilization_Minimum=10.14,CPUUtilization_Maximum=10.14 1588215480000000000
aliyuncms_acs_rds_dashboard,instanceId=rr-bp1d9699*****,regionId=cn-hangzhou,userId=193218661****** CpuUsage_Average=0.5,CpuUsage_Minimum=0.5,CpuUsage_Maximum=0.5 1588215480000000000