fabianbees/docker-telegraf-smartmontools Docker 镜像 - 轩辕镜像

docker-telegraf-smartmontools

镜像概述

docker-telegraf-smartmontools是一个集成了Telegraf和smartmontools的Docker镜像，旨在提供便捷的存储设备健康监控解决方案。该镜像能够自动检测系统中的存储设备，收集SMART (Self-Monitoring, Analysis and Reporting Technology) 数据，并通过Telegraf将这些指标发送到InfluxDB或其他支持的时间序列数据库，帮助用户实时监控存储设备状态，提前预警潜在的硬件故障。

核心功能和特性

• 集成工具：包含Telegraf 1.21+和smartmontools 7.2+
• 自动检测：自动发现系统中的存储设备
• SMART数据收集：获取硬盘温度、坏道计数、使用寿命等关键指标
• 灵活输出：支持多种数据输出目标，包括InfluxDB、Prometheus、Graphite等
• 容器化部署：简化的部署流程，易于集成到现有监控系统

使用场景和适用范围

• 服务器存储健康监控
• 网络存储设备(NAS)状态监测
• 数据中心硬盘故障预警
• 个人电脑存储健康管理
• 需要长期监控存储设备状态的任何环境

使用方法和配置说明

基本使用

bash
docker run -d \
  --name=telegraf-smartmontools \
  --privileged \
  -v /dev/disk/by-id:/dev/disk/by-id:ro \
  -e INFLUXDB_URL="[***]" \
  -e INFLUXDB_DB="smartmon" \
  -e INFLUXDB_USER="telegraf" \
  -e INFLUXDB_PASSWORD="securepassword" \
  fabianbees/telegraf-smartmontools

Docker Compose 配置

yaml
version: '3'
services:
  telegraf-smartmontools:
    image: fabianbees/telegraf-smartmontools
    container_name: telegraf-smartmontools
    privileged: true
    volumes:
      - /dev/disk/by-id:/dev/disk/by-id:ro
    environment:
      - INFLUXDB_URL=[***]
      - INFLUXDB_DB=smartmon
      - INFLUXDB_USER=telegraf
      - INFLUXDB_PASSWORD=securepassword
      - TZ=Asia/Shanghai
    restart: unless-stopped

环境变量配置

自定义Telegraf配置

如需自定义Telegraf配置，可以挂载自定义配置文件：

bash
docker run -d \
  --name=telegraf-smartmontools \
  --privileged \
  -v /dev/disk/by-id:/dev/disk/by-id:ro \
  -v /path/to/telegraf.conf:/etc/telegraf/telegraf.conf \
  fabianbees/telegraf-smartmontools

收集的指标

该镜像收集以下关键SMART指标：

• 硬盘温度
• 通电时间
• 启动/停止次数
• 读写错误计数
• 坏道数量
• 使用寿命百分比
• 各种SMART属性的原始值和规范化值

注意事项

• 容器需要--privileged权限才能访问存储设备
• 确保宿主机已安装并加载了必要的内核模块
• 某些老旧硬盘可能不支持SMART功能
• 对于NVMe设备，可能需要额外配置

故障排除

• 无法检测到设备：确保正确挂载了/dev/disk/by-id目录
• 权限问题：确认容器以特权模式运行
• 数据未发送到InfluxDB：检查网络连接和InfluxDB凭据
• 高CPU使用率：尝试增加扫描间隔(SCAN_INTERVAL)