32 lines
1.7 KiB
Markdown
32 lines
1.7 KiB
Markdown
|
[](https://github.com/opentelemetry-php/gen-otlp-protobuf/releases)
|
||
|
|
[](https://github.com/open-telemetry/opentelemetry-php/tree/main/proto/otel)
|
||
|
|
[](https://github.com/opentelemetry-php/gen-otlp-protobuf)
|
||
|
|
[](https://packagist.org/packages/open-telemetry/gen-otlp-protobuf/)
|
||
|
|
[](https://packagist.org/packages/open-telemetry/gen-otlp-protobuf/)
|
||
|
|
|
||
|
|
# OpenTelemetry protobuf files
|
||
|
|
|
||
|
|
## Protobuf Runtime library
|
||
|
|
|
||
|
|
OTLP exporting requires a [protobuf runtime library](https://github.com/protocolbuffers/protobuf/tree/main/php).
|
||
|
|
|
||
|
|
There exist two protobuf runtime libraries that offer the same set of APIs, allowing developers to choose the one that
|
||
|
|
best suits their needs.
|
||
|
|
|
||
|
|
This package requires `google/protobuf`, which is the native implementation. It is easy to install and a good way to get
|
||
|
|
started quickly.
|
||
|
|
|
||
|
|
Alternatively, and the recommended option for production is to install the Protobuf C extension for PHP. The extension
|
||
|
|
makes OTLP exporting _significantly_ more performant. The extension can be installed with the following command:
|
||
|
|
|
||
|
|
```shell
|
||
|
|
pecl install protobuf
|
||
|
|
```
|
||
|
|
|
||
|
|
The extension can be installed alongside the native library, and it will be used instead if available.
|
||
|
|
|
||
|
|
## Contributing
|
||
|
|
|
||
|
|
This repository is a read-only git subtree split.
|
||
|
|
To contribute, please see the main [OpenTelemetry PHP monorepo](https://github.com/open-telemetry/opentelemetry-php).
|