https://github.com/census-ecosystem/opencensus-php-exporter-stackdriver
OpenCensus PHP exporters for Google Stackdriver
https://github.com/census-ecosystem/opencensus-php-exporter-stackdriver
Last synced: about 1 year ago
JSON representation
OpenCensus PHP exporters for Google Stackdriver
- Host: GitHub
- URL: https://github.com/census-ecosystem/opencensus-php-exporter-stackdriver
- Owner: census-ecosystem
- License: apache-2.0
- Archived: true
- Created: 2018-03-30T22:48:58.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2023-05-02T19:20:28.000Z (about 3 years ago)
- Last Synced: 2025-04-26T17:47:51.832Z (about 1 year ago)
- Language: PHP
- Homepage:
- Size: 34.2 KB
- Stars: 10
- Watchers: 12
- Forks: 17
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Authors: AUTHORS
Awesome Lists containing this project
README
> **Warning**
>
> OpenCensus and OpenTracing have merged to form [OpenTelemetry](https://opentelemetry.io), 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](https://github.com/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**](https://opentelemetry.io/blog/2023/sunsetting-opencensus/).
# OpenCensus Stackdriver Exporter for PHP
This library provides an [`ExporterInterface`][exporter-interface] for exporting
Trace data to the [Stackdriver Trace][stackdriver-trace] service.
[][ci-build]
[][packagist-package]
## Installation & basic usage
1. Install the `opencensus/opencensus-exporter-stackdriver` package using [composer][composer]:
```bash
$ composer require opencensus/opencensus-exporter-stackdriver:~0.1
```
1. Initialize a tracer for your application:
```php
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:
```php
$options = [];
$exporter = new StackdriverExporter($options);
```
The following options are available:
| Option | Default | Description |
| ------ | ------- | ----------- |
| `client` | `new TraceClient($clientConfig)` | A configured [`TraceClient`][trace-client] to use to export traces |
| `clientConfig` | `[]` | Options to pass to the default TraceClient |
## Versioning
[][packagist-package]
This library follows [Semantic Versioning][semver].
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](CONTRIBUTING.md) for more information on how to get started.
## Releasing
See [RELEASING](RELEASING.md) for more information on releasing new versions.
## License
Apache 2.0 - See [LICENSE](LICENSE) for more information.
## Disclaimer
This is not an official Google product.
[exporter-interface]: https://github.com/census-instrumentation/opencensus-php/blob/master/src/Trace/Exporter/ExporterInterface.php
[stackdriver-trace]: https://cloud.google.com/trace/
[census-org]: https://github.com/census-instrumentation
[composer]: https://getcomposer.org/
[semver]: http://semver.org/
[trace-client]: https://googlecloudplatform.github.io/google-cloud-php/#/docs/google-cloud/v0.59.0/trace/traceclient
[google-cloud-php]: https://github.com/GoogleCloudPlatform/google-cloud-php
[packagist-package]: https://packagist.org/packages/opencensus/opencensus-exporter-stackdriver
[ci-build]: https://circleci.com/gh/census-ecosystem/opencensus-php-exporter-stackdriver