linuxkit/node_exporter

LinuxKit prometheus node_exporter 镜像文档

镜像概述和主要用途

本镜像基于 https://github.com/linuxkit/linuxkit/tree/master/pkg/node_exporter 构建，封装了 Prometheus 官方的 node_exporter 工具。其核心用途是作为 Prometheus 监控体系的节点级指标采集器，用于收集 Linux 主机或容器的系统级运行指标（如 CPU、内存、磁盘、网络、进程等），并通过 HTTP 接口暴露指标数据，供 Prometheus 服务器抓取和分析。

核心功能和特性

1. 全面的系统指标采集：支持收集 CPU 使用率、内存占用、磁盘 I/O、网络流量、文件系统容量、进程状态等核心系统指标。
2. 多收集器支持：内置多种采集器（collector），可按需启用/禁用（如 cpu、meminfo、diskstats、netdev 等），覆盖主流系统监控场景。
3. 轻量级设计：基于 LinuxKit 构建，镜像体积小，资源占用低，适合容器化部署。
4. 标准 Prometheus 格式：暴露的指标符合 Prometheus 数据模型（OpenMetrics 格式），可直接被 Prometheus 抓取。
5. 容器化适配：针对容器环境优化，支持通过挂载主机目录（如 /proc、/sys）获取底层系统指标。

使用场景和适用范围

• Prometheus 监控体系：作为节点监控的核心组件，配合 Prometheus Server、Grafana 构建完整的监控告警平台。
• 容器环境监控：部署在 Kubernetes 节点或独立容器中，采集容器宿主或容器内系统指标。
• DevOps 与运维分析：用于实时监控主机健康状态、性能瓶颈分析、资源使用率趋势跟踪。
• 自动化告警：结合 Prometheus Alertmanager，基于采集的指标配置告警规则（如内存使用率过高、磁盘空间不足等）。

使用方法和配置说明

前置条件

• 目标主机需运行 Linux 系统（内核版本 ≥ 3.10）。
• 容器运行时需支持挂载主机目录（如 Docker、containerd）。

基本使用（Docker Run）

通过 docker run 命令启动容器，需映射端口并挂载必要的主机目录以获取系统指标：

bash
docker run -d \
  --name node-exporter \
  --net=host \  # 推荐使用主机网络，避免端口映射冲突（可选，若不使用需显式映射端口）
  -p 9100:9100 \  # 暴露指标端口（默认 9100）
  -v /proc:/host/proc:ro \  # 挂载主机 /proc 目录（只读，获取进程、CPU 等指标）
  -v /sys:/host/sys:ro \    # 挂载主机 /sys 目录（只读，获取内核、设备等指标）
  -v /:/rootfs:ro \         # 挂载主机根目录（只读，获取文件系统等指标）
  linuxkit/node-exporter:latest \
  --path.procfs=/host/proc \  # 指定 procfs 路径（容器内对应主机 /proc）
  --path.sysfs=/host/sys \    # 指定 sysfs 路径（容器内对应主机 /sys）
  --collector.filesystem.mount-points-exclude=^/(sys|proc|dev|host|etc)($|/)  # 排除非必要挂载点

参数说明：

• --net=host：使用主机网络模式时，容器直接使用主机网络栈，无需端口映射，适合需要访问主机网络信息的场景。
• 挂载目录说明：
  • /proc：提供进程、CPU、内存等运行时数据（必需）。
  • /sys：提供内核设备、驱动、电源等信息（必需）。
  • /rootfs：提供文件系统挂载点信息（可选，用于文件系统容量监控）。
• 采集器配置：通过 --collector.<name> 启用/禁用采集器，例如 --no-collector.ipvs 禁用 IPVS 采集器，--collector.processes 启用进程采集器。

Docker Compose 配置示例

若需通过 Docker Compose 管理，可参考以下配置：

yaml
version: '3'
services:
  node-exporter:
    image: linuxkit/node-exporter:latest
    container_name: node-exporter
    restart: always
    ports:
      - "9100:9100"
    volumes:
      - /proc:/host/proc:ro
      - /sys:/host/sys:ro
      - /:/rootfs:ro
    command:
      - --path.procfs=/host/proc
      - --path.sysfs=/host/sys
      - --collector.filesystem.ignored-mount-points=^/(sys|proc|dev|host|etc)($|/)
    network_mode: "host"  # 可选，根据网络需求调整

指标访问与验证

容器启动后，可通过 http://<主机IP>:9100/metrics 访问指标接口，返回内容为 Prometheus 格式的指标数据（如 node_cpu_seconds_total、node_memory_MemAvailable_bytes 等）。

注意事项

1. 权限控制：容器需以足够权限挂载主机目录（通常无需特权模式，但需确保挂载路径的读权限）。
2. 采集器性能影响：部分采集器（如 processes、ntp）可能增加主机资源开销，建议仅启用必要采集器。
3. 版本兼容性：本镜像版本与 LinuxKit 项目同步，使用时需注意与 Prometheus Server 版本兼容（推荐 Prometheus Server ≥ 2.0）。