PHPackages                             poespas/opentelemetry-tracing-magento2 - 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. poespas/opentelemetry-tracing-magento2

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

poespas/opentelemetry-tracing-magento2
======================================

Magento 2 OpenTelemetry Tracing

1.0.0(1y ago)53.2k↓100%[1 issues](https://github.com/poespas/opentelemetry-tracing-magento2/issues)MITPHPPHP ^8.1 || ^8.2 || ^8.3

Since Oct 26Pushed 1y ago1 watchersCompare

[ Source](https://github.com/poespas/opentelemetry-tracing-magento2)[ Packagist](https://packagist.org/packages/poespas/opentelemetry-tracing-magento2)[ RSS](/packages/poespas-opentelemetry-tracing-magento2/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (1)Versions (2)Used By (0)

OpenTelemetry Tracing for Magento 2
===================================

[](#opentelemetry-tracing-for-magento-2)

Overview
--------

[](#overview)

**OpenTelemetry Tracing** is a Magento 2 module that integrates seamlessly with Magento's built-in Profiling functionality to provide advanced tracing capabilities. By adding a custom tracing driver, this module enables detailed performance monitoring and analysis, helping developers optimize their Magento applications effectively and for free.

Features
--------

[](#features)

- **Enhanced Profiling:** Extends Magento's native profiler with advanced tracing capabilities.
- **Jaeger Compatibility:** Integrates with Jaeger for distributed tracing using the [jonahgeorge/jaeger-client-php](https://github.com/jonahgeorge/jaeger-client-php) library.
- **Grafana Tempo Support:** Compatible with Grafana Tempo through the OpenTelemetry endpoint, allowing for comprehensive monitoring and visualization.
- **Flexible Configuration:** Easily configure tracing settings via JSON files or Magento CLI commands.

Compatibility
-------------

[](#compatibility)

### Jaeger

[](#jaeger)

OpenTelemetry Tracing integrates with [Jaeger](https://www.jaegertracing.io/), a popular open-source distributed tracing system. This integration is powered by the [jonahgeorge/jaeger-client-php](https://github.com/jonahgeorge/jaeger-client-php) library, ensuring reliable and efficient tracing capabilities.

### Grafana Tempo

[](#grafana-tempo)

The module also supports [Grafana Tempo](https://grafana.com/oss/tempo/), enabling users to leverage Grafana's powerful visualization tools through the OpenTelemetry endpoint. This compatibility allows for seamless tracing data collection and analysis within the Grafana ecosystem.

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

[](#installation)

1. **Clone the Repository:**

```
composer require poespas/opentelemetry-tracing-magento2
```

2. **Enable the Module:**

```
bin/magento module:enable Poespas_OpentelemetryTracing
bin/magento setup:upgrade
```

Configuration
-------------

[](#configuration)

You can configure the tracing driver using a JSON configuration file or via the Magento CLI command.

### Using `var/profiler.flag` File

[](#using-varprofilerflag-file)

Create or update the `var/profiler.flag` file in the root of the magento installation with your JSON configuration:

```
{
  "drivers": [
    {
      "type": "\\Poespas\\OpentelemetryTracing\\Profiler\\Driver\\TracingDriver",
      "application_name": "my-magento-app",
      "config": {
        "local_agent": {
          "reporting_host": "127.0.0.1",
          "reporting_port": 14268
        },
        "dispatch_mode": "jaeger_over_binary_http"
      }
    }
  ]
}

```

### Using Magento CLI Command

[](#using-magento-cli-command)

Alternatively, enable the profiler with a minified JSON configuration using the following command:

```
bin/magento dev:profiler:enable '{"drivers":[{"type":"\\Poespas\\OpentelemetryTracing\\Profiler\\Driver\\TracingDriver","application_name":"my-magento-app","config":{"local_agent":{"reporting_host":"127.0.0.1","reporting_port":14268},"dispatch_mode":"jaeger_over_binary_http"}}]}'

```

Screenshots
-----------

[](#screenshots)

### Jaeger Integration

[](#jaeger-integration)

[![Jaeger Dashboard](.github/images/jaeger-screenshot.png)](.github/images/jaeger-screenshot.png)

*Example of tracing data visualized in Jaeger.*

### Grafana Tempo Integration

[](#grafana-tempo-integration)

[![Grafana Tempo Dashboard](.github/images/grafana-tempo-screenshot.png)](.github/images/grafana-tempo-screenshot.png)

*Example of tracing data visualized in Grafana Tempo.*

Inspiration
-----------

[](#inspiration)

OpenTelemetry Tracing was inspired by the [sitewards/Magento2-OpenCensus](https://github.com/sitewards/Magento2-OpenCensus) project.

License
-------

[](#license)

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

Contributing
------------

[](#contributing)

Contributions are welcome! Please open an issue or submit a pull request for any improvements or bug fixes.

Support
-------

[](#support)

For support and questions, please open an issue on the [GitHub repository](https://github.com/poespas/opentelemetry-tracing-magento2/issues).

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance33

Infrequent updates — may be unmaintained

Popularity24

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity53

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

563d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/98f4792552956e294fb2b0f7f4b4f1d192e2e04ef84e55a015504c34447fada3?d=identicon)[poespas](/maintainers/poespas)

---

Top Contributors

[![poespas](https://avatars.githubusercontent.com/u/10142882?v=4)](https://github.com/poespas "poespas (1 commits)")

---

Tags

magento2monitoringobservabilityperformancephp

### Embed Badge

![Health badge](/badges/poespas-opentelemetry-tracing-magento2/health.svg)

```
[![Health](https://phpackages.com/badges/poespas-opentelemetry-tracing-magento2/health.svg)](https://phpackages.com/packages/poespas-opentelemetry-tracing-magento2)
```

###  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)[datadog/php-datadogstatsd

An extremely simple PHP datadogstatsd client

19124.6M15](/packages/datadog-php-datadogstatsd)

PHPackages © 2026

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