aliyun

README

1. 需要提供

• AccessKey
• AcessSecret
• Endpoint
• RegionID

其中，Endpoint 与 RegionID 见 接入地址

请求限制:

• Http Request Header+Query ≤ 128KB
• Http Request Body ≤ 512KB
• Http Response ≤ 2048KB

1. 凭证相关

获取凭证 https://usercenter.console.aliyun.com/#/manage/ak RAM 用户授权。RAM 用户调用云监控 API 前，需要所属的阿里云账号将权限策略授予对应的 RAM 用户，参见 RAM 用户权限。 可以在 授权页面 新增授权，选择对应的用户，授予云监控只读权限 AliyunCloudMonitorReadOnlyAccess, 并为授予权限的用户创建accessKey 即可。

1. 指标查询

   阿里云监控指标

2. 配置

# # categraf采集周期，阿里云指标的粒度一般是60秒，建议设置不要少于60秒
# interval = 60
[[instances]]
## 阿里云资源所处的region
## endpoint region 参考 https://help.aliyun.com/document_detail/28616.html#section-72p-xhs-6qt
region="cn-beijing"
endpoint="metrics.cn-hangzhou.aliyuncs.com"
## 填入你的acces_key_id
access_key_id=""
## 填入你的access_key_secret
access_key_secret=""

## 可能无法获取当前最新指标，这个指标是指监控指标的截止时间距离现在多久
delay="50m"
## 阿里云指标的最小粒度，60s 是推荐值，再小了部分指标不支持
period="60s"
## 指标所属的namespace ,为空，则表示所有空间指标都要采集
## namespace 参考 https://help.aliyun.com/document_detail/163515.htm?spm=a2c4g.11186623.0.0.44d65c58mhgNw3
namespaces=["acs_ecs_dashboard"]
## 过滤某个namespace下的一个或多个指标
## metric name 参考 https://help.aliyun.com/document_detail/163515.htm?spm=a2c4g.11186623.0.0.401d15c73Z0dZh
## 参考页面中的Metric Id 填入下面的metricName ,页面中包含中文的Metric Name对应接口中的Description
[[instances.metric_filters]]
namespace=""
metric_names=["cpu_cores","vm.TcpCount", "cpu_idle"]

# 阿里云查询指标接口的QPS是50， 这里默认设置为一半
ratelimit=25
# 查询指定namesapce指标后, namespace/metric_name等meta信息会缓存起来，catch_ttl 是指标的缓存时间
catch_ttl="1h"
# 每次请求阿里云endpoint的超时时间
timeout="5s"

1. Dashboard

• dashboard_for_redis_kvstore_standard：适用于 Redis/Tair 内存型（标准版）
• dashboard_for_polardb_mysql：适用于 云数据库POLARDB-MySQL(新版)

Documentation

Index

• type Aliyun
  • func (a *Aliyun) Clone() inputs.Input
  • func (s *Aliyun) GetInstances() []inputs.Instance
  • func (a *Aliyun) Name() string
• type Credential
• type Instance
  • func (ins *Instance) Gather(slist *types.SampleList)
  • func (ins *Instance) Init() error
• type MetricFilter

Types

type Aliyun

type Aliyun struct {
	config.PluginConfig

	Instances []*Instance `toml:"instances"`
}

func (*Aliyun) Clone

func (a *Aliyun) Clone() inputs.Input

func (*Aliyun) GetInstances

func (s *Aliyun) GetInstances() []inputs.Instance

func (*Aliyun) Name

func (a *Aliyun) Name() string

type Credential

type Credential struct {
	AccessKeyID     *string `toml:"access_key_id"`
	AccessKeySecret *string `toml:"access_key_secret"`
	Region          *string `toml:"region"`
	Endpoint        *string `toml:"endpoint"`
}

type Instance

type Instance struct {
	config.InstanceConfig

	// credentials.Config
	Credential

	Delay  config.Duration `toml:"delay"`
	Period config.Duration `toml:"period"`

	Namespaces []string       `json:"namespaces"`
	Filters    []MetricFilter `toml:"metric_filters"`

	// 最大请求次数 限流用
	RateLimit int `toml:"ratelimit"`

	CacheTTL       config.Duration `toml:"cache_ttl"`
	BatchSize      int             `toml:"batch_size"`
	RecentlyActive string          `toml:"recently_active"`

	// 请求超时设置
	Timeout config.Duration `toml:"timeout"`

	EcsAgentHostTag string `toml:"ecs_host_tag"`
	// contains filtered or unexported fields
}

func (*Instance) Gather

func (ins *Instance) Gather(slist *types.SampleList)

func (*Instance) Init

func (ins *Instance) Init() error

type MetricFilter

type MetricFilter struct {
	MetricNames  []string                  `toml:"metric_names"`
	Dimensions   string                    `toml:"dimensions"`
	Namespace    string                    `toml:"namespace"`
	MetricRegexp map[string]*regexp.Regexp `toml:"-"`
}