antilax3/smart-exporter

自动构建

smart-exporter是一个用Node.js编写的简单服务器，可定期抓取S.M.A.R.T统计数据并通过HTTP导出供Prometheus使用，支持配置导出的属性及标签。

2 收藏0 次下载activeantilax3镜像

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

中文简介版本下载

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

AntilaX-3/smart-exporter

镜像概述和主要用途

smart-exporter是一个用Node.js编写的简单服务器，其核心功能是定期抓取存储设备的S.M.A.R.T（自我监控、分析与报告技术）统计数据，并通过HTTP接口导出，供Prometheus监控系统收集和分析。该镜像支持自定义配置需要导出的S.M.A.R.T属性及相关标签，适用于需要对存储设备健康状态进行持续监控的场景。

核心功能和特性

定期数据抓取：可配置抓取间隔，自动周期性获取S.M.A.R.T数据
灵活配置：支持自定义需要导出的S.M.A.R.T属性及Prometheus标签
Prometheus兼容：通过HTTP接口导出符合Prometheus格式的指标数据
轻量实现：基于Node.js开发，运行资源占用低

使用场景和适用范围

适用于需要通过Prometheus监控存储设备（如硬盘、SSD）健康状态的环境，可帮助运维人员及时发现磁盘潜在故障风险。典型应用场景包括服务器机房、数据中心存储监控、个人NAS系统等需要对存储设备进行持续健康状态跟踪的场景。

使用方法和配置说明

基本部署命令

bash
docker create --name=smartexporter \
-v <主机配置目录路径>:/config \
-p 9120:9120 \
--privileged=true \
antilax3/smart-exporter

参数说明

参数	说明
`-v <主机配置目录路径>:/config`	挂载主机目录到容器内的`/config`，用于存储配置文件
`-p 9120:9120`	端口映射，将容器的9120端口映射到主机的9120端口，用于HTTP指标导出
`--privileged=true`	特权模式，由于需要访问主机存储设备的S.M.A.R.T数据，必须启用该模式
`-e PUID=<用户ID>`	可选，指定运行容器的用户ID，避免权限问题（默认无需设置）
`-e PGID=<组ID>`	可选，指定运行容器的组ID，避免权限问题（默认无需设置）
`-e TZ=<时区>`	可选，设置容器时区，如`Asia/Shanghai`（默认使用容器内时区）

用户/组ID设置

当使用数据卷挂载时，可能出现主机与容器之间的权限问题。可通过指定PUID和PGID解决，确保主机数据卷目录的所有者与容器内运行用户一致。

获取当前用户的ID和组ID：

bash
$ id <用户名>
uid=1001(用户名) gid=1001(组名) groups=1001(组名)

将输出的uid作为PUID，gid作为PGID。

卷说明

容器仅使用一个卷：

挂载路径：/config
用途：存储配置文件smartexporter.json

目录结构：

config/
└── smartexporter.json  # 应用配置文件

首次运行容器时，配置文件会自动复制到/config卷中。

配置说明

配置文件smartexporter.json包含以下参数：

可选参数

scrapeInterval：数据抓取间隔（单位：秒），默认值为10秒。

必填参数

reportedAttributes：数组类型，定义需要解析和导出的S.M.A.R.T属性，每个对象包含：
- attributeID：数字类型，S.M.A.R.T属性ID（与attributeName二选一）
- attributeName：字符串类型，S.M.A.R.T属性名称（与attributeID二选一）
- name：字符串类型（必填），导出到Prometheus的指标名称前缀（实际指标名为smartexporter_<name>）
- help：字符串类型（必填），Prometheus指标的帮助文本
- labelNames：字符串数组类型，从smartctl信息部分映射的标签，如"Device"（设备路径，如/dev/sdx）或"Serial Number"（硬盘序列号）

配置示例（默认配置参考默认文件）：

json
{
  "scrapeInterval": 15,
  "reportedAttributes": [
    {
      "attributeID": 5,
      "name": "reallocated_sector_count",
      "help": "Number of reallocated sectors",
      "labelNames": ["Device", "Serial Number"]
    },
    {
      "attributeName": "Temperature_Celsius",
      "name": "temperature",
      "help": "Device temperature in Celsius",
      "labelNames": ["Device"]
    }
  ]
}