sablesoft/jaeger-php

php client for jaeger

v2.3.0 2019-10-07 15:38 UTC

Requires

• php: >=5.6.0
• opentracing/opentracing: 1.0.0-beta5
• packaged/thrift: 0.10.0

Requires (Dev)

• php-coveralls/php-coveralls: ^1.0
• phpunit/phpunit: ^5

Apache-2.0

• sablesoft

• trace
• jaeger
• opentracing

README

jaeger-php

principle of Distributed Tracing

install

install via composer

vim composer.json

{
  "minimum-stability": "dev",
  "require":           {
    "jukylin/jaeger-php" : "^2.0",
    "opentracing/opentracing":"1.0.0-beta5"
  }
}

composer update

Init Jaeger-php

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

128bit

$config->gen128bit();

Extract from Superglobals

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

Start Span

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

Distributed context propagation

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

Inject into Superglobals

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

Tags and Log

//can search in Jaeger UI
$span->setTag('http.status', "200");

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

Close Tracer

$config->setDisabled(true);

Zipkin B3 Propagation

not support Distributed context propagation

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

finish span and flush Tracer

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

more example

• HTTP
• Hprose
• Istio

Features

• Transports

  • via Thrift over UDP

• Sampling

  • ConstSampler
  • ProbabilisticSampler

Reference

OpenTracing

Jaeger