OTLP Exporter配置
端点配置
以下环境变量可用于配置你的跟踪、指标和日志的OTLP/gRPC或OTLP/HTTP端点。
OTEL_EXPORTER_OTLP_ENDPOINT
用于任何信号类型的基本端点URL,可以选择指定端口号。当你向同一端点发送多个信号并且希望使用一个环境变量控制该端点时,这非常有用。
默认值:
- gRPC:“http://localhost:4317”
- HTTP:“http://localhost:4318”
示例:
- gRPC:
export OTEL_EXPORTER_OTLP_ENDPOINT="https://my-api-endpoint:443"
- HTTP:
export OTEL_EXPORTER_OTLP_ENDPOINT="http://my-api-endpoint/"
对于OTLP/HTTP,当设置了此环境变量时,SDK中的导出器会构建特定于信号的URL。这意味着如果你发送跟踪、指标和日志,以下URL将从上述示例中构建出来:
- 跟踪:“http://my-api-endpoint/v1/traces”
- 指标:“http://my-api-endpoint/v1/metrics”
- 日志:“http://my-api-endpoint/v1/logs”
OTEL_EXPORTER_OTLP_TRACES_ENDPOINT
仅用于跟踪数据的端点URL,可以选择指定端口号。当使用OTLP/HTTP时,通常以v1/traces
结束。
默认值:
- gRPC:“http://localhost:4317”
- HTTP:“http://localhost:4318/v1/traces”
示例:
- gRPC:
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="https://my-api-endpoint:443"
- HTTP:
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="http://my-api-endpoint/v1/traces"
OTEL_EXPORTER_OTLP_METRICS_ENDPOINT
仅用于指标数据的端点URL,可以选择指定端口号。当使用OTLP/HTTP时,通常以v1/metrics
结束。
默认值:
- gRPC:“http://localhost:4317”
- HTTP:“http://localhost:4318/v1/metrics”
示例:
- gRPC:
export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT="https://my-api-endpoint:443"
- HTTP:
export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT="http://my-api-endpoint/v1/metrics"
OTEL_EXPORTER_OTLP_LOGS_ENDPOINT
仅用于日志数据的端点URL,可以选择指定端口号。当使用OTLP/HTTP时,通常以v1/logs
结束。
默认值:
- gRPC:“http://localhost:4317”
- HTTP:“http://localhost:4318/v1/logs”
示例:
- gRPC:
export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT="https://my-api-endpoint:443"
- HTTP:
export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT="http://my-api-endpoint/v1/logs"
Header配置
以下环境变量可用于将额外的头信息配置为出站gRPC或HTTP请求中的键值对列表。
OTEL_EXPORTER_OTLP_HEADERS
要应用于所有出站数据(跟踪、指标和日志)的头信息列表。
默认值: 无
示例:
export OTEL_EXPORTER_OTLP_HEADERS="api-key=key,other-config-value=value"
OTEL_EXPORTER_OTLP_TRACES_HEADERS
要应用于所有出站跟踪的头信息列表。
默认值: 无
示例:
export OTEL_EXPORTER_OTLP_TRACES_HEADERS="api-key=key,other-config-value=value"
OTEL_EXPORTER_OTLP_METRICS_HEADERS
要应用于所有出站指标的头信息列表。
默认值: 无
示例:
export OTEL_EXPORTER_OTLP_METRICS_HEADERS="api-key=key,other-config-value=value"
OTEL_EXPORTER_OTLP_LOGS_HEADERS
要应用于所有出站日志的头信息列表。
默认值: 无
示例:
export OTEL_EXPORTER_OTLP_LOGS_HEADERS="api-key=key,other-config-value=value"
超时配置
以下环境变量配置了OTLP Exporter在传输最新批量数据之前等待的最大时间(以毫秒为单位)。
OTEL_EXPORTER_OTLP_TIMEOUT
所有出站数据(跟踪、指标和日志)的超时值,以毫秒为单位。
默认值: 10000
(10秒)
示例: export OTEL_EXPORTER_OTLP_TIMEOUT=500
OTEL_EXPORTER_OTLP_TRACES_TIMEOUT
所有出站跟踪的超时值,以毫秒为单位。
默认值: 10000
(10秒)
示例: export OTEL_EXPORTER_OTLP_TRACES_TIMEOUT=500
OTEL_EXPORTER_OTLP_METRICS_TIMEOUT
所有出站指标的超时值,以毫秒为单位。
默认值: 10000
(10秒)
示例: export OTEL_EXPORTER_OTLP_METRICS_TIMEOUT=500
OTEL_EXPORTER_OTLP_LOGS_TIMEOUT
所有出站日志的超时值,以毫秒为单位。
默认值: 10000
(10秒)
示例: export OTEL_EXPORTER_OTLP_LOGS_TIMEOUT=500
OTEL_EXPORTER_OTLP_PROTOCOL
指定用于所有遥测数据的OTLP传输协议。
默认值: 根据SDK而定,但通常为http/protobuf
或 grpc
。
示例: export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
有效值有:
grpc
:使用OTLP/gRPChttp/protobuf
:使用OTLP/HTTP + protobufhttp/json
:使用OTLP/HTTP + JSON
OTEL_EXPORTER_OTLP_TRACES_PROTOCOL
指定用于跟踪数据的OTLP传输协议。
默认值: 根据SDK而定,但通常为http/protobuf
或 grpc
。
示例: export OTEL_EXPORTER_OTLP_TRACES_PROTOCOL=grpc
有效值有:
grpc
:使用OTLP/gRPChttp/protobuf
:使用OTLP/HTTP + protobufhttp/json
:使用OTLP/HTTP + JSON
OTEL_EXPORTER_OTLP_METRICS_PROTOCOL
指定用于指标数据的OTLP传输协议。
默认值: 根据SDK而定,但通常为http/protobuf
或 grpc
。
示例: export OTEL_EXPORTER_OTLP_METRICS_PROTOCOL=grpc
有效值有:
grpc
:使用OTLP/gRPChttp/protobuf
:使用OTLP/HTTP + protobufhttp/json
:使用OTLP/HTTP + JSON