lvht/jaeger

php client for jaeger

jaeger-php

, _(*1)

Jaeger UDP client for PHP OpenTracing API., _(*2)

Forked from jukylin/jaeger-php., _(*3)

Why fork?

Jukylin's work is awesome. But it doese not work with the latest opentracing/opentracing-php., _(*4)

This repo fix its issue and make a huge refactor for simplicity and psr., _(*5)

Feel free to choose this repo or Jukylin's., _(*6)

Install

composer config minimum-stability dev
composer config prefer-stable 1
composer require lvht/jaeger

Usage

<?php
use Jaeger\Factory;
use OpenTracing\Formats;

// init factory
$factory = Factory::getInstance();
// make OpenTracing\Tracer instance
$tracer = $factory->initTracer('user', '127.0.0.1', 6831);

// extract parent infomation from http header
$carrier = $_SERVER['HTTP_UBER_TRACE_ID'];
// extract the infomation and generate a new context
// only support binary carrier now
$context = $tracer->extract(Formats\BINARY, $carrier);

// make a new span
$span = $tracer->startSpan('foo', ['child_of' => $context]);

// do your job here

// finish the span
$span->finish();

// report infomation to jaeger
$tracer->flush();

Example

Run jaeger in docker, _(*7)

docker run --rm -d -p 6831:6831/udp -p 16686:16686 jaegertracing/all-in-one:latest

Start demo http server, _(*8)

cd example
php -S 0.0.0.0:8080 HTTP.php

Run Hprose.php, _(*9)

cd example
php Hprose.php

So you can see the Jaeger UI in http://127.0.0.1:16686, _(*10)

Good luck :), _(*11)

Features

• Transports, _(*12)

  • via Thrift over UDP

• Sampling, _(*13)

  • ConstSampler
  • ProbabilisticSampler

Reference

OpenTracing, _(*14)

Jaeger, _(*15)