php-fpm状态页暴露失败最常见原因是nginx将/status路径当作静态路径拦截或fastcgi参数缺失；promphp/client_php指标为空多因响应头缺失version=0.0.4、gmp扩展未启用或/metrics中执行耗时操作；直方图指标查不到主因是label含非法字符或buckets未显式定义。
php-fpm状态页暴露失败：curl能通但Prometheus抓不到
最常见的情况是Nginx把/status或/phpfpm_status当成静态路径拦截了，或者FastCGI参数没传全。Prometheus抓取失败时，Targets页面显示DOWN，但curl http://localhost/status?json返回正常——这说明Web层通，但指标格式或路由逻辑有问题。
- 确认Nginx
location块里包含fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;，漏掉这行会导致PHP-FPM找不到入口脚本，静默返回空响应 - 检查
pm.status_path值是否和Nginx中location路径完全一致（比如配置的是/status，但Nginx写了/phpfpm_status） - 用
curl -v http://localhost/status?json看响应头，必须含Content-Type: application/json；若返回text/html，说明PHP-FPM没启用JSON格式，需加?json参数且确保URL被正确转发 - 禁止在Nginx中对
/status使用try_files或alias，它们会绕过FastCGI直接找文件
promphp/client_php指标为空：/metrics返回空或500
/metrics端点返回空不是因为没注册指标，而是执行流程中途退出或序列化失败。Prometheus客户端不报错，但curl http://localhost/metrics只看到# HELP开头的空行，或直接500，基本可锁定为初始化或渲染阶段的问题。
-
require __DIR__ . '/vendor/autoload.php';必须放在脚本最开头，任何前置输出（如BOM、空格、echo）都会破坏text/plain响应头 - 必须显式设置响应头：
header('Content-Type: text/plain; version=0.0.4');，缺version=0.0.4会导致Prometheus解析失败 - 避免在
/metrics脚本里做耗时操作：删掉所有file_get_contents、DB查询、缓存读写；加set_time_limit(3)防超时 - 检查
gmp扩展是否启用：php -m | grep gmp，缺失则CollectorRegistry构造失败，整个脚本中断无提示
Grafana面板查不到php_video_encode_seconds等自定义指标
直方图类指标（如php_video_encode_seconds_bucket）在Grafana里查不到，90%是因为label值含非法字符或bucket未显式定义。Prometheus会静默丢弃整条指标，不报错也不记录。
- label值不能含
/、?、=、空格——例如视频路径/videos/123.mp4要归一化为video_id="123"，别直接用$_GET['path'] -
observe()传入值必须是秒级浮点数：$histogram->observe($duration_ms / 1000)，传毫秒或整数会导致bucket匹配失败 - 必须手动定义
buckets：new Histogram(..., ['le' => [0.1, 0.5, 1.0, 2.0, 5.0]])，依赖默认bucket（0.005~10秒）在视频处理场景下基本无效 - 确认Prometheus配置中
job_name和targets指向正确端口，且metrics_path是/metrics而非/status
视频处理任务卡住时，如何关联GPU与PHP指标
单看PHP指标只能知道“编码慢”，但无法区分是CPU瓶颈还是GPU卡死。必须把php_video_encode_seconds和DCGM_FI_DEV_GPU_UTIL（GPU利用率）画在同一张图上，才能定位根因。
- 在Prometheus配置中，
job_name要分开：一个抓PHP应用的/metrics，一个抓nvidia/dcgm-exporter暴露的:9400/metrics - Grafana里建两个Y轴：左轴用
rate(php_video_encode_seconds_count[5m])看QPS，右轴用DCGM_FI_DEV_GPU_UTIL{gpu="0"}看GPU占用 - 当编码耗时突增+GPU利用率跌到0%，大概率是CUDA context丢失或驱动异常；若GPU利用率持续95%+，则是显存不足或内核阻塞
- 别忽略
php_fpm_process_state指标：如果大量进程卡在Idle状态，说明PHP-FPM worker被视频解码阻塞，需调大pm.max_children
真实环境里，视频处理的监控难点不在埋点本身，而在指标语义对齐——比如“编码完成”和“GPU kernel结束”之间存在毫秒级时间差，Prometheus默认15s抓取间隔会抹平这个细节。需要把php_video_encode_seconds_sum和DCGM_FI_DEV_MEM_COPY_UTIL做irate()聚合，才能看清瞬时毛刺。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
