mirror of
https://github.com/open-telemetry/opentelemetry-go.git
synced 2024-12-16 10:19:23 +02:00
931266483d
* Fix per-signal endpoint parsing in otlptrace * Add distinguishing non-per-signal env var value * Fix per-signal endpoint parsing in otlpmetric * Add changes to changelog * Use else if to prevent unnecessary work * Add spec link to otlptrace README
50 lines
3.0 KiB
Markdown
50 lines
3.0 KiB
Markdown
# OpenTelemetry-Go OTLP Span Exporter
|
|
|
|
[](https://pkg.go.dev/go.opentelemetry.io/otel/exporters/otlp/otlptrace)
|
|
|
|
[OpenTelemetry Protocol Exporter](https://github.com/open-telemetry/opentelemetry-specification/blob/v1.5.0/specification/protocol/exporter.md) implementation.
|
|
|
|
## Installation
|
|
|
|
```
|
|
go get -u go.opentelemetry.io/otel/exporters/otlp/otlptrace
|
|
```
|
|
|
|
## Examples
|
|
|
|
- [Exporter setup and examples](./otlptracehttp/example_test.go)
|
|
- [Full example sending telemetry to a local collector](../../../example/otel-collector)
|
|
|
|
## [`otlptrace`](https://pkg.go.dev/go.opentelemetry.io/otel/exporters/otlp/otlptrace)
|
|
|
|
The `otlptrace` package provides an exporter implementing the OTel span exporter interface.
|
|
This exporter is configured using a client satisfying the `otlptrace.Client` interface.
|
|
This client handles the transformation of data into wire format and the transmission of that data to the collector.
|
|
|
|
## [`otlptracegrpc`](https://pkg.go.dev/go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc)
|
|
|
|
The `otlptracegrpc` package implements a client for the span exporter that sends trace telemetry data to the collector using gRPC with protobuf-encoded payloads.
|
|
|
|
## [`otlptracehttp`](https://pkg.go.dev/go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp)
|
|
|
|
The `otlptracehttp` package implements a client for the span exporter that sends trace telemetry data to the collector using HTTP with protobuf-encoded payloads.
|
|
|
|
## Configuration
|
|
|
|
### Environment Variables
|
|
|
|
The following environment variables can be used (instead of options objects) to
|
|
override the default configuration. For more information about how each of
|
|
these environment variables is interpreted, see [the OpenTelemetry
|
|
specification](https://github.com/open-telemetry/opentelemetry-specification/blob/v1.8.0/specification/protocol/exporter.md).
|
|
|
|
| Environment variable | Option | Default value |
|
|
| ------------------------------------------------------------------------ |------------------------------ | ----------------------------------- |
|
|
| `OTEL_EXPORTER_OTLP_ENDPOINT` `OTEL_EXPORTER_OTLP_TRACES_ENDPOINT` | `WithEndpoint` `WithInsecure` | `https://localhost:4317` |
|
|
| `OTEL_EXPORTER_OTLP_CERTIFICATE` `OTEL_EXPORTER_OTLP_TRACES_CERTIFICATE` | `WithTLSClientConfig` | |
|
|
| `OTEL_EXPORTER_OTLP_HEADERS` `OTEL_EXPORTER_OTLP_TRACES_HEADERS` | `WithHeaders` | |
|
|
| `OTEL_EXPORTER_OTLP_COMPRESSION` `OTEL_EXPORTER_OTLP_TRACES_COMPRESSION` | `WithCompression` | |
|
|
| `OTEL_EXPORTER_OTLP_TIMEOUT` `OTEL_EXPORTER_OTLP_TRACES_TIMEOUT` | `WithTimeout` | `10s` |
|
|
|
|
Configuration using options have precedence over the environment variables.
|