当前位置：首页 > news >正文

PHP 可观测性的庖丁解牛

news 2026/7/4 8:56:19

PHP 可观测性（Observability）不是简单的“加日志”，而是通过结构化数据（Logs、Metrics、Traces）构建系统行为的可推理模型，使开发者能在不重启、不登录服务器的情况下，精准定位性能瓶颈与故障根因。

一、可观测性三大支柱

支柱	作用	PHP 实现方式
Logs（日志）	记录离散事件（如错误、请求）	Monolog + JSON 格式
Metrics（指标）	聚合统计（如 QPS、内存使用率）	Prometheus client + OPcache stats
Traces（链路追踪）	跟踪请求全链路（跨服务调用）	OpenTelemetry + Jaeger

💡核心认知：
可观测性 = Logs（发生了什么） + Metrics（整体状态如何） + Traces（具体路径怎样）

二、PHP 原生能力与扩展支持

▶ 1.Logs：从 error_log 到结构化日志

原生日志：
- error_log()→ 纯文本（难解析）

结构化日志：

// Monolog + JsonFormatter$logger=newLogger('app');$logger->pushHandler(newStreamHandler('php://stderr'));$logger->pushProcessor(newWebProcessor);// 自动添加 request_id$logger->info('User login',['user_id'=>123]);

输出：

{"message":"User login","context":{"user_id":123},"extra":{"request_id":"abc123"}}

▶ 2.Metrics：暴露系统指标

OPcache 指标：

// /metrics 端点$stats=opcache_get_status();echo"opcache_memory_usage{state=\"used\"} ".$stats['memory_usage']['used_memory'];

Prometheus 集成：

usePrometheus\CollectorRegistry;$registry=newCollectorRegistry();$counter=$registry->registerCounter('http','requests_total','Total HTTP requests');$counter->inc();

▶ 3.Traces：分布式链路追踪

OpenTelemetry PHP SDK：

useOpenTelemetry\SDK\Trace\TracerProvider;$tracer=(newTracerProvider())->getTracer('app');$span=$tracer->spanBuilder('database.query')->startSpan();// 执行 SQL$span->end();

自动注入 TraceID：
- 通过 Nginx 传递traceparent头
- PHP 自动关联日志与链路

三、工程实践：生产级可观测性架构

▶ 1.日志：集中式收集

关键配置：
- Laravel 日志驱动设为stderr+JsonFormatter
- Dockerfile 重定向error_log = /proc/self/fd/2

▶ 2.指标：实时监控

暴露端点：

# Nginx 配置 location /metrics { allow 10.0.0.0/8; # 仅内网访问 deny all; fastcgi_pass php-fpm; include fastcgi_params; fastcgi_param SCRIPT_FILENAME /app/metrics.php; }

Grafana 面板：
- QPS、错误率、OPcache 命中率、内存使用率

▶ 3.链路追踪：全链路分析

Jaeger UI 展示：

[HTTP Request] → [Laravel Middleware] → [MySQL Query] → [Redis Get] │ │ │ │ Duration: 120ms Duration: 50ms Duration: 30ms Duration: 10ms

关键字段：
- trace_id：全局唯一标识
- span_id：当前操作 ID
- parent_span_id：父操作 ID

四、避坑指南

陷阱	破局方案
日志未结构化	强制使用 JSON 格式，包含`request_id`、`user_id`
指标暴露公网	`/metrics`仅限内网访问（Nginx allow/deny）
链路追踪性能损耗	采样率设为 10%（`OTEL_TRACES_SAMPLER=traceidratio`）
忽略上下文传播	确保`traceparent`头在服务间传递（Nginx → PHP → 下游服务）