matusnovak/prometheus-smartctl

Prometheus S.M.A.R.T指标导出器Docker镜像

概述

该Docker镜像用于向Prometheus导出存储设备的S.M.A.R.T（自我监控、分析与报告技术）指标。由于依赖smartctl命令行工具访问硬件信息，镜像需要以特权模式运行。

项目仓库：https://github.com/matusnovak/prometheus-smartctl

核心功能与特性

• 导出存储设备的S.M.A.R.T指标至Prometheus
• 基于smartctl工具实现硬件级别的状态监控
• 提供HTTP接口暴露指标，默认端口9902
• 支持通过Docker Compose快速部署

使用场景

适用于需要通过Prometheus监控存储设备健康状态的场景，如：

• 服务器存储硬件监控
• 磁盘故障预警与状态跟踪
• 集成到Prometheus+Grafana监控体系中

使用方法

Docker Compose部署

创建docker-compose.yml文件，配置如下：

yaml
version: '3'
services:
  smartctl-metrics:
    image: matusnovak/prometheus-smartctl:latest
    restart: unless-stopped
    privileged: true  # 必须启用特权模式以访问硬件信息
    ports:
      - 9902:9902  # 映射指标暴露端口

启动服务：

bash
docker-compose up -d

访问指标

指标可通过以下地址访问： http://localhost:9902/metrics

注意事项

• 必须启用privileged: true配置，否则无法正常读取S.M.A.R.T信息
• 确保主机已安装smartmontools（部分系统可能需要额外配置）
• 默认端口9902可通过端口映射修改，需确保与Prometheus配置一致