PHPackages                             octo-php/symfony-otel - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Logging & Monitoring](/categories/logging)
4. /
5. octo-php/symfony-otel

ActiveLibrary[Logging & Monitoring](/categories/logging)

octo-php/symfony-otel
=====================

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

v0.1.2(2mo ago)001MITPHPPHP >=8.4

Since Mar 3Pushed 2mo agoCompare

[ Source](https://github.com/LaProgrammerie/octo-php-symfony-otel)[ Packagist](https://packagist.org/packages/octo-php/symfony-otel)[ RSS](/packages/octo-php-symfony-otel/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (3)Versions (2)Used By (1)

octo-php/symfony-otel
=====================

[](#octo-phpsymfony-otel)

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

Installation
------------

[](#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
-------------

[](#configuration)

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

VariableTypeDescription`OTEL_EXPORTER_OTLP_ENDPOINT`stringEndpoint de l'exporter OTLP (ex: `http://localhost:4318`)Aucune variable d'environnement custom n'est introduite pour la configuration OTEL.

### Via le bundle

[](#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
------

[](#traces)

### Root span

[](#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 :

AttributDescription`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

[](#child-spans)

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

SpanDescription`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

[](#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

[](#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
--------------

[](#métriques-otel)

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

MétriqueTypeDescription`symfony_requests_total`counterRequêtes traitées`symfony_request_duration_ms`histogramDurée de traitement`symfony_exceptions_total`counterExceptions levées`symfony_reset_duration_ms`histogramDurée du resetBatch processor coroutine-safe
------------------------------

[](#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
-------

[](#licence)

MIT

###  Health Score

35

—

LowBetter than 80% of packages

Maintenance85

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

76d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e3192df86b9648428e1ad85643809f814e4a2f48279370f8bd39dc4fcacb0365?d=identicon)[laprogrammerie](/maintainers/laprogrammerie)

---

Top Contributors

[![matthieuwerner](https://avatars.githubusercontent.com/u/3184545?v=4)](https://github.com/matthieuwerner "matthieuwerner (5 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/octo-php-symfony-otel/health.svg)

```
[![Health](https://phpackages.com/badges/octo-php-symfony-otel/health.svg)](https://phpackages.com/packages/octo-php-symfony-otel)
```

###  Alternatives

[psr/log

Common interface for logging libraries

10.4k1.2B9.2k](/packages/psr-log)[itsgoingd/clockwork

php dev tools in your browser

5.9k27.6M94](/packages/itsgoingd-clockwork)[graylog2/gelf-php

A php implementation to send log-messages to a GELF compatible backend like Graylog2.

41838.2M138](/packages/graylog2-gelf-php)[bugsnag/bugsnag-psr-logger

Official Bugsnag PHP PSR Logger.

32132.5M2](/packages/bugsnag-bugsnag-psr-logger)[consolidation/log

Improved Psr-3 / Psr\\Log logger based on Symfony Console components.

15462.2M7](/packages/consolidation-log)[ekino/newrelic-bundle

Integrate New Relic into Symfony2

28111.2M8](/packages/ekino-newrelic-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)