文档文档

Clarify 输出插件

此插件将指标写入 Clarify。要使用此插件,您需要获取一套 凭据

引入于: Telegraf v1.27.0 标签: cloud, datastore 操作系统支持: all

全局配置选项

插件支持其他全局和插件配置设置,用于修改指标、标签和字段,创建别名以及配置插件顺序等任务。更多详情请参阅 CONFIGURATION.md

配置

## Configuration to publish Telegraf metrics to Clarify
[[outputs.clarify]]
  ## Credentials File (Oauth 2.0 from Clarify integration)
  credentials_file = "/path/to/clarify/credentials.json"

  ## Clarify username password (Basic Auth from Clarify integration)
  username = "i-am-bob"
  password = "secret-password"

  ## Timeout for Clarify operations
  # timeout = "20s"

  ## Optional tags to be included when generating the unique ID for a signal in Clarify
  # id_tags = []
  # clarify_id_tag = 'clarify_input_id'

您可以使用凭证文件或用户名/密码。如果配置中同时存在这两个并且都有效,则会使用凭证文件。

Telegraf 指标如何映射到 Clarify 信号

Clarify 信号名称是通过将 Telegraf 指标名称和字段键用 . 字符连接而成的。Telegraf 标签会添加到信号标签中。

如果您希望指定一个特定的标签用作输入 ID,请将配置选项 clarify_id_tag 设置为包含要使用的 ID 的标签。如果此标签存在且指标中只有一个字段,则此标签将用作 Clarify 中的 inputID。如果指标中有多个字段可用,则将忽略此标签,并使用正常的 ID 生成方式。

如果需要一个或多个标签中的信息来唯一标识指标字段,可以在配置中添加 id_tags 数组,其中包含所需的标签名称。例如:

id_tags = ['sensor']

Clarify 只支持可以转换为浮点数的数值。字符串和无效数字将被忽略。

示例

以下输入将以所示值存储在 Clarify 中

temperature,host=demo.clarifylocal,sensor=TC0P value=49 1682670910000000000
"signal" {
  "id": "temperature.value.TC0P"
  "name": "temperature.value"
  "labels": {
    "host": ["demo.clarifylocal"],
    "sensor": ["TC0P"]
  }
}
"values" {
  "times": ["2023-04-28T08:43:16+00:00"],
  "series": {
    "temperature.value.TC0P": [49]
  }
}

此页面是否有帮助?

感谢您的反馈!


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