prometheus

云原生监控告警，一站式搞定指标采集、查询与报警

开源基础设施

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 66523

维护状态活跃

是否开源是

定价模式

项目预览

项目数据

分类基础设施

开发团队prometheus

所属国家

官网地址https://prometheus.io

GitHubhttps://github.com/prometheus/prometheus

定价模式

价格说明

访问状态

是否开源是

开源协议Apache-2.0

主要语言Go

技术栈/模型alerting,graphing,hacktoberfest,metrics,monitoring,prometheus,time-series

GitHub 星标★ 66523

30天Star增速

HF 下载量

上线时间2012-11-24 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-29

浏览次数5

项目介绍

Prometheus 是一个开源的系统监控和告警工具包，最初由 SoundCloud 开发，现为 CNCF 的毕业项目。它解决了在动态云原生环境中收集、存储和查询指标数据的问题，尤其擅长处理微服务和容器化架构的监控需求。其核心能力包括：基于拉取模型的数据采集，支持通过 HTTP 接口暴露指标；内置高效的时间序列数据库，支持强大的 PromQL 查询语言，用于聚合和分析数据；灵活的告警规则定义，可与 Alertmanager 集成实现告警通知。此外，它还提供了服务发现机制，能自动发现 Kubernetes、Consul 等环境中的目标，以及丰富的 Exporters 生态，用于监控数据库、中间件等第三方系统。Prometheus 的架构简单可靠，每个服务器独立运行，不依赖分布式存储，非常适合作为云原生监控的标准方案。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 10 分钟部署方式：Docker 4 步

环境要求

Docker 已安装并可以正常拉取镜像
网络可访问 Docker Hub 或 Quay.io 镜像仓库
本机 9090 端口未被其他程序占用
（仅本地构建镜像时需要）Go 环境与 make 工具链

安装与启动步骤

1拉取并启动容器

一条命令即可试用 Prometheus，容器名为 prometheus，仅绑定本机 127.0.0.1 的 9090 端口，更安全。
```
docker run --name prometheus -d -p 127.0.0.1:9090:9090 prom/prometheus
```
2确认容器在运行

查看容器状态是否为 Up，若为 Exited 可用 docker logs prometheus 查看报错原因。
```
docker ps --filter name=prometheus
```
3打开 Web 界面

浏览器访问 http://localhost:9090/ 即可看到 Prometheus 自带的查询与图表界面。
4本地构建镜像（可选）

在 Prometheus 源码目录中执行，先构建 promu 再交叉编译出 linux 二进制，最后打成本架构镜像。
```
make promu
promu crossbuild -p linux/$(go env GOHOSTARCH)
make common-docker-current-arch
```

关键配置

配置项	必填	说明	示例
`-p 127.0.0.1:9090:9090`	是	把容器内 9090 端口映射到本机，缺失则无法访问 Web UI	`-p 127.0.0.1:9090:9090`
`--name prometheus`	否	指定容器名称，便于后续启停和查看日志	`--name prometheus`

如何确认成功

浏览器打开 http://localhost:9090/ 能显示 Prometheus 界面，且 docker ps 中容器状态为 Up。

常见问题

Q：容器启动后访问 localhost:9090 打不开？

A：先确认 docker ps 中容器处于 Up 状态，再用 docker logs prometheus 查看日志；若端口被占用，可改用 -p 127.0.0.1:9091:9090 换个本机端口。

Q：为什么本地执行 make docker 构建出的镜像不能用？

A：README 明确说明 make docker 只用于官方 CI 系统，本地运行不会产出完整可用的镜像，应改用 make common-docker-current-arch。

Q：怎么构建其他 CPU 架构的镜像？

A：把命令中的 $(go env GOHOSTARCH) 换成 Makefile.common 里 DOCKER_ARCHS 列出的架构（如 amd64），并执行对应的 make common-docker- 目标。

Q：有非 Docker 的安装方式吗？

A：README 提到提供预编译二进制包和多种安装方式，具体下载地址与步骤请以官网 prometheus.io 的文档为准。

注意事项

本次 README 节选中的安装章节不完整（预编译二进制部分被截断），相关细节请查阅官网文档。
默认 Web 端口为 9090，示例刻意只绑定 127.0.0.1，如需外部访问请自行调整端口映射。
make docker 目标仅供官方 CI 使用，本地请勿用它来产出可用镜像。

核心亮点

PromQL 查询语言强大，支持多维数据模型和复杂聚合，分析效率高
基于拉取模型和本地存储，部署简单，单节点即可稳定运行
与 Kubernetes 深度集成，服务发现和监控配置自动化程度高

不足之处

本地存储水平扩展能力有限，长期数据持久化需依赖外部存储如 Thanos
告警配置和规则管理在大型集群中维护成本较高，文档/社区待观察

适用场景

Kubernetes 容器平台监控，采集 Pod、节点和应用指标
微服务架构的黄金信号监控，如请求量、错误率、延迟
传统 IT 基础设施监控，通过 Node Exporter 等采集主机指标

替代项目

Grafana Mimir、VictoriaMetrics、Thanos

上一篇：grafana

下一篇：jellyfin