opencensus / opencensus-exporter-jaeger
OpenCensus Jaeger Exporter for PHP
Requires
- php-64bit: >=5.6
- ext-sockets: *
- apache/thrift: ^0.11
- opencensus/opencensus: ~0.4
Requires (Dev)
- guzzlehttp/guzzle: ~6.0
- phpunit/phpunit: ^5.0
- squizlabs/php_codesniffer: 2.*
This package is not auto-updated.
Last update: 2023-08-01 17:34:19 UTC
README
Warning
OpenCensus and OpenTracing have merged to form OpenTelemetry, which serves as the next major version of OpenCensus and OpenTracing.
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.
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.
OpenCensus Jaeger Exporter for PHP
This library provides an ExporterInterface
for exporting
Trace data to a Jaeger instance using Thrift (Compact Protocol) over UDP.
Requirements
- PHP >= 5.6
- 64-bit version of PHP
Installation & basic usage
-
Install the
opencensus/opencensus-exporter-jaeger
package using composer:$ composer require opencensus/opencensus-exporter-jaeger:~0.1
-
Initialize a tracer for your application:
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:
$options = []; $exporter = new JaegerExporter('my-service-name', $options);
The following options are available:
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
This library follows Semantic Versioning.
Please note it is currently under active development. Any release versioned 0.x.y is subject to backwards incompatible changes at any time.
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.
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.
Alpha: Libraries defined at an Alpha quality level are still a work-in-progress and are more likely to get backwards-incompatible updates.
Current Status: Alpha
Contributing
Contributions to this library are always welcome and highly encouraged.
See CONTRIBUTING for more information on how to get started.
Releasing
See RELEASING for more information on releasing new versions.
License
Apache 2.0 - See LICENSE for more information.
Disclaimer
This is not an official Google product.