文档文档

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

此页面是否有帮助?

感谢您的反馈!


InfluxDB 3.8 新特性

InfluxDB 3.8 和 InfluxDB 3 Explorer 1.6 的主要增强功能。

查看博客文章

InfluxDB 3.8 现已适用于 Core 和 Enterprise 版本,同时发布了 InfluxDB 3 Explorer UI 的 1.6 版本。本次发布着重于操作成熟度,以及如何更轻松地部署、管理和可靠地运行 InfluxDB。

更多信息,请查看

InfluxDB Docker 的 latest 标签将指向 InfluxDB 3 Core

在 **2026 年 2 月 3 日**,InfluxDB Docker 镜像的 latest 标签将指向 InfluxDB 3 Core。为避免意外升级,请在您的 Docker 部署中使用特定的版本标签。

如果使用 Docker 来安装和运行 InfluxDB,latest 标签将指向 InfluxDB 3 Core。为避免意外升级,请在您的 Docker 部署中使用特定的版本标签。例如,如果使用 Docker 运行 InfluxDB v2,请将 latest 版本标签替换为 Docker pull 命令中的特定版本标签 — 例如

docker pull influxdb:2