Stackdriver Google Cloud Monitoring 输入插件
此插件使用 Cloud Monitoring API v3 从 Google Cloud Monitoring(以前称为 Stackdriver)收集指标。
此插件访问 收费 的 API,可能会产生费用。
引入于: Telegraf v1.10.0 标签: cloud 操作系统支持: all
全局配置选项
插件支持其他全局和插件配置设置,用于修改指标、标签和字段,创建别名以及配置插件顺序等任务。更多详情请参阅 CONFIGURATION.md。
配置
# Gather timeseries from Google Cloud Platform v3 monitoring API
[[inputs.stackdriver]]
## GCP Project
project = "erudite-bloom-151019"
## Include timeseries that start with the given metric type.
metric_type_prefix_include = [
"compute.googleapis.com/",
]
## Exclude timeseries that start with the given metric type.
# metric_type_prefix_exclude = []
## Most metrics are updated no more than once per minute; it is recommended
## to override the agent level interval with a value of 1m or greater.
interval = "1m"
## Maximum number of API calls to make per second. The quota for accounts
## varies, it can be viewed on the API dashboard:
## https://cloud.google.com/monitoring/quotas#quotas_and_limits
# rate_limit = 14
## The delay and window options control the number of points selected on
## each gather. When set, metrics are gathered between:
## start: now() - delay - window
## end: now() - delay
#
## Collection delay; if set too low metrics may not yet be available.
# delay = "5m"
#
## If unset, the window will start at 1m and be updated dynamically to span
## the time between calls (approximately the length of the plugin interval).
# window = "1m"
## TTL for cached list of metric types. This is the maximum amount of time
## it may take to discover new metrics.
# cache_ttl = "1h"
## If true, raw bucket counts are collected for distribution value types.
## For a more lightweight collection, you may wish to disable and use
## distribution_aggregation_aligners instead.
# gather_raw_distribution_buckets = true
## Aggregate functions to be used for metrics whose value type is
## distribution. These aggregate values are recorded in in addition to raw
## bucket counts; if they are enabled.
##
## For a list of aligner strings see:
## https://cloud.google.com/monitoring/api/ref_v3/rpc/google.monitoring.v3#aligner
# distribution_aggregation_aligners = [
# "ALIGN_PERCENTILE_99",
# "ALIGN_PERCENTILE_95",
# "ALIGN_PERCENTILE_50",
# ]
## Filters can be added to reduce the number of time series matched. All
## functions are supported: starts_with, ends_with, has_substring, and
## one_of. Only the '=' operator is supported.
##
## The logical operators when combining filters are defined statically using
## the following values:
## filter ::= <resource_labels> {AND <metric_labels> AND <user_labels> AND <system_labels>}
## resource_labels ::= <resource_labels> {OR <resource_label>}
## metric_labels ::= <metric_labels> {OR <metric_label>}
## user_labels ::= <user_labels> {OR <user_label>}
## system_labels ::= <system_labels> {OR <system_label>}
##
## For more details, see https://cloud.google.com/monitoring/api/v3/filters
#
## Resource labels refine the time series selection with the following expression:
## resource.labels.<key> = <value>
# [[inputs.stackdriver.filter.resource_labels]]
# key = "instance_name"
# value = 'starts_with("localhost")'
#
## Metric labels refine the time series selection with the following expression:
## metric.labels.<key> = <value>
# [[inputs.stackdriver.filter.metric_labels]]
# key = "device_name"
# value = 'one_of("sda", "sdb")'
#
## User labels refine the time series selection with the following expression:
## metadata.user_labels."<key>" = <value>
# [[inputs.stackdriver.filter.user_labels]]
# key = "environment"
# value = 'one_of("prod", "staging")'
#
## System labels refine the time series selection with the following expression:
## metadata.system_labels."<key>" = <value>
# [[inputs.stackdriver.filter.system_labels]]
# key = "machine_type"
# value = 'starts_with("e2-")'身份验证
建议使用服务账号通过 Stackdriver Monitoring API 进行身份验证。身份验证入门。
故障排除
当 Telegraf 使用 --debug 运行时,将记录有关执行的查询的详细信息。
Metrics
指标的创建取决于值类型是标量值、原始分布桶还是对齐桶值,并使用其中一种模式。
在所有情况下,Stackdriver 指标类型都会在最后一个组件上拆分为测量和字段
compute.googleapis.com/instance/disk/read_bytes_count
└────────── measurement ─────────┘ └── field ───┘标量值
- measurement
- 标签 (tags)
- resource_labels
- metric_labels
- 字段 (fields)
- 字段
- 标签 (tags)
分布
分布由一组字段表示,以及带有桶边界标记的桶值。桶是累积的:每个桶代表小于 lt 标签的项目总数。
measurement
- 标签 (tags)
- resource_labels
- metric_labels
- 字段 (fields)
- field_count
- field_mean
- field_sum_of_squared_deviation
- field_range_min
- field_range_max
- 标签 (tags)
measurement
- 标签 (tags)
- resource_labels
- metric_labels
- lt (小于)
- 字段 (fields)
- field_bucket
- 标签 (tags)
对齐聚合
- measurement
- 标签 (tags)
- resource_labels
- metric_labels
- 字段 (fields)
- field_alignment_function
- 标签 (tags)
示例输出
输出取决于定义的过滤器和指标类型。
此页面是否有帮助?
感谢您的反馈!
支持和反馈
感谢您成为我们社区的一员!我们欢迎并鼓励您对 Telegraf 和本文档提出反馈和 bug 报告。要获取支持,请使用以下资源
具有年度合同或支持合同的客户可以 联系 InfluxData 支持。