PHPackages                             waffle-commons/telemetry-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 &amp; Monitoring](/categories/logging)
4. /
5. waffle-commons/telemetry-otel

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

waffle-commons/telemetry-otel
=============================

OpenTelemetry SDK bridge for Waffle Commons: implements the framework TracerInterface with W3C trace-context propagation, keeping the OTel SDK out of the core perimeter.

0.1.0-beta5(1mo ago)00MITPHPPHP ^8.5CI passing

Since Jul 8Pushed 1mo agoCompare

[ Source](https://github.com/waffle-commons/telemetry-otel)[ Packagist](https://packagist.org/packages/waffle-commons/telemetry-otel)[ RSS](/packages/waffle-commons-telemetry-otel/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (1)Dependencies (11)Versions (3)Used By (0)

[![Discord](https://camo.githubusercontent.com/b30f41baece56d71f7f496f7e39fd33a2a096221c66c648b350dd4fe14276c2e/68747470733a2f2f696d672e736869656c64732e696f2f646973636f72642f3735353238383030313539323033333339313f6c6f676f3d646973636f7264)](https://discord.gg/eKgywnfXr2)[![PHP Version Require](https://camo.githubusercontent.com/9b007ee4ecfe9c1ca2822cc32a7f86e921b8e55e8a7b6dc8b990b65a99aefdaf/687474703a2f2f706f7365722e707567782e6f72672f776166666c652d636f6d6d6f6e732f74656c656d657472792d6f74656c2f726571756972652f706870)](https://packagist.org/packages/waffle-commons/telemetry-otel)[![PHP CI](https://github.com/waffle-commons/telemetry-otel/actions/workflows/main.yml/badge.svg)](https://github.com/waffle-commons/telemetry-otel/actions/workflows/main.yml)[![codecov](https://camo.githubusercontent.com/aea88d38495f2bb6672140c26b7f9b0b3d381db3d999a1a1e869c6b3b140a966/68747470733a2f2f636f6465636f762e696f2f67682f776166666c652d636f6d6d6f6e732f74656c656d657472792d6f74656c2f67726170682f62616467652e737667)](https://codecov.io/gh/waffle-commons/telemetry-otel)[![Latest Stable Version](https://camo.githubusercontent.com/7f9d7d66782f9e1ee4a5949b48bdbe9eb92ad14ed40aec9b00cf3171a18890a2/687474703a2f2f706f7365722e707567782e6f72672f776166666c652d636f6d6d6f6e732f74656c656d657472792d6f74656c2f76)](https://packagist.org/packages/waffle-commons/telemetry-otel)[![Packagist License](https://camo.githubusercontent.com/01b8b740b7c9271856529bb0e9fb01377e6aad5e570f21ca2358ba0c33193693/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f776166666c652d636f6d6d6f6e732f74656c656d657472792d6f74656c)](https://github.com/waffle-commons/telemetry-otel/blob/main/LICENSE.md)

Waffle Commons — Telemetry (OpenTelemetry Bridge)
=================================================

[](#waffle-commons--telemetry-opentelemetry-bridge)

OpenTelemetry SDK bridge for the [Waffle Commons](https://github.com/waffle-commons) framework. It implements `Waffle\Commons\Contracts\Telemetry\TracerInterface` on top of the audited OpenTelemetry PHP SDK and propagates **W3C Trace Context** on outbound HTTP calls — isolating the vendor SDK in this adapter so the core packages stay vendor-free.

> **Status:** shipped in **Beta 5 / AXE 5 (RFC-005)**. The SDK-free defaults, the Prometheus endpoint and the metric collectors live in [`waffle-commons/telemetry`](https://github.com/waffle-commons/telemetry).

What's inside
-------------

[](#whats-inside)

- **Tracer adapters** — `Trace\OtelTracer`, `Trace\OtelSpan` and `Trace\OtelSpanContext` adapt the OpenTelemetry SDK to the framework's `Contracts\Telemetry\TracerInterface` / `SpanInterface` / `SpanContextInterface`. The SDK owns the active-context stack, so the adapters hold no per-request worker state.
- **W3C propagation** — `Propagation\W3CTraceContextPropagator` injects / extracts `traceparent` + `tracestate`, enabling transparent distributed tracing across services.
- **Factory** — `Factory\OtelTracerFactory` assembles a tracer from any `SpanExporterInterface` (or a console JSON exporter for local `docker logs` inspection), keeping every `OpenTelemetry\SDK\*` symbol out of the core perimeter.

Perimeter
---------

[](#perimeter)

The **only** Waffle package permitted to require the OpenTelemetry SDK (`open-telemetry/*`). Depends on `waffle-commons/contracts` plus the OTel SDK; `mago guard` is configured to allow the SDK here and nowhere else. The request-scoped trace-context holder implements `ResettableInterface` (`wfl igor` 0 KO).

Development
-----------

[](#development)

```
composer install
composer mago     # fmt + lint + analyze + guard — must be ZERO output
composer tests    # PHPUnit 12.5, >=95% coverage
composer igor     # worker-safety audit — 0 KO
```

License
-------

[](#license)

MIT — see [LICENSE.md](./LICENSE.md).

###  Health Score

35

—

LowBetter than 77% of packages

Maintenance90

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

 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

48d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/34a7557a3fb23aaf788ca3892b9b7efdf96e753264bafd0599153c9e8a921316?d=identicon)[LesliePetrimaux](/maintainers/LesliePetrimaux)

---

Top Contributors

[![supa-chayajin](https://avatars.githubusercontent.com/u/695448?v=4)](https://github.com/supa-chayajin "supa-chayajin (7 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPsalm

Type Coverage Yes

### Embed Badge

![Health badge](/badges/waffle-commons-telemetry-otel/health.svg)

```
[![Health](https://phpackages.com/badges/waffle-commons-telemetry-otel/health.svg)](https://phpackages.com/packages/waffle-commons-telemetry-otel)
```

###  Alternatives

[shopware/platform

The Shopware e-commerce core

3.4k1.5M3](/packages/shopware-platform)[keepsuit/laravel-opentelemetry

OpenTelemetry integration for laravel

173666.7k1](/packages/keepsuit-laravel-opentelemetry)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.4M236](/packages/sulu-sulu)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.8M684](/packages/shopware-core)[contao/core-bundle

Contao Open Source CMS

1301.7M3.1k](/packages/contao-core-bundle)[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).

8022.8k](/packages/traceway-opentelemetry-symfony)

PHPackages © 2026

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