PHPackages                             worldia/instrumentation-bundle - 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 &amp; Monitoring](/categories/logging)
4. /
5. worldia/instrumentation-bundle

ActiveSymfony-bundle[Logging &amp; Monitoring](/categories/logging)

worldia/instrumentation-bundle
==============================

Symfony opentelemetry auto-instrumentation: requests, commands, messenger, doctrine.

2.3.0(3d ago)2875.4k↓40%13[1 issues](https://github.com/worldia/instrumentation-bundle/issues)[2 PRs](https://github.com/worldia/instrumentation-bundle/pulls)MITPHPCI passing

Since Mar 18Pushed 3d ago5 watchersCompare

[ Source](https://github.com/worldia/instrumentation-bundle)[ Packagist](https://packagist.org/packages/worldia/instrumentation-bundle)[ RSS](/packages/worldia-instrumentation-bundle/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (10)Dependencies (30)Versions (91)Used By (0)

Instrumentation for Symfony
===========================

[](#instrumentation-for-symfony)

Using the official [OpenTelemetry SDK](https://github.com/open-telemetry/opentelemetry-php).

### Features

[](#features)

- Minimal auto-instrumentation for **requests**, console **commands**, **consumers** and **doctrine**
- Trace context propagation from incoming **requests** to **consumers** and **outgoing http calls**
- Minimal metrics for **requests**, **consumers** and **messages**
- Trace context propagation for **database** requests (using [`sqlcommenter`](https://google.github.io/sqlcommenter/))

### Full working example

[](#full-working-example)

For a fully working example including Jaeger, Grafana, Tempo, Loki and Prometheus, check the [example directory](./example/).

### Installation and configuration

[](#installation-and-configuration)

Install along your [exporter implementation](https://packagist.org/packages/open-telemetry/exporter-otlp?query=open-telemetry%2Fexporter-), eg. `open-telemetry/exporter-otlp`.

```
composer require worldia/instrumentation-bundle open-telemetry/exporter-otlp
```

Add to `bundles.php`.

```
return [
    // Other bundles
    Instrumentation\InstrumentationBundle::class => ['all' => true],
];
```

Configure OTEL env vars. Replace `` by yours, eg. `jaeger`, `tempo`, `otel-collector`, ...

```
OTEL_SERVICE_NAME=test-app
OTEL_PHP_DETECTORS=none
OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE=Delta
OTEL_EXPORTER_OTLP_PROTOCOL=http/json
OTEL_EXPORTER_OTLP_ENDPOINT=http://:4318
```

Enable the extension. See the complete [configuration reference here](./docs/config-reference.md) or run `bin/console config:dump-reference instrumentation`.

```
instrumentation: ~

monolog:
  handlers:
    otel:
      type: service
      id: Instrumentation\Logging\OtelHandler
```

### Usage

[](#usage)

- [Simple tracing example](./docs/tracing/simple-trace.md)
- [Add Urls to your traces in error messages](./docs/tracing/add-urls-to-your-traces.md)
- [Customize operation (span) name for a message](./docs/tracing/custom-operation-name-for-message.md)
- [Link strategy for a message](./docs/tracing/link-strategy-for-message.md)

###  Health Score

60

—

FairBetter than 98% of packages

Maintenance98

Actively maintained with recent releases

Popularity43

Moderate usage in the ecosystem

Community21

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 73% 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

Every ~17 days

Recently: every ~66 days

Total

89

Last Release

3d ago

Major Versions

0.0.45 → 1.0.0beta12023-01-31

1.2.1 → 2.0.02025-01-12

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/4642448?v=4)[Christian Daguerre](/maintainers/cdaguerre)[@cdaguerre](https://github.com/cdaguerre)

---

Top Contributors

[![cdaguerre](https://avatars.githubusercontent.com/u/4642448?v=4)](https://github.com/cdaguerre "cdaguerre (184 commits)")[![camilledejoye](https://avatars.githubusercontent.com/u/11501572?v=4)](https://github.com/camilledejoye "camilledejoye (26 commits)")[![cyve](https://avatars.githubusercontent.com/u/3588995?v=4)](https://github.com/cyve "cyve (23 commits)")[![BowlingX](https://avatars.githubusercontent.com/u/215671?v=4)](https://github.com/BowlingX "BowlingX (7 commits)")[![jderusse](https://avatars.githubusercontent.com/u/578547?v=4)](https://github.com/jderusse "jderusse (3 commits)")[![klkvsk](https://avatars.githubusercontent.com/u/1466771?v=4)](https://github.com/klkvsk "klkvsk (3 commits)")[![hatemHn](https://avatars.githubusercontent.com/u/169443133?v=4)](https://github.com/hatemHn "hatemHn (2 commits)")[![csanchezworldia](https://avatars.githubusercontent.com/u/222193937?v=4)](https://github.com/csanchezworldia "csanchezworldia (2 commits)")[![landa-worldia](https://avatars.githubusercontent.com/u/158473844?v=4)](https://github.com/landa-worldia "landa-worldia (1 commits)")[![GCalmels](https://avatars.githubusercontent.com/u/5655839?v=4)](https://github.com/GCalmels "GCalmels (1 commits)")

---

Tags

instrumentationmetricsopen-telemetryprometheustracingsymfonyMetricstracingopentelemetryotelinstrumentationprometheusopen-telemetry

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/worldia-instrumentation-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/worldia-instrumentation-bundle/health.svg)](https://phpackages.com/packages/worldia-instrumentation-bundle)
```

###  Alternatives

[traceway/opentelemetry-symfony

Pure-PHP OpenTelemetry instrumentation for Symfony — automatic HTTP, Console, HttpClient, Messenger, Doctrine DBAL, Cache, Twig tracing and Monolog log-trace correlation with response propagation, a lightweight Tracing helper, route templates, and semantic conventions. No C extension required (ext-protobuf recommended for production).

7812.6k](/packages/traceway-opentelemetry-symfony)[open-telemetry/opentelemetry-auto-symfony

OpenTelemetry auto-instrumentation for Symfony

561.6M3](/packages/open-telemetry-opentelemetry-auto-symfony)[friendsofopentelemetry/opentelemetry-bundle

Traces, metrics, and logs instrumentation within your Symfony application

6511.2k](/packages/friendsofopentelemetry-opentelemetry-bundle)[open-telemetry/opentelemetry-auto-laravel

OpenTelemetry auto-instrumentation for Laravel

592.7M9](/packages/open-telemetry-opentelemetry-auto-laravel)

PHPackages © 2026

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