Reference implementation of the OpenTracing API for Laravel including a server-less local tracer for application logging purposes.
See OpenTracing for more information.
Currently supported clients:
Note that a patched version of Jaeger Client PHP is currently required to retain PHP 5.6 support. If you need that in
your application, add the config below to your composer.json
file in the repositories
section.
{
"type": "vcs",
"url": "https://github.com/taisph/jaeger-client-php"
}
Install the latest version using:
composer require taisph/laravel-opentracing
Copy the default configuration file to your application if you want to change it by running the command below. Note
that you have to use --force
if the file already exists.
php artisan vendor:publish --provider="LaravelOpenTracing\TracingServiceProvider"
Example bootstrap/app.php
file:
<?php
// Create the application.
$app = new \Illuminate\Foundation\Application(realpath(__DIR__ . '/../'));
// Bind important interfaces.
// ...
// Register important providers.
$app->register(\LaravelOpenTracing\TracingServiceProvider::class);
// Enable tracing span context in log messages.
$app->configureMonologUsing(function (\Monolog\Logger $logger) {
$logger->pushProcessor(new \LaravelOpenTracing\Log\Processor\LocalTracerProcessor());
});
// Return the application.
return $app;
To trace a specific process in your application you can wrap the process in a trace closure like below. This will take care of starting a new trace span and closing it again when the closure either returns or throws.
$items = app(\LaravelOpenTracing\TracingService::class)->trace(
'todo.get_list_items',
function () {
return \App\Models\TodoListItem::get();
}
);
Nested traces are also possible like below. It will automatically take care of the span child/parent relations.
function a() {
// We don't care about tracing this specifically.
doSomething();
app(\LaravelOpenTracing\TracingService::class)->trace(
'app.do_something_else',
function () {
doSomethingElse();
}
);
}
app(\LaravelOpenTracing\TracingService::class)->trace(
'app.do_stuff',
function () {
a();
}
);
If you want to add context information or tags to your spans, it is possible like below.
$title = 'Make more coffee';
$item = app(\LaravelOpenTracing\TracingService::class)->trace(
'todo.store_item',
function () use ($title) {
return \App\Models\TodoListItem::create(['title' => $title]);
},
['tags' => ['title' => $title]]
);
Configure your dispatcher to pipe jobs through the tracing pipe. This is similar to middleware, only for jobs.
<?php
app(\Illuminate\Bus\Dispatcher::class)->pipeThrough([
\LaravelOpenTracing\TracingJobPipe::class,
]);
Trace contexts can easily be used across services. If your application starts a tracing context, that context can be carried over HTTP to another service with an OpenTracing compatible implementation.
To automatically accept trace contexts from other services, add the tracing middleware to your application by adding it
to your app/Http/Kernel.php
file like below:
<?php
class Kernel extends HttpKernel
{
protected $middleware = [
\LaravelOpenTracing\Http\Middleware\Tracing::class,
];
}
Assuming your application uses GuzzleHttp for sending requests to external services, you can use the provided tracing handler when creating the client like below. This will automatically send the necessary trace context headers with the HTTP request to the external service.
<?php
new \GuzzleHttp\Client(
[
'handler' => new \LaravelOpenTracing\TracingHandlerStack(),
'headers' => [
'cache-control' => 'no-cache',
'content-type' => 'application/json',
],
'base_uri' => 'http://localhost/api/myservice',
'http_errors' => false
]
);
docker run --rm -it -v $(pwd):/app php:5.6-cli-alpine /bin/sh -c 'apk add --no-cache $PHPIZE_DEPS && pecl install xdebug-2.5.5 && cd app && php -dzend_extension=xdebug.so vendor/bin/phpunit'
Bugs and feature requests are tracked on GitHub.
OpenTracing for Laravel is licensed under the Apache-2.0 license. See the LICENSE file for details.