telegraf详解与部署实战

一、Telegraf核心概念解析

1、定位与优势

• 轻量级数据收集代理，由InfluxData用Go语言开发，支持跨平台部署。

• 插件化架构：200+官方输入/输出插件，覆盖系统指标（CPU/内存/磁盘）、数据库（MySQL/Redis）、API服务（Nginx/Apache）等17。

• 低资源消耗：单进程运行，默认占用内存<100MB，适合嵌入式设备和云服务器1。

• 无缝集成：原生支持InfluxDB，可输出至Prometheus、Kafka、Graphite等平台26。

2、数据流模型

• 输入插件(Inputs)：采集数据（如cpu、mem）。

• 处理插件(Process)：实时过滤/转换数据（如添加标签）。

• 聚合插件(Aggregate)：窗口期统计（如5分钟平均负载）。

• 输出插件(Outputs)：写入目标存储（如influxdb）6。

二、安装部署实战（Linux为例）

步骤1：系统准备

• 确保拥有sudo权限及网络连通性。

• 开放防火墙端口（如InfluxDB默认8086）1。

步骤2：安装方式

1）yum方式安装

$ sudo tee /etc/yum.repos.d/influxdata.repo <<EOF
[influxdata]
name = InfluxData Repository - Stable
baseurl = https://repos.influxdata.com/stable/\$basearch/main
enabled = 1
gpgcheck = 1
gpgkey = https://repos.influxdata.com/influxdb.key
EOF
$ sudo yum clean all && sudo yum makecache fast
$ sudo yum install -y telegraf

2）二进制方式安装

下载地址：https://github.com/influxdata/telegraf/releases

# 创建安装目录
$ mkdir -p /opt/telegraf && cd /opt/telegraf

# 下载二进制包（替换版本号为最新稳定版）
$ wget https://dl.influxdata.com/telegraf/releases/telegraf-1.28.5_linux_amd64.tar.gz

# 解压文件
$ tar zxvf telegraf-1.28.5_linux_amd64.tar.gz

解压后目录结构：

• usr/bin/telegraf：二进制执行文件
• etc/telegraf/telegraf.conf：默认配置文件
• usr/share/telegraf/：插件和脚本目录

# 查看版本
./usr/bin/telegraf --version

# 输出示例（表示成功）：
# Telegraf 1.28.5 (git: HEAD 6e5b3d2f)

配置Telegraf

$ ./usr/bin/telegraf config > etc/telegraf/telegraf.conf
$ vim etc/telegraf/telegraf.conf
# 输入插件：启用系统指标（默认已配置）
[[inputs.cpu]]
[[inputs.mem]]
[[inputs.disk]]

# 输出插件：暴露为 Prometheus 指标
[[outputs.prometheus_client]]
  listen = ":9273"  # 端口可自定义

启动 Telegraf

$ ./usr/bin/telegraf --config etc/telegraf/telegraf.conf

配置系统服务

$ sudo tee /etc/systemd/system/telegraf.service <<EOF
[Unit]
Description=Telegraf Data Collector
After=network.target

[Service]
User=root
ExecStart=/opt/telegraf/usr/bin/telegraf --config /opt/telegraf/etc/telegraf/telegraf.conf
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF
$ sudo systemctl daemon-reload
$ sudo systemctl start telegraf
$ sudo systemctl enable telegraf
$ sudo systemctl status telegraf
$ curl http://localhost:9273/metrics | grep telegraf

步骤3：服务管理

sudo systemctl start telegraf          # 启动
sudo systemctl enable telegraf         # 开机自启
sudo systemctl status telegraf         # 检查状态

三、基础配置与验证

1、配置文件路径
/etc/telegraf/telegraf.conf，关键配置项：

[agent]
  interval = "10s"                 # 采集间隔

[[inputs.cpu]]                     # 启用CPU监控
[[inputs.mem]]                     # 启用内存监控

[[outputs.influxdb]]
  urls = ["http://localhost:8086"] # InfluxDB地址
  database = "telegraf"            # 目标数据库:cite[5]:cite[8]

2、配置生成技巧

• 生成最小配置（仅CPU/内存）：

  telegraf --input-filter cpu:mem --output-filter influxdb config > minimal.conf

• 测试配置文件语法：

  telegraf --config minimal.conf --test

四、生产环境高级配置

1、插件扩展示例（监控Nginx）

• Step1：启用Nginx状态模块
  在nginx.conf中添加：

  location /nginx-status {
    stub_status on;
    allow 127.0.0.1;
    deny all;
  }

• Step2：创建Telegraf子配置

  telegraf --input-filter nginx config > /etc/telegraf/telegraf.d/nginx.conf

  编辑nginx.conf：

  [[inputs.nginx]]
    urls = ["http://localhost/nginx-status"]

• Step3：重启服务生效7：

  sudo systemctl restart telegraf

2、性能与安全优化

• 降低资源占用：调整interval至60s，禁用非必要插件（如inputs.kernel）1。

• TLS加密传输：在outputs.influxdb中配置：

  tls_ca = "/path/to/ca.pem"
  tls_cert = "/path/to/cert.pem"

• 数据过滤：使用tagexclude移除敏感标签1。

五、TIG监控平台集成（Telegraf+InfluxDB+Grafana）

1、InfluxDB部署

# CentOS安装
wget https://dl.influxdata.com/influxdb/releases/influxdb-1.8.6.x86_64.rpm
sudo yum localinstall influxdb-1.8.6.x86_64.rpm
systemctl start influxdb

2、Grafana数据源配置

• 访问http://<服务器IP>:3000，登录（默认admin/admin）。

• 添加数据源 → 选择InfluxDB → 填写URL与数据库名（telegraf）68。

3、仪表盘模板导入

• 访问Grafana仪表盘库，搜索Telegraf。

• 下载ID为928的模板，在Grafana中导入即可实时显示指标46。

六、常见故障排查

七、总结与进阶建议

Telegraf作为现代监控栈的核心采集器，通过标准化插件大幅降低数据收集复杂度。生产部署时需注意：

• 插件管理：通过telegraf.d目录分服务配置插件，避免主配置臃肿7。

• 高可用方案：部署多Telegraf实例 + Kafka输出，防止数据丢失。

• 自定义开发：参考官方插件模板开发业务专属采集器1。

通过TIG技术栈实现的全链路监控，可覆盖从基础设施到应用层的观测需求，为性能优化提供数据支撑。