服务器如何部署Prometheus node_exporter并验证主机指标可被采集?

发布人:A5数据发布时间:2026-11-04 15:19阅读量:62

要让服务器的主机指标进入 Prometheus,需要完成两段链路:在被监控服务器上运行 node_exporter,使其提供 /metrics;再让 Prometheus 定期访问该地址。部署完成后,既要确认接口能返回主机指标,也要确认 Prometheus 中的目标状态为 UP,仅看到进程正在运行还不够。

引言配图

以下以运行 systemd 的 Debian 12、Ubuntu 22.04/24.04 服务器为例。被监控服务器使用示例内网地址 10.0.0.12,Prometheus 服务器使用 10.0.0.20;执行前须替换为实际地址。示例安装 node_exporter 1.8.2 的 Linux amd64 包,其他架构不能直接套用文件名。

围绕主机监控与基础设施运维场景,A5idc数据提供中国香港、美国、日本、韩国、中国台湾、新加坡、马来西亚等地区的物理服务器资源,覆盖常规建站、AMD计算、存储、多IP及不同带宽线路配置,可为Prometheus与node_exporter部署提供多地域主机、CPU、内存、NVMe存储和网络资源基础,适配网站、后台、数据库及多任务业务的指标采集环境。

准备条件:确认安装位置和采集链路

先在被监控服务器确认系统架构、内网地址,以及端口和文件路径是否已被占用:

uname -m
ip -br -4 addr
ss -lnt | grep ':9100'
test -e /usr/local/bin/node_exporter && echo '二进制文件已存在'
test -e /etc/systemd/system/node_exporter.service && echo '服务文件已存在'

本文的下载文件适用于 uname -m 返回 x86_64 的服务器。如果返回 aarch64,应改用对应的 Linux arm64 发布包,并核对下载文件名;不要在不匹配的架构上继续安装。如果 9100 端口或目标文件已被使用,先查明现有服务,避免覆盖已有部署。

还需要满足以下条件:

  • 被监控服务器能够获取 node_exporter 发布包及校验文件,或已从可信渠道将两者传入服务器。
  • Prometheus 服务器能够访问被监控服务器的内网地址和 TCP 9100 端口。若有云平台安全组、主机防火墙,应仅对 Prometheus 的来源地址开放所需访问,不必向公网开放 9100。
  • 若要按下文加入采集任务,需具备修改 Prometheus 配置及重载或重启服务的权限。先确认它实际使用的配置文件,而不是仅凭路径猜测。

安装 node_exporter 并检查可执行文件

在被监控服务器下载固定版本的发布包及校验文件。以下命令在同一个 shell 中顺序执行,失败时不要继续安装:

set -e
VERSION=1.8.2
PACKAGE="node_exporter-${VERSION}.linux-amd64.tar.gz"
WORK="$(mktemp -d)"
BASE_URL="https://github.com/prometheus/node_exporter/releases/download/v${VERSION}"

curl -fL "${BASE_URL}/${PACKAGE}" -o "${WORK}/${PACKAGE}"
curl -fL "${BASE_URL}/sha256sums.txt" -o "${WORK}/sha256sums.txt"

grep -E "^[0-9a-f]{64} [ *]${PACKAGE}$" \
  "${WORK}/sha256sums.txt" > "${WORK}/selected.sha256"
test "$(wc -l < "${WORK}/selected.sha256")" -eq 1
(cd "${WORK}" && sha256sum -c selected.sha256)

预期最后一行包含 OK。校验失败或找不到对应条目时,应停止安装,重新核对版本、架构和文件来源;不要跳过校验后继续解压。随发布包提供的校验值可用于发现文件不匹配或传输损坏,但不能代替对下载来源本身的核实。

确认前述目标路径没有已有文件后,解压并安装二进制文件:

tar -xzf "${WORK}/${PACKAGE}" -C "${WORK}"
sudo install -o root -g root -m 0755 \
  "${WORK}/node_exporter-${VERSION}.linux-amd64/node_exporter" \
  /usr/local/bin/node_exporter

/usr/local/bin/node_exporter --version

版本输出应与下载版本一致。install 会写入 /usr/local/bin/node_exporter;如果准备检查时发现该路径已有文件,应先备份并确认其归属,不要用此命令直接覆盖。临时目录路径保存在当前 shell 的 WORK 变量中,可在完成验收后按实际路径清理,不影响服务运行。

配置 systemd 服务并验证本机接口

node_exporter 本身不需要填写 Prometheus 地址,它只负责提供指标。本例让它监听被监控服务器的内网地址,而不是所有网络接口。写服务文件前,再确认 10.0.0.12 已替换为该服务器实际持有的地址,且服务文件此前不存在:

sudo tee /etc/systemd/system/node_exporter.service >/dev/null <<'EOF'
[Unit]
Description=Prometheus Node Exporter
After=network-online.target
Wants=network-online.target

[Service]
DynamicUser=yes
ExecStart=/usr/local/bin/node_exporter --web.listen-address=10.0.0.12:9100
Restart=on-failure
RestartSec=5s
NoNewPrivileges=true

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable --now node_exporter
systemctl status node_exporter --no-pager

DynamicUser=yes 让 systemd 为该服务分配运行身份,无须为本次部署额外创建系统用户。预期状态为 active (running)。随后在被监控服务器检查监听地址及 HTTP 响应:

ss -lnt | grep ':9100'
curl -fsS -o /dev/null -w 'HTTP %{http_code}\n' \
  http://10.0.0.12:9100/metrics
curl -fsS http://10.0.0.12:9100/metrics \
  | grep '^node_uname_info{'

预期可以看到 10.0.0.12:9100 处于监听状态、HTTP 状态码为 200,并返回一行以 node_uname_info{ 开头的指标。命令中的指标内容随主机而变化,不能将示例中的地址或输出当作实际采集结果。

这里有一个重要区别:/metrics 返回 200 表明 exporter 已在提供指标,不代表 Prometheus 已经采集成功。下一步必须从 Prometheus 所在位置检查连通性,并加入采集目标。

在 Prometheus 中加入采集目标

先在Prometheus 服务器测试到 exporter 的访问:

curl -fsS -o /dev/null -w 'HTTP %{http_code}\n' \
  http://10.0.0.12:9100/metrics

预期同样为 HTTP 200。若本机访问成功、此处失败,应先检查地址、路由、安全组和主机防火墙;不要急于修改 Prometheus 配置。

以下以 Prometheus 由 systemd 管理、配置文件位于 /etc/prometheus/prometheus.yml 为例。先用 systemctl cat prometheus 确认实际启动参数和配置路径,并用 command -v promtool 确认配置检查工具可用。若安装方式不同,应使用该实例实际的配置位置与管理方式。

修改前备份配置,并记下输出的备份路径:

BACKUP="/etc/prometheus/prometheus.yml.bak.$(date +%Y%m%d%H%M%S)"
sudo cp -a -- /etc/prometheus/prometheus.yml "$BACKUP"
printf '配置备份:%s\n' "$BACKUP"

在现有 prometheus.yml 的 scrape_configs: 下增加一个任务,不要再创建第二个同名顶层键,也不要覆盖已有任务。新增内容示例如下:

  - job_name: node_exporter_host
    static_configs:
      - targets: ['10.0.0.12:9100']

它应与现有的 - job_name 条目处于相同缩进层级。保存后先检查配置:

promtool check config /etc/prometheus/prometheus.yml

只有检查通过才应用配置。若当前实例没有已确认可用的配置重载方式,可通过重启 systemd 服务应用;这会短暂中断该 Prometheus 实例的采集,应安排合适的操作时间,并留意其他采集任务的影响:

sudo systemctl restart prometheus
systemctl status prometheus --no-pager

若配置检查失败,不要重启;根据 promtool 指出的行号修正缩进、重复键或条目格式。若重启后服务未正常运行,优先查看服务日志,并使用刚保存的配置备份恢复。

确认指标真正进入 Prometheus

等待至少一个采集间隔后,在Prometheus 服务器检查目标状态。若 Prometheus 的本地 HTTP 地址不是 127.0.0.1:9090,请换成实际地址:

curl -fsS -G \
  --data-urlencode 'query=up{job="node_exporter_host",instance="10.0.0.12:9100"}' \
  http://127.0.0.1:9090/api/v1/query

预期响应的 result 非空,且其中的值为 "1"。也可在 Prometheus 的 Targets 页面查看 node_exporter_host:目标应处于 UP,并且最近一次采集错误为空。up 是 Prometheus 根据采集结果生成的指标,不是 exporter 在 /metrics 中自行输出的指标。

再查询一项主机指标,避免只凭目标状态判断:

curl -fsS -G \
  --data-urlencode 'query=node_uname_info{job="node_exporter_host",instance="10.0.0.12:9100"}' \
  http://127.0.0.1:9090/api/v1/query

预期 result 非空。到这一步,才同时验证了“exporter 提供指标”和“Prometheus 将主机指标采入自身”。

首次部署时按结果排查

排查应从服务和网络开始,再检查采集配置,避免通过反复重启掩盖原因。

观察结果优先检查结果含义与处理
node_exporter 不是 active (running)journalctl -u node_exporter -n 50 --no-pager、ip -br -4 addr、`ss -lntgrep ':9100'`
被监控服务器本机访问 /metrics 失败服务状态、实际监听地址、URL 中的 IP 和端口本机都无法访问时,先修正 exporter 启动或监听配置,检查远端网络没有意义。
本机返回 200,Prometheus 服务器访问失败两端地址、路由、安全组、主机防火墙通常是链路或访问控制问题。仅为 Prometheus 来源地址放通所需端口,并按所用防火墙的规则备份与回滚流程操作。
远端访问返回 200,但 Targets 中没有该目标Prometheus 实际配置文件、scrape_configs 缩进、配置是否已应用表明 exporter 链路可用,但采集任务可能未加载。先运行 promtool check config,再核对服务启动参数。
目标出现但为 DOWNTargets 中的最近一次错误、目标地址、采集时的网络可达性按具体报错区分连接超时、连接拒绝等情况;不要仅依据本机一次 curl 成功判断采集时持续可达。
up 为 1,预期主机指标却为空指标名、查询标签、/metrics 实际输出先从 exporter 输出核对指标是否存在,再检查查询是否附加了不匹配的标签。

验收与回滚检查项

本次部署可以按以下项目验收:

  • 被监控服务器的 node_exporter 服务处于运行状态,且仅在计划使用的地址和端口监听。
  • 被监控服务器与 Prometheus 服务器访问 /metrics 均返回 HTTP 200。
  • Prometheus 中对应目标为 UP,up{job="node_exporter_host",instance="10.0.0.12:9100"} 的值为 1。
  • 至少一项主机指标查询得到结果;9100 端口的访问范围符合预先确定的网络策略。

需要回滚时,先从 Prometheus 配置中移除本次新增的任务,并通过 promtool check config 检查后应用。若打算直接恢复备份,须先确认备份以来没有其他配置变更;恢复整个文件会覆盖期间的修改。之后在被监控服务器停止并禁用服务:

sudo systemctl disable --now node_exporter
systemctl status node_exporter --no-pager

确认该服务文件和二进制文件确为本次新建、没有其他服务依赖后,可将它们移出原路径留存,而不是直接删除:

sudo mv /etc/systemd/system/node_exporter.service \
  /etc/systemd/system/node_exporter.service.disabled
sudo mv /usr/local/bin/node_exporter \
  /usr/local/bin/node_exporter.disabled
sudo systemctl daemon-reload

回滚后检查 9100 端口不再由该服务监听,Prometheus 中不再保留此次新增的采集任务。若这些路径在部署前已有文件,则不适用上述移动命令,应按部署前记录和备份分别恢复。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/7530.html

相关推荐