5分钟上手Telegraf从安装到数据采集的零门槛指南【免费下载链接】telegrafAgent for collecting, processing, aggregating, and writing metrics, logs, and other arbitrary data.项目地址: https://gitcode.com/GitHub_Trending/te/telegraf你是否还在为服务器监控数据采集烦恼面对五花八门的监控工具是否感到无从下手本文将带你5分钟快速掌握Telegraf的安装与配置轻松实现服务器指标的采集与上报。读完本文你将能够在不同操作系统上正确安装Telegraf理解并编写基础的Telegraf配置文件配置常用输入输出插件验证数据采集是否成功关于TelegrafTelegraf是一个插件驱动的服务器代理用于收集和报告指标。它编译为单个静态二进制文件易于安装和部署。Telegraf拥有丰富的插件生态系统涵盖系统监控、网络、数据库等多个领域能够满足各种监控需求。官方文档docs/README.md 项目主页README.md安装TelegrafTelegraf支持多种安装方式包括二进制包、Docker镜像、RPM/DEB包等。以下是几种常见系统的安装方法Linux系统对于Debian/Ubuntu系统可以使用以下命令添加InfluxData仓库并安装Telegraf# 添加仓库GPG密钥 wget -q https://repos.influxdata.com/influxdata-archive.key gpg --show-keys --with-fingerprint --with-colons ./influxdata-archive.key 21 | grep -q ^fpr:\24C975CBA61A024EE1B631787C3D57159FC2F927:$ cat influxdata-archive.key | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/influxdata-archive.gpg /dev/null # 添加仓库源 echo deb [signed-by/etc/apt/trusted.gpg.d/influxdata-archive.gpg] https://repos.influxdata.com/debian stable main | sudo tee /etc/apt/sources.list.d/influxdata.list # 安装Telegraf sudo apt-get update sudo apt-get install telegraf对于RHEL/CentOS系统可以使用以下命令# 创建仓库文件 cat EOF | sudo tee /etc/yum.repos.d/influxdata.repo [influxdata] name InfluxData Repository - Stable baseurl https://repos.influxdata.com/stable/\$basearch/main enabled 1 gpgcheck 1 gpgkey https://repos.influxdata.com/influxdata-archive.key EOF # 安装Telegraf sudo yum install telegraf安装指南docs/INSTALL_GUIDE.mdmacOS系统macOS用户可以使用Homebrew安装Telegrafbrew update brew install telegraf注意Homebrew构建的Telegraf与官方二进制版本有所不同因为Homebrew使用CGO进行构建。Windows系统Windows用户可以从官方网站下载MSI安装包或者使用PowerShell安装# 下载并安装Telegraf choco install telegrafDocker容器如果你使用Docker可以直接拉取官方镜像# 最新的Debian基础镜像 docker pull telegraf # 最新的Alpine基础镜像更小的体积 docker pull telegraf:alpine配置TelegrafTelegraf使用TOML格式的配置文件。配置文件主要包含三个部分全局标签(global tags)、代理设置(agent)和插件(plugins)。生成默认配置文件可以使用以下命令生成默认配置文件telegraf config telegraf.conf如果只想生成包含特定输入输出插件的配置文件可以使用--input-filter和--output-filter参数telegraf config --input-filter cpu:mem:net --output-filter influxdb:file telegraf.conf对于Windows PowerShell用户需要指定输出编码telegraf.exe config | Out-File -Encoding utf8 telegraf.conf配置指南docs/CONFIGURATION.md配置文件结构Telegraf配置文件的基本结构如下# 全局标签将添加到所有指标中 [global_tags] env production datacenter dc1 # Agent设置 [agent] interval 10s # 数据采集间隔 round_interval true # 是否将采集时间四舍五入到interval的整数倍 metric_batch_size 1000 # 批量发送的指标数量 metric_buffer_limit 10000 # 指标缓冲区大小 flush_interval 10s # 数据刷新间隔 flush_jitter 0s # 刷新抖动时间 precision # 时间戳精度 debug false # 是否开启调试模式 quiet false # 是否开启安静模式 logfile # 日志文件路径 hostname # 主机名留空则使用系统主机名 omit_hostname false # 是否省略主机名标签 # 输入插件配置 [[inputs.cpu]] percpu true totalcpu true collect_cpu_time false report_active false [[inputs.mem]] # 内存监控插件配置 # 输出插件配置 [[outputs.influxdb]] urls [http://localhost:8086] database telegraf retention_policy write_consistency any timeout 5s [[outputs.file]] files [stdout, /tmp/metrics.out] data_format influx环境变量使用Telegraf配置文件支持使用环境变量格式为${ENV_VAR}。例如[[outputs.influxdb]] urls [${INFLUXDB_URL}] database ${INFLUXDB_DATABASE} username ${INFLUXDB_USERNAME} password ${INFLUXDB_PASSWORD}你可以在/etc/default/telegrafLinux或环境变量中设置这些值export INFLUXDB_URLhttp://localhost:8086 export INFLUXDB_DATABASEtelegraf export INFLUXDB_USERNAMEtelegraf export INFLUXDB_PASSWORDsecret还可以为环境变量设置默认值# 如果INFLUXDB_PORT未设置则使用默认值8086 port ${INFLUXDB_PORT:-8086}常用插件配置示例CPU监控插件[[inputs.cpu]] percpu true # 是否收集每个CPU的指标 totalcpu true # 是否收集总CPU的指标 collect_cpu_time false # 是否收集CPU时间 report_active false # 是否报告活跃时间而不是使用率百分比 name_suffix _usage # 指标名称后缀内存监控插件[[inputs.mem]] # 是否收集可用内存指标 available_percent true # 是否收集内存使用详细信息 detail true # 要忽略的内存类型 ignore_types [cached, buffered]文件输出插件[[outputs.file]] # 输出文件路径stdout表示标准输出 files [stdout, /var/log/telegraf/metrics.out] # 数据格式支持influx、json、graphite等 data_format influx # JSON格式设置当data_format为json时 json_timestamp_units 1s json_serializer_version 2运行Telegraf前台运行使用以下命令前台运行Telegraf并指定配置文件telegraf --config telegraf.conf如果需要查看详细的调试信息可以加上--debug参数telegraf --config telegraf.conf --debug作为服务运行在Linux系统上可以使用systemd或sysvinit将Telegraf作为服务运行# 启动Telegraf服务 sudo systemctl start telegraf # 设置开机自启 sudo systemctl enable telegraf # 查看服务状态 sudo systemctl status telegraf # 查看日志 journalctl -u telegrafDocker运行使用Docker运行Telegrafdocker run -d \ --name telegraf \ -v $PWD/telegraf.conf:/etc/telegraf/telegraf.conf:ro \ telegraf如果需要使用主机网络便于监控主机资源docker run -d \ --name telegraf \ --nethost \ -v $PWD/telegraf.conf:/etc/telegraf/telegraf.conf:ro \ telegraf验证数据采集检查服务状态首先确认Telegraf服务是否正常运行sudo systemctl status telegraf如果服务运行正常应该会看到类似以下输出● telegraf.service - The plugin-driven server agent for reporting metrics into InfluxDB Loaded: loaded (/lib/systemd/system/telegraf.service; enabled; vendor preset: enabled) Active: active (running) since Wed 2023-10-11 10:00:00 UTC; 5min ago Docs: https://github.com/influxdata/telegraf Main PID: 1234 (telegraf) Tasks: 10 (limit: 4915) Memory: 15.0M CGroup: /system.slice/telegraf.service └─1234 /usr/bin/telegraf -config /etc/telegraf/telegraf.conf -config-directory /etc/telegraf/telegraf.d查看日志通过查看日志可以了解Telegraf的运行状态和是否有错误发生journalctl -u telegraf -f正常情况下日志应该显示Telegraf已成功启动并开始采集数据telegraf[1234]: 2023-10-11T10:00:00Z I! Starting Telegraf 1.27.0 telegraf[1234]: 2023-10-11T10:00:00Z I! Loaded inputs: cpu mem telegraf[1234]: 2023-10-11T10:00:00Z I! Loaded outputs: influxdb file telegraf[1234]: 2023-10-11T10:00:00Z I! Tags enabled: hostserver01 telegraf[1234]: 2023-10-11T10:00:00Z I! [agent] Config: Interval:10s, Quiet:false, Hostname:server01, Flush Interval:10s验证输出如果配置了文件输出插件可以查看输出文件确认是否有数据tail -f /tmp/metrics.out如果配置了InfluxDB输出可以使用influx客户端查询数据influx -database telegraf -execute SELECT * FROM cpu LIMIT 10常用插件介绍Telegraf拥有丰富的插件生态系统以下是一些常用的插件系统监控插件CPU监控plugins/inputs/cpu内存监控plugins/inputs/mem磁盘监控plugins/inputs/disk网络监控plugins/inputs/net进程监控plugins/inputs/procstat数据库监控插件MySQL监控plugins/inputs/mysqlPostgreSQL监控plugins/inputs/postgresqlRedis监控plugins/inputs/redisMongoDB监控plugins/inputs/mongodb输出插件InfluxDB输出plugins/outputs/influxdbPrometheus输出plugins/outputs/prometheus_client文件输出plugins/outputs/fileKafka输出plugins/outputs/kafka进阶配置配置文件拆分对于复杂的配置可以将不同插件的配置拆分为多个文件放在配置目录中默认为/etc/telegraf/telegraf.d/Telegraf会自动加载该目录下所有以.conf结尾的文件。例如可以创建/etc/telegraf/telegraf.d/cpu.conf、/etc/telegraf/telegraf.d/mem.conf等文件分别存放不同插件的配置。使用环境变量存储敏感信息对于密码、令牌等敏感信息建议使用环境变量或secretstore而不是直接写在配置文件中。Telegraf支持使用secretstore来管理敏感信息例如[[secretstores.os]] id os_secrets [[inputs.http]] urls [https://api.example.com/metrics] username {os_secrets:api_username} password {os_secrets:api_password}处理器插件使用处理器插件可以对采集到的指标进行处理例如重命名、过滤、转换等。[[processors.rename]] order 1 [[processors.rename.replace]] tag host dest server [[processors.drop]] order 2 fielddrop [usage_guest, usage_guest_nice]常见问题解决服务启动失败如果Telegraf服务启动失败可以先尝试手动运行Telegraf并查看错误信息telegraf --config /etc/telegraf/telegraf.conf --test--test参数会让Telegraf运行一次采集并退出便于排查配置问题。插件不产生数据如果某个插件没有产生预期的数据可以检查插件是否正确配置开启调试模式查看详细日志确认相关服务是否正常运行检查网络连接和权限问题时间同步问题Telegraf依赖系统时间如果系统时间不准确可能会导致指标时间戳错误。确保NTP服务正常运行系统时间准确。总结Telegraf是一个功能强大、易于使用的数据采集代理通过灵活的插件系统可以满足各种监控需求。本文介绍了Telegraf的安装、配置和基本使用方法希望能帮助你快速上手Telegraf。要深入了解Telegraf的更多功能可以参考官方文档和插件文档探索更多高级特性和配置选项。如果你觉得本文对你有帮助请点赞、收藏并关注我们获取更多关于Telegraf和监控系统的实用教程下期预告《Telegraf高级配置与性能优化》【免费下载链接】telegrafAgent for collecting, processing, aggregating, and writing metrics, logs, and other arbitrary data.项目地址: https://gitcode.com/GitHub_Trending/te/telegraf创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
5分钟上手Telegraf：从安装到数据采集的零门槛指南
发布时间：2026/6/4 23:57:29
5分钟上手Telegraf从安装到数据采集的零门槛指南【免费下载链接】telegrafAgent for collecting, processing, aggregating, and writing metrics, logs, and other arbitrary data.项目地址: https://gitcode.com/GitHub_Trending/te/telegraf你是否还在为服务器监控数据采集烦恼面对五花八门的监控工具是否感到无从下手本文将带你5分钟快速掌握Telegraf的安装与配置轻松实现服务器指标的采集与上报。读完本文你将能够在不同操作系统上正确安装Telegraf理解并编写基础的Telegraf配置文件配置常用输入输出插件验证数据采集是否成功关于TelegrafTelegraf是一个插件驱动的服务器代理用于收集和报告指标。它编译为单个静态二进制文件易于安装和部署。Telegraf拥有丰富的插件生态系统涵盖系统监控、网络、数据库等多个领域能够满足各种监控需求。官方文档docs/README.md 项目主页README.md安装TelegrafTelegraf支持多种安装方式包括二进制包、Docker镜像、RPM/DEB包等。以下是几种常见系统的安装方法Linux系统对于Debian/Ubuntu系统可以使用以下命令添加InfluxData仓库并安装Telegraf# 添加仓库GPG密钥 wget -q https://repos.influxdata.com/influxdata-archive.key gpg --show-keys --with-fingerprint --with-colons ./influxdata-archive.key 21 | grep -q ^fpr:\24C975CBA61A024EE1B631787C3D57159FC2F927:$ cat influxdata-archive.key | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/influxdata-archive.gpg /dev/null # 添加仓库源 echo deb [signed-by/etc/apt/trusted.gpg.d/influxdata-archive.gpg] https://repos.influxdata.com/debian stable main | sudo tee /etc/apt/sources.list.d/influxdata.list # 安装Telegraf sudo apt-get update sudo apt-get install telegraf对于RHEL/CentOS系统可以使用以下命令# 创建仓库文件 cat EOF | sudo tee /etc/yum.repos.d/influxdata.repo [influxdata] name InfluxData Repository - Stable baseurl https://repos.influxdata.com/stable/\$basearch/main enabled 1 gpgcheck 1 gpgkey https://repos.influxdata.com/influxdata-archive.key EOF # 安装Telegraf sudo yum install telegraf安装指南docs/INSTALL_GUIDE.mdmacOS系统macOS用户可以使用Homebrew安装Telegrafbrew update brew install telegraf注意Homebrew构建的Telegraf与官方二进制版本有所不同因为Homebrew使用CGO进行构建。Windows系统Windows用户可以从官方网站下载MSI安装包或者使用PowerShell安装# 下载并安装Telegraf choco install telegrafDocker容器如果你使用Docker可以直接拉取官方镜像# 最新的Debian基础镜像 docker pull telegraf # 最新的Alpine基础镜像更小的体积 docker pull telegraf:alpine配置TelegrafTelegraf使用TOML格式的配置文件。配置文件主要包含三个部分全局标签(global tags)、代理设置(agent)和插件(plugins)。生成默认配置文件可以使用以下命令生成默认配置文件telegraf config telegraf.conf如果只想生成包含特定输入输出插件的配置文件可以使用--input-filter和--output-filter参数telegraf config --input-filter cpu:mem:net --output-filter influxdb:file telegraf.conf对于Windows PowerShell用户需要指定输出编码telegraf.exe config | Out-File -Encoding utf8 telegraf.conf配置指南docs/CONFIGURATION.md配置文件结构Telegraf配置文件的基本结构如下# 全局标签将添加到所有指标中 [global_tags] env production datacenter dc1 # Agent设置 [agent] interval 10s # 数据采集间隔 round_interval true # 是否将采集时间四舍五入到interval的整数倍 metric_batch_size 1000 # 批量发送的指标数量 metric_buffer_limit 10000 # 指标缓冲区大小 flush_interval 10s # 数据刷新间隔 flush_jitter 0s # 刷新抖动时间 precision # 时间戳精度 debug false # 是否开启调试模式 quiet false # 是否开启安静模式 logfile # 日志文件路径 hostname # 主机名留空则使用系统主机名 omit_hostname false # 是否省略主机名标签 # 输入插件配置 [[inputs.cpu]] percpu true totalcpu true collect_cpu_time false report_active false [[inputs.mem]] # 内存监控插件配置 # 输出插件配置 [[outputs.influxdb]] urls [http://localhost:8086] database telegraf retention_policy write_consistency any timeout 5s [[outputs.file]] files [stdout, /tmp/metrics.out] data_format influx环境变量使用Telegraf配置文件支持使用环境变量格式为${ENV_VAR}。例如[[outputs.influxdb]] urls [${INFLUXDB_URL}] database ${INFLUXDB_DATABASE} username ${INFLUXDB_USERNAME} password ${INFLUXDB_PASSWORD}你可以在/etc/default/telegrafLinux或环境变量中设置这些值export INFLUXDB_URLhttp://localhost:8086 export INFLUXDB_DATABASEtelegraf export INFLUXDB_USERNAMEtelegraf export INFLUXDB_PASSWORDsecret还可以为环境变量设置默认值# 如果INFLUXDB_PORT未设置则使用默认值8086 port ${INFLUXDB_PORT:-8086}常用插件配置示例CPU监控插件[[inputs.cpu]] percpu true # 是否收集每个CPU的指标 totalcpu true # 是否收集总CPU的指标 collect_cpu_time false # 是否收集CPU时间 report_active false # 是否报告活跃时间而不是使用率百分比 name_suffix _usage # 指标名称后缀内存监控插件[[inputs.mem]] # 是否收集可用内存指标 available_percent true # 是否收集内存使用详细信息 detail true # 要忽略的内存类型 ignore_types [cached, buffered]文件输出插件[[outputs.file]] # 输出文件路径stdout表示标准输出 files [stdout, /var/log/telegraf/metrics.out] # 数据格式支持influx、json、graphite等 data_format influx # JSON格式设置当data_format为json时 json_timestamp_units 1s json_serializer_version 2运行Telegraf前台运行使用以下命令前台运行Telegraf并指定配置文件telegraf --config telegraf.conf如果需要查看详细的调试信息可以加上--debug参数telegraf --config telegraf.conf --debug作为服务运行在Linux系统上可以使用systemd或sysvinit将Telegraf作为服务运行# 启动Telegraf服务 sudo systemctl start telegraf # 设置开机自启 sudo systemctl enable telegraf # 查看服务状态 sudo systemctl status telegraf # 查看日志 journalctl -u telegrafDocker运行使用Docker运行Telegrafdocker run -d \ --name telegraf \ -v $PWD/telegraf.conf:/etc/telegraf/telegraf.conf:ro \ telegraf如果需要使用主机网络便于监控主机资源docker run -d \ --name telegraf \ --nethost \ -v $PWD/telegraf.conf:/etc/telegraf/telegraf.conf:ro \ telegraf验证数据采集检查服务状态首先确认Telegraf服务是否正常运行sudo systemctl status telegraf如果服务运行正常应该会看到类似以下输出● telegraf.service - The plugin-driven server agent for reporting metrics into InfluxDB Loaded: loaded (/lib/systemd/system/telegraf.service; enabled; vendor preset: enabled) Active: active (running) since Wed 2023-10-11 10:00:00 UTC; 5min ago Docs: https://github.com/influxdata/telegraf Main PID: 1234 (telegraf) Tasks: 10 (limit: 4915) Memory: 15.0M CGroup: /system.slice/telegraf.service └─1234 /usr/bin/telegraf -config /etc/telegraf/telegraf.conf -config-directory /etc/telegraf/telegraf.d查看日志通过查看日志可以了解Telegraf的运行状态和是否有错误发生journalctl -u telegraf -f正常情况下日志应该显示Telegraf已成功启动并开始采集数据telegraf[1234]: 2023-10-11T10:00:00Z I! Starting Telegraf 1.27.0 telegraf[1234]: 2023-10-11T10:00:00Z I! Loaded inputs: cpu mem telegraf[1234]: 2023-10-11T10:00:00Z I! Loaded outputs: influxdb file telegraf[1234]: 2023-10-11T10:00:00Z I! Tags enabled: hostserver01 telegraf[1234]: 2023-10-11T10:00:00Z I! [agent] Config: Interval:10s, Quiet:false, Hostname:server01, Flush Interval:10s验证输出如果配置了文件输出插件可以查看输出文件确认是否有数据tail -f /tmp/metrics.out如果配置了InfluxDB输出可以使用influx客户端查询数据influx -database telegraf -execute SELECT * FROM cpu LIMIT 10常用插件介绍Telegraf拥有丰富的插件生态系统以下是一些常用的插件系统监控插件CPU监控plugins/inputs/cpu内存监控plugins/inputs/mem磁盘监控plugins/inputs/disk网络监控plugins/inputs/net进程监控plugins/inputs/procstat数据库监控插件MySQL监控plugins/inputs/mysqlPostgreSQL监控plugins/inputs/postgresqlRedis监控plugins/inputs/redisMongoDB监控plugins/inputs/mongodb输出插件InfluxDB输出plugins/outputs/influxdbPrometheus输出plugins/outputs/prometheus_client文件输出plugins/outputs/fileKafka输出plugins/outputs/kafka进阶配置配置文件拆分对于复杂的配置可以将不同插件的配置拆分为多个文件放在配置目录中默认为/etc/telegraf/telegraf.d/Telegraf会自动加载该目录下所有以.conf结尾的文件。例如可以创建/etc/telegraf/telegraf.d/cpu.conf、/etc/telegraf/telegraf.d/mem.conf等文件分别存放不同插件的配置。使用环境变量存储敏感信息对于密码、令牌等敏感信息建议使用环境变量或secretstore而不是直接写在配置文件中。Telegraf支持使用secretstore来管理敏感信息例如[[secretstores.os]] id os_secrets [[inputs.http]] urls [https://api.example.com/metrics] username {os_secrets:api_username} password {os_secrets:api_password}处理器插件使用处理器插件可以对采集到的指标进行处理例如重命名、过滤、转换等。[[processors.rename]] order 1 [[processors.rename.replace]] tag host dest server [[processors.drop]] order 2 fielddrop [usage_guest, usage_guest_nice]常见问题解决服务启动失败如果Telegraf服务启动失败可以先尝试手动运行Telegraf并查看错误信息telegraf --config /etc/telegraf/telegraf.conf --test--test参数会让Telegraf运行一次采集并退出便于排查配置问题。插件不产生数据如果某个插件没有产生预期的数据可以检查插件是否正确配置开启调试模式查看详细日志确认相关服务是否正常运行检查网络连接和权限问题时间同步问题Telegraf依赖系统时间如果系统时间不准确可能会导致指标时间戳错误。确保NTP服务正常运行系统时间准确。总结Telegraf是一个功能强大、易于使用的数据采集代理通过灵活的插件系统可以满足各种监控需求。本文介绍了Telegraf的安装、配置和基本使用方法希望能帮助你快速上手Telegraf。要深入了解Telegraf的更多功能可以参考官方文档和插件文档探索更多高级特性和配置选项。如果你觉得本文对你有帮助请点赞、收藏并关注我们获取更多关于Telegraf和监控系统的实用教程下期预告《Telegraf高级配置与性能优化》【免费下载链接】telegrafAgent for collecting, processing, aggregating, and writing metrics, logs, and other arbitrary data.项目地址: https://gitcode.com/GitHub_Trending/te/telegraf创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
