可观测性与稳定性 / 系统课时

把 Linux 主机加入 Prometheus

把 Linux 主机加入 Prometheus

本节把一台 Linux 主机变成可被 Prometheus 持续抓取的监控目标:先运行 Node Exporter 暴露主机指标,再配置 scrape target,最后确认目标状态为 UP。

学习目标

  • 在 Linux 主机上启动并验证 Node Exporter
  • 把 Node Exporter 的 /metrics 端点加入 Prometheus
  • 用配置校验与 Target 状态确认采集链路可用

先让主机暴露指标

Node Exporter 从 Linux 内核和系统接口读取 CPU、内存、磁盘、网络等主机指标,并通过 HTTP 暴露给 Prometheus。官方 Node Exporter 默认监听 9100 端口,因此 Prometheus 实际抓取的是 http://<HOST>:9100/metrics。 ([GitHub][1])

下面以 Debian/Ubuntu 为例安装发行版提供的 Node Exporter 软件包。不同发行版的软件包名可能不同,但后续验证方式一致。

bash
sudo apt update
sudo apt install -y prometheus-node-exporter
sudo systemctl enable --now prometheus-node-exporter
systemctl is-active prometheus-node-exporter
curl -fsS http://127.0.0.1:9100/metrics >/dev/null && echo "metrics endpoint ok"

预期输出

text
active
metrics endpoint ok

如果服务已启动但 Prometheus 位于另一台机器,还要确保服务器防火墙、安全组或网络 ACL 允许 Prometheus 到该主机 9100/TCP 的访问。不要为了方便把端口直接暴露给整个公网。

Node Exporter 到 Prometheus 的抓取链路

把主机加入 scrape 配置

Prometheus 的 scrape_configs 用来定义抓取任务;静态主机可以放在 static_configs.targets 中。job_name 会成为抓取样本默认的 job 标签。([普罗米修斯][2])

在现有 prometheus.yml 的 scrape_configs 下加入以下任务。<HOST> 必须替换为 Prometheus 服务器能够访问到的主机 IP 或 DNS 名称,而不是 Node Exporter 主机自己的 127.0.0.1。

yaml
scrape_configs:
  - job_name: linux-node
    scrape_interval: 15s
    static_configs:
      - targets:
          - "<HOST>:9100"
        labels:
          role: linux

这段配置生效后,Prometheus 会按 15s 周期抓取该端点。若文件里已经有其他 scrape_configs,只追加新的 - job_name: linux-node 项,不要再创建第二个顶层 scrape_configs。

校验并重新加载配置

先用 promtool 检查 YAML 和 Prometheus 配置语义,再向 Prometheus 主进程发送 SIGHUP。官方文档说明 SIGHUP 可以触发运行时配置重载;错误配置不会被应用。([普罗米修斯][2])

bash
if promtool check config /etc/prometheus/prometheus.yml >/dev/null; then
  echo "config ok"
fi
sudo kill -HUP "$(pgrep -x prometheus)"
echo "reload signal sent"

预期输出

text
config ok
reload signal sent

如果你的 Prometheus 配置文件不在 /etc/prometheus/prometheus.yml,把路径替换为实际 <PATH>。若 Prometheus 不是以本机进程方式运行,应使用对应部署方式执行配置校验和重载,而不是照搬 pgrep。

确认 Target 真正可抓取

打开 Prometheus 的 Targets 页面,找到 job="linux-node" 对应实例。健康状态应为 UP;也可以在查询页执行 up{job="linux-node"},目标正常时该时间序列的值为 1。

如果状态为 DOWN,按链路从近到远检查:Node Exporter 服务是否存活、9100 是否监听、Prometheus 主机能否访问 <HOST>:9100/metrics、配置中的主机名和端口是否正确。只有 Target 变成 UP,后续 CPU、内存和磁盘指标分析才有可靠数据源。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

把 Linux 主机加入 Prometheus

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通