Telegraf 模板模式
模板模式描述了一个点分隔的字符串应如何映射到 Telegraf 指标 以及从指标映射出来。
模板的格式为
"host.mytag.mytag.measurement.measurement.field*"其中可以设置以下关键字
measurement: 指定 Graphite 桶的这一部分对应于测量名称。此项可以指定多次。field: 指定 Graphite 桶的这一部分对应于字段名称。此项可以指定多次。measurement*: 指定 Graphite 桶的所有剩余元素都对应于测量名称。field*: 指定 Graphite 桶的所有剩余元素都对应于字段名称。
模板中非关键字的任何部分都被视为标签键。此项也可以指定多次。
请注意以下事项
- 模板中必须指定
measurement。 field*不能与measurement*结合使用。
示例
测量和标签模板
基本模板指定一个单一的转换,应用于所有传入的指标
templates = [
"region.region.measurement*"
]这将导致以下 Graphite 到 Telegraf 指标的转换。
us.west.cpu.load 100
=> cpu.load,region=us.west value=100您可以指定多个模板,并通过过滤器来区分它们。
templates = [
"*.*.* region.region.measurement", # All 3-part measurements will match this one.
"*.*.*.* region.region.host.measurement", # All 4-part measurements will match this one.
]字段模板
field 关键字告诉 Telegraf 将指标命名为该字段名。
separator = "_"
templates = [
"measurement.measurement.field.field.region"
]这将导致以下 Graphite 到 Telegraf 指标的转换。
cpu.usage.idle.percent.eu-east 100
=> cpu_usage,region=eu-east idle_percent=100通过指定 field*,字段键也可以从 Graphite 桶的所有剩余元素中派生出来。
separator = "_"
templates = [
"measurement.measurement.region.field*"
]这将导致以下 Graphite 到 Telegraf 指标的转换。
cpu.usage.eu-east.idle.percentage 100
=> cpu_usage,region=eu-east idle_percentage=100过滤器模板
使用 glob 匹配来过滤模板,以便根据桶的名称使用。
templates = [
"cpu.* measurement.measurement.region",
"mem.* measurement.measurement.host"
]这将导致以下转换
cpu.load.eu-east 100
=> cpu_load,region=eu-east value=100
mem.cached.localhost 256
=> mem_cached,host=localhost value=256添加标签
要向指标添加额外的标签,请在模板模式之后使用 InfluxDB 行协议标签格式(逗号分隔的键值对)包含它们。
templates = [
"measurement.measurement.field.region datacenter=1a"
]这将导致以下 Graphite 到 Telegraf 指标的转换。
cpu.usage.idle.eu-east 100
=> cpu_usage,region=eu-east,datacenter=1a idle=100此页面是否有帮助?
感谢您的反馈!
支持和反馈
感谢您成为我们社区的一员!我们欢迎并鼓励您对 Telegraf 和本文档提出反馈和 bug 报告。要获取支持,请使用以下资源
具有年度合同或支持合同的客户可以 联系 InfluxData 支持。