php 8.6应用接入prometheus时,应让业务worker把指标写入共享存储,再由独立metrics入口输出prometheus文本格式。这里使用redis聚合多个worker的计数;每次请求新建内存存储,无法得到跨请求累计值。

官方文档:Usage
准备库与Redis扩展
composer require promphp/prometheus_client_php:^2.15 php --ri redis composer check-platform-reqs
业务进程和metrics入口必须连接同一个Redis实例、使用相同前缀,并确保所用PHP 8.6运行入口已加载对应扩展。Redis只在应用可信网络中使用,不直接向公网开放。

官方文档:Advanced Usage
共用注册器并暴露拉取入口
<?php // metrics-bootstrap.php
require __DIR__ . '/vendor/autoload.php';
use Prometheus\CollectorRegistry;
use Prometheus\Storage\Redis;
Redis::setDefaultOptions([
'host' => '127.0.0.1', 'port' => 6379,
'password' => getenv('METRICS_REDIS_PASSWORD') ?: null,
'timeout' => 0.5, 'read_timeout' => 1,
'persistent_connections' => false,
]);
return new CollectorRegistry(new Redis());
<?php // 在业务任务成功完成的位置调用
$registry = require __DIR__ . '/metrics-bootstrap.php';
$registry->getOrRegisterCounter('app', 'jobs_total', 'Completed jobs', ['kind'])
->inc(['export']);
<?php // metrics.php,只允许监控服务器访问
use Prometheus\RenderTextFormat;
$registry = require __DIR__ . '/metrics-bootstrap.php';
header('Content-Type: ' . RenderTextFormat::MIME_TYPE);
echo (new RenderTextFormat())->render($registry->getMetricFamilySamples());
Prometheus的scrape配置指向metrics.php。指标名称、说明和标签名称必须一致,标签值采用有限集合,例如export、sync,而不是用户ID或完整请求URL。
检查跨进程累计与访问边界
分别通过两个Worker完成任务,再拉取metrics,确认app_jobs_total按kind聚合,而不是每次重新从零开始。监控入口只读取指标,不要在拉取时再增加业务任务计数。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
Redis不可用时需要确定业务降级策略,避免监控采集故障直接拖垮关键请求。直方图适合延迟分布,但桶和标签会放大存储量,应按实际观察目标配置,不为每个请求创建一组新指标。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










