ytzelf/telegraf

telegraf-alpine-smart-ipmi 镜像文档

镜像概述

本镜像基于最新版 telegraf:alpine 构建，在原生Telegraf功能基础上，集成了 smartmontools（含smartctl）和 ipmitool 工具。旨在提供轻量级、功能扩展的系统监控解决方案，特别适用于需要同时采集系统性能指标与硬件健康状态的场景。

核心功能与特性

• Telegraf基础功能：完整继承官方telegraf:alpine的所有数据采集能力，支持多种输入插件（如CPU、内存、磁盘I/O等）和输出插件（如InfluxDB、Prometheus等）。
• smartmontools集成：内置smartctl工具，可直接监控存储设备（HDD/SSD）的SMART状态，包括温度、坏道计数、使用寿命等关键指标。
• ipmitool集成：支持通过IPMI协议监控服务器硬件状态，如电源、风扇转速、主板温度、电压等。
• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低，适合边缘设备和资源受限环境。

使用场景

• 服务器硬件监控：对物理服务器或边缘计算设备进行全面硬件健康状态监控。
• 存储设备管理：实时跟踪硬盘/SSD的SMART属性，提前预警存储故障风险。
• 数据中心基础设施监控：结合Telegraf的数据采集能力，构建涵盖系统性能与硬件状态的一体化监控体系。
• 嵌入式设备监控：在资源有限的嵌入式环境中，实现高效的系统与硬件监控。

使用方法

基本运行命令

bash
docker run -d \
  --name telegraf-smart-ipmi \
  --privileged \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /sys:/sys \
  -v /dev/disk/by-id:/dev/disk/by-id \
  -v /path/to/telegraf.conf:/etc/telegraf/telegraf.conf \
  telegraf-alpine-smart-ipmi

注意：--privileged 权限用于允许smartctl访问存储设备和ipmitool访问硬件接口；挂载/dev/disk/by-id可确保设备路径稳定。

Telegraf配置示例

在自定义telegraf.conf中添加以下插件配置，启用硬件监控功能：

SMART监控配置

toml
[[inputs.smart]]
  ## 设备列表，可使用/dev/disk/by-id路径
  devices = ["/dev/disk/by-id/ata-ST1000LM049-2GH172_WDE123456789"]
  ## 采集间隔
  interval = "300s"
  ## 超时时间
  timeout = "10s"

IPMI监控配置

toml
[[inputs.ipmi_sensor]]
  ## IPMI连接方式（local或lan）
  path = "ipmitool"
  ## 本地监控无需指定用户名密码
  ## 远程监控需添加：
  # username = "admin"
  # password = "secret"
  # server = "192.168.1.100"
  interval = "60s"

环境变量配置

支持Telegraf官方所有环境变量，常用配置：

docker-compose示例

yaml
version: '3'
services:
  telegraf:
    image: telegraf-alpine-smart-ipmi
    container_name: telegraf-smart-ipmi
    privileged: true
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /sys:/sys
      - /dev/disk/by-id:/dev/disk/by-id
      - ./telegraf.conf:/etc/telegraf/telegraf.conf
    environment:
      - INFLUXDB_URL=http://influxdb:8086
      - INFLUXDB_TOKEN=my-secret-token
      - INFLUXDB_ORG=my-org
      - INFLUXDB_BUCKET=telegraf-data
    restart: unless-stopped

注意事项

• 运行时需确保容器具有足够权限访问硬件设备，推荐使用--privileged模式或根据实际需求添加特定设备权限。
• 不同硬件环境的SMART属性和IPMI传感器可能存在差异，需根据实际设备调整Telegraf配置。
• 定期更新镜像以获取最新的Telegraf版本和工具安全补丁。