Language Independent Interface Types For OpenTelemetry
The proto files can be consumed as GIT submodules or copied and built directly in the consumer project.
The compiled files are published to central repositories (Maven, NPM...) from OpenTelemetry client libraries.
See contribution guidelines if you would like to make any changes.
Generate gRPC Client Libraries
To generate the raw gRPC client libraries, use make gen-${LANGUAGE}. Currently supported languages are:
- cpp
- csharp
- go
- java
- objc
- openapi (swagger)
- php
- python
- ruby
Maturity Level
| Component | Maturity |
|---|---|
| Binary Protobuf Encoding | |
| collector/metrics/* | Stable |
| collector/trace/* | Stable |
| collector/logs/* | Beta |
| common/* | Stable |
| metrics/* | Stable |
| resource/* | Stable |
| trace/trace.proto | Stable |
| trace/trace_config.proto | Alpha |
| logs/* | Beta |
| JSON encoding | |
| All messages | Alpha |
(See maturity-matrix.yaml for definition of maturity levels).
Note that maturity guarantees apply only to wire-level compatibility for the binary Protobuf serialization. Neither message, field, nor enum names of Protobuf messages are visible on the wire and are not considered part of the guarantees. We are free to make a change to the names.
In the future when OTLP/JSON is declared stable, field names will also become part of the maturity guarantees, since field names are visible on the wire for JSON encoding.
Experiments
In some cases we are trying to experiment with different features. In this case, we recommend using an "experimental" sub-directory instead of adding them to any protocol version. These protocols should not be used, except for development/testing purposes.
Another review must be conducted for experimental protocols to join the main project.