Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/census-ecosystem/opencensus-php-exporter-zipkin
OpenCensus PHP exporters for Zipkin
https://github.com/census-ecosystem/opencensus-php-exporter-zipkin
Last synced: 3 months ago
JSON representation
OpenCensus PHP exporters for Zipkin
- Host: GitHub
- URL: https://github.com/census-ecosystem/opencensus-php-exporter-zipkin
- Owner: census-ecosystem
- License: apache-2.0
- Archived: true
- Created: 2018-03-30T22:49:13.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-05-02T19:13:57.000Z (about 1 year ago)
- Last Synced: 2024-03-18T05:23:08.279Z (3 months ago)
- Language: PHP
- Homepage:
- Size: 29.3 KB
- Stars: 2
- Watchers: 13
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Authors: AUTHORS
Lists
- awesome-opencensus - ZipkinExporter
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 Zipkin Exporter for PHP
This library provides an [`ExporterInterface`][exporter-interface] for exporting
Trace data to a Zipkin instance.
[][ci-build]
[][packagist-package]
## Installation & basic usage
1. Install the `opencensus/opencensus-exporter-zipkin` package using [composer][composer]:
```bash
$ composer require opencensus/opencensus-exporter-zipkin:~0.1
```
1. Initialize a tracer for your application:
```php
use OpenCensus\Trace\Tracer;
use OpenCensus\Trace\Exporter\ZipkinExporter;
Tracer::start(new ZipkinExporter('my-service-name'));
```
## Customization
### Configuring the Zipkin endpoint
You may provide an optional initialization parameter for the Zipkin endpoint.
This value should be a full URL to the v2 spans endpoint.
```php
$exporter = new ZipkinExporter('my-service-name', 'http://example.com:9411/api/v2/spans');
```
### Configuring the local IPv4 or IPv6 address
Zipkin allows you to optionally specify the host IP address of the server that
is handling the traced requests.
For IPv4:
```php
// gethostbyname may make a DNS query, so you may want to cache this
$ipv4 = gethostbyname(gethostname());
$exporter->setLocalIpv4($ipv4);
```
Similarly, you may set the local IPv6 address if you can obtain it:
```php
$exporter->setLocalIpv6($ipv6);
```
## 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
[census-org]: https://github.com/census-instrumentation
[composer]: https://getcomposer.org/
[semver]: http://semver.org/
[ci-build]: https://circleci.com/gh/census-ecosystem/opencensus-php-exporter-zipkin
[packagist-package]: https://packagist.org/packages/opencensus/opencensus-exporter-zipkin