Warning, (*1)
OpenCensus and OpenTracing have merged to form OpenTelemetry, which serves as the next major version of OpenCensus and OpenTracing., (*2)
OpenTelemetry has now reached feature parity with OpenCensus, with tracing and metrics SDKs available in .NET, Golang, Java, NodeJS, and Python. All OpenCensus Github repositories, except census-instrumentation/opencensus-python, will be archived on July 31st, 2023. We encourage users to migrate to OpenTelemetry by this date., (*3)
To help you gradually migrate your instrumentation to OpenTelemetry, bridges are available in Java, Go, Python, and JS. Read the full blog post to learn more., (*4)
OpenCensus Jaeger Exporter for PHP
This library provides an ExporterInterface
for exporting
Trace data to a Jaeger instance using Thrift (Compact Protocol) over UDP., (*5)
, (*6)
Requirements
- PHP >= 5.6
- 64-bit version of PHP
Installation & basic usage
-
Install the opencensus/opencensus-exporter-jaeger
package using composer:, (*7)
$ composer require opencensus/opencensus-exporter-jaeger:~0.1
-
Initialize a tracer for your application:, (*8)
use OpenCensus\Trace\Tracer;
use OpenCensus\Trace\Exporter\JaegerExporter;
Tracer::start(new JaegerExporter('my-service-name'));
Customization
You may provide an associative array of options to the JaegerExporter
at
initialization:, (*9)
$options = [];
$exporter = new JaegerExporter('my-service-name', $options);
The following options are available:, (*10)
Option |
Default |
Description |
host |
"127.0.0.1" |
The TCP IP address to send the UDP request to |
port |
6831 |
The TCP port to send the UDP request to |
tags |
(empty) |
An associative array of tags to mark this process with |
client |
null |
Optional AgentIf interface to use for testing |
Versioning
, (*11)
This library follows Semantic Versioning., (*12)
Please note it is currently under active development. Any release versioned
0.x.y is subject to backwards incompatible changes at any time., (*13)
GA: Libraries defined at a GA quality level are stable, and will not
introduce backwards-incompatible changes in any minor or patch releases. We will
address issues and requests with the highest priority., (*14)
Beta: Libraries defined at a Beta quality level are expected to be mostly
stable and we're working towards their release candidate. We will address issues
and requests with a higher priority., (*15)
Alpha: Libraries defined at an Alpha quality level are still a
work-in-progress and are more likely to get backwards-incompatible updates., (*16)
Current Status: Alpha, (*17)
Contributing
Contributions to this library are always welcome and highly encouraged., (*18)
See CONTRIBUTING for more information on how to get started., (*19)
Releasing
See RELEASING for more information on releasing new versions., (*20)
License
Apache 2.0 - See LICENSE for more information., (*21)
Disclaimer
This is not an official Google product., (*22)