prom/node-exporter

Node exporter

Node exporter 是一款 Prometheus 导出器，用于收集类 Unix 内核暴露的硬件和操作系统指标，采用 Go 语言开发，支持可插拔的指标收集器。

Windows 用户建议使用 [Windows exporter] ，如需暴露 NVIDIA GPU 指标，可搭配使用 [prometheus-dcgm] 。

安装与使用

如果您刚接触 Prometheus 和 node_exporter，可参考 [简易分步指南] 。

node_exporter 默认监听 HTTP 端口 9100，更多配置选项可通过 --help 查看。

Ansible 自动化部署

如需通过 [Ansible] 自动化安装，可使用 [Prometheus 社区角色] 。

Docker 部署

node_exporter 设计用于监控主机系统，容器化部署需特别注意避免监控容器本身。若必须容器化部署，需添加额外参数以允许 node_exporter 访问主机命名空间，同时需将待监控的非根挂载点绑定挂载到容器内。

启动主机监控容器时，需指定 path.rootfs 参数，该参数需与主机根目录的绑定挂载路径一致，node_exporter 将以此为前缀访问主机文件系统。

Docker 命令行启动

bash
docker run -d \
  --net="host" \
  --pid="host" \
  -v "/:/host:ro,rslave" \
  ***-quay.xuanyuan.run/prometheus/node-exporter:latest \
  --path.rootfs=/host

Docker Compose 配置

yaml
---
version: '3.8'

services:
  node_exporter:
    image: ***-quay.xuanyuan.run/prometheus/node-exporter:latest
    container_name: node_exporter
    command:
      - '--path.rootfs=/host'
    network_mode: host
    pid: host
    restart: unless-stopped
    volumes:
      - '/:/host:ro,rslave'

部分系统中，timex 收集器需要额外添加 Docker 标志 --cap-add=SYS_TIME 以访问必要的系统调用。

收集器

不同操作系统对收集器的支持程度不同，以下表格列出所有收集器及其支持的系统。

收集器通过 --collector.<name> 标志启用，默认启用的收集器可通过 --no-collector.<name> 禁用。如需仅启用特定收集器，使用 --collector.disable-defaults --collector.<name> ...。

包含与排除标志

部分收集器支持通过专用标志配置包含或排除特定模式。排除标志（exclude）表示“除…之外”，包含标志（include）表示“仅包含…”，两者在同一收集器上互斥。

示例：

txt
--collector.filesystem.mount-points-exclude=^/(dev|proc|sys|var/lib/docker/.+|var/lib/kubelet/.+)($|/)

支持包含/排除标志的收集器列表：

默认启用的收集器

默认禁用的收集器

以下收集器默认禁用，原因包括：高基数、收集耗时过长（超过 Prometheus 抓取间隔或超时时间）、对主机资源消耗较大等。启用时建议先在非生产环境测试，观察 scrape_duration_seconds（确保收集不超时）和 scrape_samples_post_metric_relabeling（监控基数变化）。

已弃用的收集器

以下收集器已弃用，将在下次大版本更新中移除：

Perf 收集器

perf 收集器在部分 Linux 系统中可能因内核配置或安全设置无法直接使用，需调整 sysctl 参数：

bash
sysctl -w kernel.perf_event_paranoid=X

• 2：仅允许用户空间测量（Linux 4.6+ 默认）
• 1：允许内核和用户空间测量（Linux 4.6 前默认）
• 0：允许访问 CPU 特定数据，但不允许原始跟踪点采样
• -1：无限制

多数场景下 0 可提供最完整指标，更多信息见 [man 2 perf_event_open] 。

默认情况下，perf 收集器仅收集 node_exporter 运行的 CPU（通过 runtime.NumCPU 获取）。如需指定其他 CPU，使用 --collector.perf.cpus 标志，例如：

bash
--collector.perf --collector.perf.cpus=2-6  # 收集 CPU 2-6 的指标
--collector.perf --collector.perf.cpus=1-10:5  # 收集 CPU 1、5、10（步长 5）

perf 收集器还支持通过 --collector.perf.tracepoint 标志收集跟踪点（tracepoint）计数，例如：

bash
--collector.perf.tracepoint="sched:sched_process_exec"

Sysctl 收集器

通过 --collector.sysctl 启用，支持通过 --collector.sysctl.include 暴露数值型 sysctl 值为指标，通过 --collector.sysctl.include-info 暴露字符串型值为 info 指标（可重复指定）。多值 sysctl 可通过映射自定义指标名，否则使用 index 标签区分。