PHPackages                             auxmoney/jaeger-php - 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. auxmoney/jaeger-php

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

auxmoney/jaeger-php
===================

php client for jaeger

3.0.2(3y ago)3165.0k↓64.9%4[2 PRs](https://github.com/auxmoney/jaeger-php/pulls)1Apache-2.0PHPPHP >=7.1

Since Sep 19Pushed 2y agoCompare

[ Source](https://github.com/auxmoney/jaeger-php)[ Packagist](https://packagist.org/packages/auxmoney/jaeger-php)[ RSS](/packages/auxmoney-jaeger-php/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (3)Dependencies (7)Versions (42)Used By (1)

jaeger-php
==========

[](#jaeger-php)

[![Tests](https://github.com/auxmoney/jaeger-php/actions/workflows/test.yaml/badge.svg)](https://github.com/auxmoney/jaeger-php/actions/workflows/test.yaml)[![Minimum PHP Version](https://camo.githubusercontent.com/824c5c4ccb56537db3b3b53bb43d7b8edc6286f3b3d1705525e0821dfd22d27e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344253230372e312d3838393242462e737667)](https://php.net/)[![License](https://camo.githubusercontent.com/b2d40e8bb26e438f0f9cd19423e1a1f1746ac57e9597467c954dbc998bc7f979/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6175786d6f6e65792f6a61656765722d7068702e737667)](https://github.com/auxmoney/jaeger-php/blob/master/LICENSE)[![Coverage Status](https://camo.githubusercontent.com/e11825b9b4be1e63df70ac65d36ee9466a2193d281242501a53c886ac4bb1bc7/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f6175786d6f6e65792f6a61656765722d7068702f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/auxmoney/jaeger-php?branch=master)

*ATTENTION: this is a fork and republication of [jukylin/jaeger-php](https://github.com/jukylin/jaeger-php)*

*We opted into forking and publishing the original library in order to maintain our set of [opentracing related symfony bundles](https://github.com/auxmoney?q=opentracingbundle). The original library seems to be unmaintained currently.*

jaeger-php is a library implementing the [OpenTracing specification for PHP](https://github.com/opentracing/opentracing-php) to connect with the [Jaeger Distributed Tracing Platform](https://github.com/jaegertracing/jaeger). It can be used to instrument PHP code to generate tracing data and send it to Jaeger.

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

[](#installation)

```
composer require auxmoney/jaeger-php

```

Usage
-----

[](#usage)

First, you need to create a `Config` object, which serves as the factory to create your `Tracer`:

```
// create a config instance
$config = \Jaeger\Config::getInstance();
// create a tracer
$tracer = $config->initTracer('example service name', '0.0.0.0:6831');
```

To make the distributed tracing work, you need to extract your `SpanContext` from somewhere, e.g. `$_SERVER`:

```
$spanContext = $tracer->extract(\Opentracing\Formats\TEXT_MAP, $_SERVER);
```

You can then start tracing by using the common Opentracing interface:

```
$tracer->startActiveSpan("example operation name", ['child_of' => $spanContext]);
```

To add metadata to your span, you need to retrieve it first (be sure to check the [semantic conventions](https://opentracing.io/specification/conventions/) first):

```
$span = $tracer->getActiveSpan();
$span->addBaggageItem("user_id", "12345");
$span->setTag("http.url", "http://localhost");
$span->log(["message" => "responded successfully"]);
$span->finish();
```

Finally, at the end of your script, you should flush the original `Config`. This will flush all created `Tracer`s and all created `Span`s:

```
$config->flush();
```

### optional configuration

[](#optional-configuration)

```
// optional: generate 128 bit trace ids (default: false)
$config->gen128bit();
// optional: disable tracing (default: false)
$config->setDisabled(true);
// optional: inject custom transport (default: TransportUdp)
$config->setTransport($transport);
// optional: inject custom reporter (default: RemoteReporter)
$config->setReporter($reporter);
// optional: inject custom sampler (default: ConstSampler)
$config->setSampler($sampler);
```

Special thanks
--------------

[](#special-thanks)

Thank you, @jukylin, for creating this library!

###  Health Score

40

—

FairBetter than 86% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity37

Limited adoption so far

Community22

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor1

Top contributor holds 84.1% 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 ~85 days

Recently: every ~204 days

Total

22

Last Release

1387d ago

Major Versions

v1.0.3 → v2.0.0-beta2018-01-13

v2.1.3 → 3.0.02021-11-15

PHP version history (2 changes)1.0.0PHP >=5.6.0

3.0.0PHP >=7.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/58fb41ad66c6b45096cad21d54aa1aacabcb9eedc8974664e1e6776327662816?d=identicon)[cawolf](/maintainers/cawolf)

![](https://avatars.githubusercontent.com/u/1080582?v=4)[Georg Heßmann](/maintainers/guckykv)[@guckykv](https://github.com/guckykv)

---

Top Contributors

[![jky-yy](https://avatars.githubusercontent.com/u/185590763?v=4)](https://github.com/jky-yy "jky-yy (211 commits)")[![cawolf](https://avatars.githubusercontent.com/u/1932623?v=4)](https://github.com/cawolf "cawolf (9 commits)")[![dmnbars](https://avatars.githubusercontent.com/u/7151631?v=4)](https://github.com/dmnbars "dmnbars (7 commits)")[![gitsrc](https://avatars.githubusercontent.com/u/34047788?v=4)](https://github.com/gitsrc "gitsrc (6 commits)")[![monteiro](https://avatars.githubusercontent.com/u/74459?v=4)](https://github.com/monteiro "monteiro (3 commits)")[![ttrig](https://avatars.githubusercontent.com/u/2156132?v=4)](https://github.com/ttrig "ttrig (3 commits)")[![vyuldashev](https://avatars.githubusercontent.com/u/1809081?v=4)](https://github.com/vyuldashev "vyuldashev (2 commits)")[![RunnerLee](https://avatars.githubusercontent.com/u/7436388?v=4)](https://github.com/RunnerLee "RunnerLee (2 commits)")[![xJakub](https://avatars.githubusercontent.com/u/1308245?v=4)](https://github.com/xJakub "xJakub (1 commits)")[![colin-at-kiva](https://avatars.githubusercontent.com/u/54085523?v=4)](https://github.com/colin-at-kiva "colin-at-kiva (1 commits)")[![corerman](https://avatars.githubusercontent.com/u/7157314?v=4)](https://github.com/corerman "corerman (1 commits)")[![ldjdd](https://avatars.githubusercontent.com/u/16792514?v=4)](https://github.com/ldjdd "ldjdd (1 commits)")[![sadok-f](https://avatars.githubusercontent.com/u/533384?v=4)](https://github.com/sadok-f "sadok-f (1 commits)")[![userator](https://avatars.githubusercontent.com/u/305457?v=4)](https://github.com/userator "userator (1 commits)")[![xbing2002](https://avatars.githubusercontent.com/u/37572472?v=4)](https://github.com/xbing2002 "xbing2002 (1 commits)")[![aogier](https://avatars.githubusercontent.com/u/321364?v=4)](https://github.com/aogier "aogier (1 commits)")

---

Tags

tracejaegeropentracing

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/auxmoney-jaeger-php/health.svg)

```
[![Health](https://phpackages.com/badges/auxmoney-jaeger-php/health.svg)](https://phpackages.com/packages/auxmoney-jaeger-php)
```

###  Alternatives

[jonahgeorge/jaeger-client-php

Jaeger Bindings for PHP OpenTracing API

1484.6M19](/packages/jonahgeorge-jaeger-client-php)[jukylin/jaeger-php

php client for jaeger

2251.6M6](/packages/jukylin-jaeger-php)[lvht/jaeger

php client for jaeger

1240.6k](/packages/lvht-jaeger)[extraswoft/jaeger

jaeger-sdk for swoft

204.9k](/packages/extraswoft-jaeger)[vinelab/tracing-laravel

Distributed tracing for Laravel made easy

81123.3k1](/packages/vinelab-tracing-laravel)[auxmoney/opentracing-bundle-core

Symfony Opentracing bundle to easily enable distributed tracing

25906.5k9](/packages/auxmoney-opentracing-bundle-core)

PHPackages © 2026

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