Download the PHP package quinluong/tracing-php without Composer
On this page you can find all versions of the php package quinluong/tracing-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package tracing-php
tracing-php
Required reading
In order to understand the library, one must first be familiar with the OpenTracing project and specification more specifically.
Installation
This library can be installed via Composer:
Usage
Creating new tracer using TracerFactory
Extracting span context from request header
Injecting span context into request header
Creating span
For most use cases, it is recommended that you use the TracerInterface::startActiveSpan function for
creating new spans.
An example of a linear, two level deep span tree using active spans looks like this in PHP code:
When using the TracerInterface::startActiveSpan function the underlying tracer uses an
abstraction called scope manager to keep track of the currently active span.
Starting an active span will always use the currently active span as a parent. If no parent is available, then the newly created span is considered to be the root span of the trace.
Unless you are using asynchronous code that tracks multiple spans at the same
time, such as when using cURL Multi Exec or MySQLi Polling it is recommended that you
use TracerInterface::startActiveSpan everywhere in your application.
The currently active span gets automatically finished when you call $scope->close()
as you can see in the previous examples.
Creating a child span using automatic active span management
Creating a child span assigning parent manually
Tags and logs
Flushing spans
PHP as a request scoped language has no simple means to pass the collected spans data to a background process without blocking the main request thread/process. The OpenTracing API makes no assumptions about this, but for PHP that might cause problems for Tracer implementations. This is why the PHP API contains a flush method that allows to trigger a span sending out of process.
