robustintelligencehq/node-exporter

Prometheus Node Exporter Docker镜像文档

镜像概述和主要用途

Prometheus Node Exporter是Prometheus生态系统中的核心组件之一，作为官方节点级指标收集器，专门用于采集主机（物理机、虚拟机、容器主机等）的系统级运行指标。它通过HTTP端点暴露标准化的指标数据，供Prometheus服务器定期抓取并存储，结合Grafana等可视化工具可实现对主机资源利用率、性能瓶颈的实时监控和历史趋势分析。该镜像支持多操作系统平台，兼容Prometheus数据模型，是构建基础设施监控体系的关键组件。

核心功能和特性

1. 全面的系统指标收集

• 基础系统指标：CPU使用率（用户态/内核态/空闲时间）、内存使用量（已用/缓存/交换分区）、磁盘I/O（读写吞吐量、IOPS）、磁盘空间（分区使用率、剩余容量）。
• 网络指标：网络接口流量（接收/发送字节数）、TCP/UDP连接数、网络错误（丢包/错误包）。
• 进程指标：进程总数、运行/睡眠状态进程数、进程资源占用（CPU/内存）。
• 硬件指标：CPU温度、风扇转速（部分硬件支持）。

2. 多平台兼容性

支持Linux（x86_64/ARM/ARM64）、Windows、macOS等主流操作系统，可部署于物理机、虚拟机或容器环境。

3. 模块化可扩展设计

采用模块化架构，内置数十种指标收集器（collector），支持按需启用/禁用特定指标采集（如--collector.cpu启用CPU指标，--no-collector.diskstats禁用磁盘统计指标），同时支持通过textfile收集器扩展自定义指标。

4. 轻量级与低资源占用

设计精简，运行时资源消耗低（通常占用数MB内存），对主机性能影响极小，适合长期后台运行。

5. Prometheus原生兼容

指标数据格式完全符合Prometheus规范，默认通过HTTP端点（通常为:9100/metrics）暴露，可直接被Prometheus服务器配置为抓取目标。

使用场景和适用范围

典型使用场景

• 基础设施监控：监控物理机、虚拟机、Kubernetes节点等主机的资源利用率。
• 系统性能分析：追踪CPU负载、内存泄漏、磁盘IO瓶颈、网络拥塞等性能问题。
• DevOps监控链路：作为Prometheus监控体系的“数据采集层”，为告警、可视化提供基础指标。
• 资源规划支持：通过历史指标趋势分析，辅助进行主机扩容、资源分配优化。

适用对象

• 运维工程师、DevOps团队：构建主机监控体系。
• 系统管理员：实时掌握服务器运行状态。
• 开发团队：排查与基础设施相关的应用性能问题。

使用方法和配置说明

前置要求

• Docker环境（1.13+）。
• 若需持久化自定义指标文件，需挂载宿主机目录至容器内（如/etc/node-exporter/textfile-collector）。

基础Docker部署示例

1. Docker Run命令

bash
docker run -d \
  --name node-exporter \
  --net=host \  # 使用主机网络，确保能采集主机完整指标（推荐生产环境）
  --pid=host \   # 访问主机进程命名空间，获取准确的进程指标
  -v "/:/host/root:ro,rslave" \  # 挂载主机根目录（只读），用于采集磁盘、文件系统指标
  -v "/sys:/host/sys:ro,rslave" \  # 挂载sysfs（只读），用于采集系统硬件/内核指标
  -v "/proc:/host/proc:ro,rslave" \  # 挂载procfs（只读），用于采集CPU、内存、进程指标
  prom/node-exporter:latest \
  --path.rootfs=/host/root \  # 指定主机根目录路径（与挂载路径对应）
  --web.listen-address=:9100  # 监听端口（默认9100）

说明：--net=host和--pid=host为推荐配置，确保Node Exporter能获取完整的主机指标；若使用桥接网络，需映射端口（如-p 9100:9100），但部分主机级指标（如网络接口）可能采集不完整。

2. Docker Compose配置

创建docker-compose.yml：

yaml
version: '3'
services:
  node-exporter:
    image: prom/node-exporter:latest
    container_name: node-exporter
    restart: always
    network_mode: host  # 主机网络模式
    pid: host  # 主机进程命名空间
    volumes:
      - "/:/host/root:ro,rslave"
      - "/sys:/host/sys:ro,rslave"
      - "/proc:/host/proc:ro,rslave"
      # 可选：挂载自定义指标文件目录（若使用textfile收集器）
      - "./textfile-collector:/etc/node-exporter/textfile-collector:ro"
    command:
      - '--path.rootfs=/host/root'
      - '--web.listen-address=:9100'
      # 可选：启用特定收集器（默认大部分已启用）
      - '--collector.processes'  # 启用进程指标收集
      # 可选：禁用不需要的收集器
      - '--no-collector.softnet'  # 禁用softnet指标收集

配置参数说明

Node Exporter通过命令行参数配置，常用参数如下：

集成Prometheus服务器

部署后，需在Prometheus配置文件（prometheus.yml）中添加抓取规则：

yaml
scrape_configs:
  - job_name: 'node-exporter'
    static_configs:
      - targets: ['localhost:9100']  # Node Exporter所在主机IP:端口

重启Prometheus后，即可在Prometheus UI中查询节点指标（如node_cpu_seconds_total、node_memory_MemAvailable_bytes等）。

验证部署

部署完成后，可通过以下方式验证：

1. 访问http://<主机IP>:9100/metrics，应返回Prometheus格式的指标数据。
2. 在Prometheus UI的"Targets"页面，确认node-exporter任务状态为"UP"。

注意事项

• 容器网络模式：生产环境推荐使用--net=host，避免因网络隔离导致部分指标（如网络接口）采集不完整。
• 挂载权限：挂载宿主机目录时需设置为ro（只读），防止容器内误操作影响主机。
• 安全限制：若主机启用了AppArmor/SELinux，可能需要调整配置以允许容器访问/proc、/sys等目录。
• 版本兼容性：Node Exporter版本应与Prometheus服务器版本兼容（建议使用最新稳定版）。