包简介

OpenTelemetry integration for the Async PHP Platform — coroutine-safe span export, request tracing, and metrics bridge for Symfony applications.

README 文档

README

Intégration OpenTelemetry pour la plateforme async PHP — export de traces et métriques coroutine-safe depuis le bridge Symfony.

Installation

composer require octo-php/symfony-otel

Ce package dépend de open-telemetry/sdk et open-telemetry/exporter-otlp. Si vous ne souhaitez pas d'OTEL, n'installez pas ce package.

Configuration

La configuration utilise exclusivement les variables d'environnement standard OpenTelemetry :

Variable	Type	Description
`OTEL_EXPORTER_OTLP_ENDPOINT`	string	Endpoint de l'exporter OTLP (ex: `http://localhost:4318`)

Aucune variable d'environnement custom n'est introduite pour la configuration OTEL.

Via le bundle

# config/packages/octo.yaml
octo:
    otel:
        enabled: true

L'activation/désactivation se fait via le bundle. L'endpoint est toujours configuré via OTEL_EXPORTER_OTLP_ENDPOINT.

Traces

Root span

Un span SERVER est créé pour chaque requête Symfony, couvrant l'intégralité du cycle de vie dans le bridge (du début du handle jusqu'après le reset).

Attributs du root span :

Attribut	Description
`http.method`	Méthode HTTP (GET, POST, etc.)
`http.url`	URL de la requête
`http.status_code`	Code de statut de la réponse
`http.request_id`	Request ID propagé
`symfony.route`	Nom de la route Symfony
`symfony.controller`	Nom du controller Symfony

Child spans

Trois child spans INTERNAL sont créés pour chaque requête :

Span	Description
`symfony.kernel.handle`	Durée du `HttpKernel::handle()`
`symfony.response.convert`	Durée de la conversion de la réponse
`symfony.reset`	Durée du reset/terminate

Propagation du trace context

Le package propage le trace context entrant via les headers W3C Trace Context (traceparent, tracestate) depuis la requête OpenSwoole vers le span OTEL. Les requêtes entrantes avec un trace context existant sont rattachées au trace parent.

Gestion des exceptions

Si une exception se produit avant la création des child spans, le root span capture l'exception et se termine correctement (pas de span partiel ou orphelin).

Métriques OTEL

Les métriques du MetricsBridge sont exportées vers OTEL :

Métrique	Type	Description
`symfony_requests_total`	counter	Requêtes traitées
`symfony_request_duration_ms`	histogram	Durée de traitement
`symfony_exceptions_total`	counter	Exceptions levées
`symfony_reset_duration_ms`	histogram	Durée du reset

Batch processor coroutine-safe

Le CoroutineSafeBatchProcessor exporte les spans de manière non-bloquante :

Batch avec flush quand le batch est plein
Timer OpenSwoole pour export périodique
Export via coroutine OpenSwoole (ne bloque pas l'event loop)

Licence

MIT

octo-php/symfony-otel 适用场景与选型建议

octo-php/symfony-otel 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 0 次下载、GitHub Stars 达 0，最近一次更新时间为 2026 年 03 月 03 日，在 PHP 生态内属于活跃度较高的组件。

我们在过去多个企业项目中使用过 octo-php/symfony-otel 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 octo-php/symfony-otel 我们能提供哪些服务？

定制开发 / 二次开发

基于 octo-php/symfony-otel 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

octo-php/symfony-otel

包简介