php 8.6后台任务可以通过opentelemetry手工创建span,记录每次任务的边界、错误和子步骤,并在进程退出前完成导出。先使用控制台导出检查结构,再接入采集器,能把埋点代码与远端网络配置分开定位。

官方文档:OpenTelemetry手工埋点概览
安装SDK并准备独立入口
composer require open-telemetry/sdk:^1.17 composer check-platform-reqs
下面使用SDK的控制台Span导出,不依赖PHP自动插桩扩展,也不会自动收集所有函数调用。需要哪些任务边界,就在对应位置显式创建Span。

官方文档:OpenTelemetry固定版本控制台导出器源码
激活上下文并保证结束
<?php
require __DIR__ . '/vendor/autoload.php';
use OpenTelemetry\SDK\Trace\TracerProvider;
use OpenTelemetry\SDK\Trace\SpanProcessor\SimpleSpanProcessor;
use OpenTelemetry\SDK\Trace\SpanExporter\ConsoleSpanExporterFactory;
use OpenTelemetry\API\Trace\StatusCode;
$provider = TracerProvider::builder()
->addSpanProcessor(new SimpleSpanProcessor((new ConsoleSpanExporterFactory())->create()))
->build();
$tracer = $provider->getTracer('app.export');
$span = $tracer->spanBuilder('export.run')->startSpan();
$scope = $span->activate();
try {
$span->setAttribute('app.export.kind', 'catalog');
$child = $tracer->spanBuilder('export.encode')->startSpan();
try {
json_encode(['id' => 42], JSON_THROW_ON_ERROR);
} finally {
$child->end();
}
} catch (Throwable $error) {
$span->recordException($error);
$span->setStatus(StatusCode::STATUS_ERROR);
throw $error;
} finally {
$scope->detach();
$span->end();
$provider->shutdown();
}激活父Span后创建子Span,SDK才能按当前上下文关联父子关系。无论成功或异常都需要end();长期Worker还要避免上一任务的激活上下文泄漏到下一任务。
检查追踪结构再连接采集器
执行脚本,检查输出中父子Span的trace ID一致、父子关系正确、任务名稳定。测试异常路径时,确认错误状态和异常事件存在,同时不会把整个输入数据或凭据写成属性。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
控制台导出是本地结构验证,不等于远端监控已接收。改用OTLP时另配置exporter、采集器地址、认证和TLS;批处理导出还需设置刷新与关闭时机,不能让进程退出丢掉最后一批Span。
立即学习“PHP免费学习笔记(深入)”;


















