PHPackages                             mindbreak/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 &amp; Monitoring](/categories/logging)
4. /
5. mindbreak/jaeger-php

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

mindbreak/jaeger-php
====================

PHP Client for Jaeger

0.1.0(5y ago)14261Apache-2.0PHPPHP &gt;=8.0

Since Apr 17Pushed 5y ago1 watchersCompare

[ Source](https://github.com/MinDBreaK/jaeger-php)[ Packagist](https://packagist.org/packages/mindbreak/jaeger-php)[ RSS](/packages/mindbreak-jaeger-php/feed)WikiDiscussions master Synced 6d ago

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

[![PHP Version](https://camo.githubusercontent.com/b22d668c5f2c503a4cff1ef9ef72d72e57b454e9d4b3c81c1c8fab43f6b3f8c1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6d696e64627265616b2f6a61656765722d7068702f6465762d6d61737465723f7374796c653d666c61742d737175617265)](https://php.net)[![License](https://camo.githubusercontent.com/7729ac4193c8d7194e1a3ab99880030ca04111fa1bd835e2870040a36aed1302/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6d696e64627265616b2f6a61656765722d7068702e7376673f7374796c653d666c61742d737175617265)](https://github.com/mindbreak/jaeger-php/blob/master/LICENSE)

⚠️ Not stable - WIP

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

[](#jaeger-php)

Install
-------

[](#install)

Install via composer.

```
composer config minimum-stability dev
composer require mindbreak/jaeger-php

```

Init Jaeger-php
---------------

[](#init-jaeger-php)

```
$config = Config::getInstance();
$tracer = $config->initTracer('example', '0.0.0.0:6831');
```

128bit
------

[](#128bit)

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

Extract from Superglobals
-------------------------

[](#extract-from-superglobals)

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

Start Span
----------

[](#start-span)

```
$serverSpan = $tracer->startSpan('example HTTP', ['child_of' => $spanContext]);
```

Distributed context propagation
-------------------------------

[](#distributed-context-propagation)

```
$serverSpan->addBaggageItem("version", "2.0.0");
```

Inject into Superglobals
------------------------

[](#inject-into-superglobals)

```
$clientTrace->inject($clientSpan1->spanContext, Formats\TEXT_MAP, $_SERVER);
```

Tags and Log
------------

[](#tags-and-log)

```
// tags are searchable in Jaeger UI
$span->setTag('http.status', '200');

// log record
$span->log(['error' => 'HTTP request timeout']);
```

Close Tracer
------------

[](#close-tracer)

```
$config->setDisabled(true);
```

Zipkin B3 Propagation
---------------------

[](#zipkin-b3-propagation)

*no support for* `Distributed context propagation`

```
$config::$propagator = \Jaeger\Constants\PROPAGATOR_ZIPKIN;
```

Finish span and flush Tracer
----------------------------

[](#finish-span-and-flush-tracer)

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

More example
------------

[](#more-example)

- [HTTP](https://github.com/jukylin/jaeger-php/blob/master/example/HTTP.php)
- [Hprose](https://github.com/jukylin/blog/blob/master/Uber%E5%88%86%E5%B8%83%E5%BC%8F%E8%BF%BD%E8%B8%AA%E7%B3%BB%E7%BB%9FJaeger%E4%BD%BF%E7%94%A8%E4%BB%8B%E7%BB%8D%E5%92%8C%E6%A1%88%E4%BE%8B%E3%80%90PHP%20%20%20Hprose%20%20%20Go%E3%80%91.md#%E8%B7%A8%E8%AF%AD%E8%A8%80%E8%B0%83%E7%94%A8%E6%A1%88%E4%BE%8B)
- [Istio](https://github.com/jukylin/jaeger-php/blob/master/example/README.md)

Features
--------

[](#features)

- Transports

    - via Thrift over UDP
- Sampling

    - ConstSampler
    - ProbabilisticSampler

Reference
---------

[](#reference)

[OpenTracing](https://opentracing.io/)

[Jaeger](https://uber.github.io/jaeger/)

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community20

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

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

1856d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/15737031?v=4)[Antoine](/maintainers/MinDBreaK)[@MinDBreaK](https://github.com/MinDBreaK)

---

Top Contributors

[![jky-yy](https://avatars.githubusercontent.com/u/185590763?v=4)](https://github.com/jky-yy "jky-yy (211 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)")[![cawolf](https://avatars.githubusercontent.com/u/1932623?v=4)](https://github.com/cawolf "cawolf (5 commits)")[![ttrig](https://avatars.githubusercontent.com/u/2156132?v=4)](https://github.com/ttrig "ttrig (3 commits)")[![monteiro](https://avatars.githubusercontent.com/u/74459?v=4)](https://github.com/monteiro "monteiro (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)")[![MinDBreaK](https://avatars.githubusercontent.com/u/15737031?v=4)](https://github.com/MinDBreaK "MinDBreaK (1 commits)")[![sadok-f](https://avatars.githubusercontent.com/u/533384?v=4)](https://github.com/sadok-f "sadok-f (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 AnalysisPsalm

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

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

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

###  Alternatives

[jonahgeorge/jaeger-client-php

Jaeger Bindings for PHP OpenTracing API

1484.4M18](/packages/jonahgeorge-jaeger-client-php)[jukylin/jaeger-php

php client for jaeger

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

php client for jaeger

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

jaeger-sdk for swoft

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

Distributed tracing for Laravel made easy

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

Symfony Opentracing bundle to easily enable distributed tracing

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

PHPackages © 2026

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