Prometheus 提供了一套稳定的 HTTP API,默认挂载在 /api/v1 下,用于查询指标、发现序列、查看目标与规则、读取状态以及执行 TSDB 管理操作。
本文基于 Prometheus 3.x 重写,覆盖通用响应格式、查询/元数据/状态/管理 API、客户端调用、错误处理、安全与版本差异。最后复核时间:2026-10。
API 默认没有认证。生产环境必须通过反向代理、
--web.config.file、网络策略等方式保护,尤其不要暴露/-/reload、/-/quit和 TSDB 管理接口。
Prometheus 是 CNCF 毕业项目,最初由 SoundCloud 开发,现已成为云原生指标监控的事实标准。它负责采集、存储、查询指标并触发告警,通常与 Grafana、Alertmanager、Exporter 和 Kubernetes 生态一起使用。
本文基于 Prometheus 3.x 重写,覆盖核心架构、数据模型、配置、PromQL、告警、Kubernetes 落地、生产容量、高可用、安全、自监控和 3.x 升级。最后复核时间:2026-10。
Prometheus 专注指标(metrics),不替代日志(Loki/ELK)和链路追踪(Tempo/Jaeger)。它也不是计费级精确系统,采集丢失、重启和网络分区都可能造成数据缺口。