website

Prometheus Docs

所属分类:开发者在线工具箱

Prometheus 官方文档:概念说明、服务器配置与 Go 应用埋点指南

Prometheus 官方文档是开源监控与告警工具 Prometheus 的手册,按介绍、概念、服务器、可视化、埋点、运维、告警和规范等分组组织。读者可以先读概览,了解它的数据模型和查询语言,再按任务进入安装配置、客户端库或具体指南。

Prometheus 官方文档:了解监控与告警工具的概念,并为 Go 应用添加指标

发布于 2026年10月18日更新于 2026年10月29日

概览页说明了什么

概览页称 Prometheus 是一个开源的系统监控与告警工具,最初在 SoundCloud 构建,自 2012 年起发展,2016 年成为 Cloud Native Computing Foundation 的第二个托管项目,仅次于 Kubernetes。它把指标保存为时间序列数据,每个数据点带有记录时的时间戳,以及可选的键值标签。

主要功能

概览页列出的功能包括:多维数据模型,用指标名和键值对标识时间序列;灵活的查询语言 PromQL;单个服务器节点可以自治,不依赖分布式存储;通过 HTTP 以拉取(pull)模型采集数据;通过中间网关支持推送(push);通过服务发现或静态配置找到采集目标;以及多种图形与仪表盘显示方式。

Prometheus 文档概览页,左侧为完整目录,右侧为“What is Prometheus?”小节和该工具的主要功能列表

文档目录的分组

左侧目录包括 Introduction、Concepts、Prometheus Server、Visualization、Instrumenting、Operating、Alertmanager、Best practices、Guides、Tutorials 和 Specifications。其中 Querying 分组下有 Basics、Operators、Functions、Examples 和 HTTP API 等页面,Specifications 分组则列出 Native Histograms、OpenMetrics 与 Remote Write 的版本页面。

为 Go 应用添加指标

“Instrumenting a Go application for Prometheus”指南先用 go get 安装 prometheus、promauto 和 promhttp 三个客户端库包,然后在应用中暴露一个 /metrics 的 HTTP 端点,并把 promhttp 库提供的 Handler 作为处理函数。示例程序会在 localhost 的 2112 端口上提供 Go 应用的默认指标。

Prometheus 文档指南页“Instrumenting a Go application for Prometheus”,正文为安装 Go 客户端库的 go get 命令,并说明 /metrics 端点与示例程序代码

版本与其他参考

目录中还有 Migration、API stability 和 Feature flags 等页面,以及 Command Line 下的 prometheus 与 promtool 两个命令行参考。