首页/云/可观测性速查/Agent 模式:只采集与远程写
Prometheus 与采集64 条

Agent 模式:只采集与远程写

通过特性开关让 Prometheus 以 agent 形态运行:不提供本地查询、不评估规则,只抓取并 remote_write,适合边缘节点或大规模分层汇聚场景。

可观测性速查云更新于 2026-10-12

启动方式

启动方式
prometheus --enable-feature=agent \
  --config.file=prometheus.yml

# prometheus.yml 保留抓取与远程写,例如
remote_write:
  - url: https://central.example.com/api/v1/write
本地能力仅 WAL 缓存用于远程写重试与断点续传,无查询与告警
典型场景边缘集群、多机房分层汇聚到中心 Prometheus
切换注意依赖本地查询接口与本地告警的脚本、看板要迁移到中心端
agent 与常规模式是同一二进制不同启动参数,回退时去掉特性开关即可。

易错点

  • agent 模式没有查询接口,数据源必须指向中心端,Grafana 直连它会查询失败
  • 断网时间超过 WAL 能容纳的量后早期数据会丢失,边缘网络稳定性与 WAL 大小要匹配

数据来源与参考

  • Prometheus 文档 · agent mode
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌