prometheuscommunity/ipmi-exporter

Prometheus IPMI Exporter 镜像文档

镜像概述和主要用途

prometheuscommunity/ipmi-exporter是Prometheus社区维护的IPMI（智能平台管理接口）指标导出工具，用于将IPMI设备的硬件状态指标（如温度、电压、风扇转速等）转换为Prometheus可抓取的格式。该exporter支持两种工作模式：通过/metrics端点收集运行主机的本地IPMI指标，以及通过/ipmi端点（遵循多目标exporter模式）监控远程IPMI设备（通过RMCP协议）。默认依赖FreeIPMI工具集实现IPMI功能，同时提供实验性的Go原生IPMI库（go-ipmi）支持，以减少外部依赖。

核心功能和特性

• 双端点支持：提供/metrics端点（本地主机IPMI指标）和/ipmi端点（远程多目标RMCP监控），满足不同监控场景需求。
• 多IPMI实现：默认集成FreeIPMI工具集（稳定可靠），可选实验性Go原生库（go-ipmi），支持减少外部依赖。
• 多目标监控：/ipmi端点遵循Prometheus多目标exporter模式，支持集中监控多台远程IPMI设备。
• 安全增强：支持TLS加密和基本认证，可通过配置文件启用，提升指标传输安全性。
• 灵活配置：支持自定义配置文件，可调整监控参数、设备认证信息等。

使用场景和适用范围

• 本地服务器监控：部署在服务器本地，通过/metrics端点收集本机IPMI硬件状态指标。
• 远程设备集中监控：作为中心节点部署，通过/ipmi端点（配合Prometheus多目标配置）监控多台远程服务器的IPMI设备（需支持RMCP协议）。
• Kubernetes环境：结合社区维护的Helm Chart，在K8s集群中部署，监控集群节点的硬件状态。
• 硬件健康监控：适用于需要实时跟踪服务器硬件健康状态（如温度、电源、风扇等）的场景。

安装与部署

Docker镜像获取

预构建容器镜像可从以下仓库获取：

• Docker Hub：prometheuscommunity/ipmi-exporter
• Quay.io：quay.io/prometheuscommunity/ipmi-exporter

Kubernetes部署

可使用社区维护的Helm Chart：

helm repo add prometheus-community https://prometheus-community.github.io/helm-charts
helm install prometheus-ipmi-exporter prometheus-community/prometheus-ipmi-exporter

使用方法

基本运行参数

Docker运行示例

基本本地监控（默认配置）

bash
docker run -d -p 9290:9290 --name ipmi-exporter prometheuscommunity/ipmi-exporter

挂载自定义配置文件

bash
docker run -d -p 9290:9290 \
  -v /host/path/to/config.yml:/etc/ipmi_exporter/config.yml \
  --name ipmi-exporter \
  prometheuscommunity/ipmi-exporter \
  --config.file=/etc/ipmi_exporter/config.yml

启用TLS和基本认证

bash
docker run -d -p 9290:9290 \
  -v /host/path/to/web-config.yml:/etc/ipmi_exporter/web-config.yml \
  --name ipmi-exporter \
  prometheuscommunity/ipmi-exporter \
  --web.config.file=/etc/ipmi_exporter/web-config.yml

配置说明

核心配置

exporter配置文件（通过--config.file指定）支持定义设备认证信息、监控模块等，详细格式见https://github.com/prometheus-community/ipmi_exporter/blob/main/docs/configuration.md%E3%80%82

TLS和基本认证

通过--web.config.file参数指定Web配置文件，支持启用TLS和基本认证。配置文件格式遵循Prometheus exporter-toolkit规范，详细说明见https://github.com/prometheus/exporter-toolkit/blob/master/docs/web-configuration.md%E3%80%82

导出指标

exporter提供的指标包括硬件健康状态（如温度、电压、风扇转速、电源状态等），详细指标说明见https://github.com/prometheus-community/ipmi_exporter/blob/main/docs/metrics.md%E3%80%82

权限要求

• 本地监控：收集主机本地IPMI指标需root权限（访问系统IPMI设备接口），非root运行配置方法见https://github.com/prometheus-community/ipmi_exporter/blob/main/docs/privileges.md%E3%80%82
• 远程监控：通过RMCP监控远程设备时，需确保exporter可访问目标设备的IPMI端口（默认623/UDP），并拥有目标设备的IPMI认证凭证。

实验性特性

提供Go原生IPMI库（go-ipmi）支持，可替代FreeIPMI工具集，减少外部依赖。使用方法见https://github.com/prometheus-community/ipmi_exporter/blob/main/docs/native.md%EF%BC%8C%E6%AC%A2%E8%BF%8E%E5%8F%8D%E9%A6%88%E4%BB%A5%E5%AE%8C%E5%96%84%E8%AF%A5%E5%8A%9F%E8%83%BD%E3%80%82