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 Stackdriver Exporter for PHP
This library provides an ExporterInterface
for exporting
Trace data to the Stackdriver Trace service., (*5)
, (*6)
Installation & basic usage
-
Install the opencensus/opencensus-exporter-stackdriver
package using composer:, (*7)
$ composer require opencensus/opencensus-exporter-stackdriver:~0.1
-
Initialize a tracer for your application:, (*8)
use OpenCensus\Trace\Tracer;
use OpenCensus\Trace\Exporter\StackdriverExporter;
Tracer::start(new StackdriverExporter());
Customization
You may provide an associative array of options to the StackdriverExporter
at
initialization:, (*9)
$options = [];
$exporter = new StackdriverExporter($options);
The following options are available:, (*10)
Option |
Default |
Description |
client |
new TraceClient($clientConfig) |
A configured TraceClient to use to export traces |
clientConfig |
[] |
Options to pass to the default TraceClient |
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)