文档文档

使用 Telegraf 写入 CSV 数据

使用 Telegraf 的 file 输入插件读取和解析 CSV 数据到 行协议,然后将其写入 InfluxDB 3 Core。 Telegraf 是一个基于插件的代理,它从不同来源收集指标,并将它们写入指定的目标。

配置 Telegraf 读取 CSV 文件

  1. 在 Telegraf 配置文件中添加并启用 inputs.file 插件
  2. 使用 files 选项指定要读取的 CSV 文件列表。CSV 文件必须可被 Telegraf 代理访问。
  3. data_format 选项设置为 csv
  4. 定义所有其他针对您要写入 InfluxDB 3 Core 的 CSV 数据的 csv_ 配置选项。有关每个 CSV 格式配置选项的详细信息,请参阅 CSV 输入数据格式
[[inputs.file]]
  files = ["/path/to/example.csv"]
  data_format = "csv"
  csv_header_row_count = 0
  csv_column_names = []
  csv_column_types = []
  csv_skip_rows = 0
  csv_metadata_rows = 0
  csv_metadata_separators = [":", "="]
  csv_metadata_trim_set = ""
  csv_skip_columns = 0
  csv_delimiter = ","
  csv_comment = ""
  csv_trim_space = false
  csv_tag_columns = []
  csv_measurement_column = ""
  csv_timestamp_column = ""
  csv_timestamp_format = ""
  csv_timezone = ""
  csv_skip_values = []
  csv_skip_errors = false
  csv_reset_mode = "none"

配置 Telegraf 写入 InfluxDB

要将数据发送到 InfluxDB 3 Core,请在您的 telegraf.conf 中启用并配置 influxdb_v2 输出插件

[[inputs.file]]
  files = ["/path/to/example.csv"]
  data_format = "csv"
  csv_header_row_count = 0
  csv_column_names = []
  csv_column_types = []
  csv_skip_rows = 0
  csv_metadata_rows = 0
  csv_metadata_separators = [":", "="]
  csv_metadata_trim_set = ""
  csv_skip_columns = 0
  csv_delimiter = ","
  csv_comment = ""
  csv_trim_space = false
  csv_tag_columns = []
  csv_measurement_column = ""
  csv_timestamp_column = ""
  csv_timestamp_format = ""
  csv_timezone = ""
  csv_skip_values = []
  csv_skip_errors = false
  csv_reset_mode = "none"

[[outputs.influxdb_v2]]
  urls = ["https://:8181"]
  token = "
AUTH_TOKEN
"
organization = "" bucket = "
DATABASE_NAME
"
content_encoding = "gzip"

替换以下内容:

  • DATABASE_NAME:要写入数据到的数据库名称

  • AUTH_TOKEN:您的 InfluxDB 3 Core 令牌请将其存储在密钥存储或环境变量中,以避免暴露原始令牌字符串。

    将授权令牌存储为环境变量

    避免在 Telegraf 配置文件中存储明文令牌。将令牌存储为环境变量,然后使用字符串插值在配置文件中引用该环境变量。例如:

    [[outputs.influxdb_v2]]
      urls = ["https://:8181"]
      token = "${INFLUX_TOKEN}"
      # ...

重新启动 Telegraf 代理 以应用配置更改并将 CSV 数据写入 InfluxDB 3 Core。

其他 Telegraf 配置选项

前面的示例描述了写入 InfluxDB 3 Core 所必需的 Telegraf 配置。influxdb_v2 输出插件提供了其他几个配置选项。有关更多信息,请参阅 GitHub 上的 influxdb_v2 插件选项


此页面是否有帮助?

感谢您的反馈!


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