php prometheus有哪些用法？看这篇了解基础与进阶操作

发布日期： 2025-10-12 阅读量： 作者： admin

最近在琢磨我们那个PHP项目，跑的时间长了，有时候感觉不太对劲，但是看日志又看不出个所以然来，就想着得弄个监控，把里面的情况给量化出来看看。

寻寻觅觅

之前也用过一些简单的日志分析或者服务器自带的监控，但总觉得不够细。听圈里人聊，说现在Prometheus挺火，搞监控和报警都挺方便。我看它是 Go 写的，感觉性能应该还行，而且看介绍主要是拉（pull）数据，好像接入也比较灵活。

那就定了，试试用 Prometheus 来监控我们的 PHP 应用。接下来的问题就是，PHP 这边怎么把数据给 Prometheus ？肯定得有个啥客户端库之类的。

找到工具

上网搜了搜，果然有现成的 PHP 库可以用。看了几个，选了个看起来用的人多、文档也还算清楚的。名字就不具体说了，反正 composer 一装就行，PHP 这点还是挺方便的。

主要目标就是能在代码里方便地记录一些我想看的数据，比如接口请求次数、处理时长、队列长度啥的。

开始动手

先把那个库通过 composer 给装到项目里。这步没啥好说的，就 `composer require` 一下。

然后就得找个地方初始化这玩意儿。我寻思着不能到处乱初始化，就在项目的服务容器启动或者一个基础控制器里弄了。主要是配置一下存储方式，我看有 APcu、Redis、或者就内存的。考虑到我们 PHP 进程跑完就释放，用内存好像不太行，APcu 感觉也不是所有环境都稳，还是决定用 Redis 来存这些计数器、仪表盘（Gauge）啥的中间数据，感觉靠谱点。

接下来就是定义我想监控的指标了：

请求计数器 (Counter)：想统计某个接口被调了多少次。
处理时长直方图 (Histogram)：想看看接口响应时间的分布情况，哪些快哪些慢。
在线用户数仪表盘 (Gauge)：实时看看当前大概有多少用户在线。

定义这些指标的代码，我也集中放一个地方管理，没让它散得到处都是。

接入代码

定义好指标之后，就得在代码的实际运行路径上加上记录的代码了。

比如，在处理某个 API 请求的入口和出口：

请求进来时，对应的请求计数器加 1。
开始处理前记个时间戳。
处理完成后，用当前时间减去开始时间，得到处理耗时，然后把这个耗时记录到处理时长直方图里。

对于在线用户数仪表盘，可能就在用户登录成功时增加数值，退出或者 session 过期时减少数值。这个稍微麻烦点，得找准地方。

这些记录的代码写起来倒不复杂，就是 `->inc()` (增加计数) 或者 `->set()` (设置数值) 或者 `->observe()` (记录观察值) 这几个方法调一下。

暴露数据

光记录了还不行，得让 Prometheus 能读到。这就需要提供一个 HTTP 接口，访问这个接口时，那个 PHP 库能把所有指标的当前值按照 Prometheus 要求的那种文本格式给打印出来。

我在项目里加了个新的路由，比如 `/metrics`。访问这个地址的时候，就调用那个库提供的方法，把收集到的所有指标数据渲染出来，直接输出。这个页面没别的，就是纯文本，给机器看的。

然后在 Prometheus 的配置文件里，加上我们这个 PHP 应用的 `/metrics` 地址，让 Prometheus 定期来抓就行了。

效果

配置好之后，等了一小会儿，去 Prometheus 的 Web 界面就能搜到我定义的那些指标了！也能在 Grafana 里画出各种图表。

感觉挺爽的，终于能直观地看到接口调用量、响应时间分布这些以前只能靠猜或者翻日志才能大概了解的东西了。特别是那个直方图，能很清楚地看到 P99、P95 耗时，对优化性能很有帮助。

这回折腾 PHP 接 Prometheus 还是挺值的。虽然中间也踩了点小坑，比如选哪种存储适配器、怎么在 FPM 这种模式下正确聚合数据，但效果达到了预期。现在对系统内部状态的把握，比以前清楚多了。

上一篇: 还在纠结选哪个？一文搞懂云主机与云服务器！

下一篇: 想买个香港云服务器多少钱？最新价格表及配置参考！

php prometheus有哪些用法？看这篇了解基础与进阶操作

随便看看