OTLP 导出器配置
终端节点配置
以下环境变量允许您为跟踪、指标、配置文件和日志配置 OTLP/gRPC 或 OTLP/HTTP 终端节点。
OTEL_EXPORTER_OTLP_ENDPOINT
任何信号类型的基本终端节点 URL,可选端口号。当您向同一终端节点发送多个信号并希望一个环境变量来控制终端节点时,此项非常有用。
默认值
- gRPC:
"https://:4317" - HTTP:
"https://: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:
"https://:4317" - HTTP:
"https://: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:
"https://:4317" - HTTP:
"https://: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:
"https://:4317" - HTTP:
"https://: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"
OTEL_EXPORTER_OTLP_PROFILES_ENDPOINT
仅配置文件数据的终端节点 URL,可选端口号。使用 OTLP/HTTP 时,通常以 v1/profiles 结尾。
默认值
- gRPC:
"https://:4317" - HTTP:
"https://:4318/v1/profiles"
示例
- gRPC:
export OTEL_EXPORTER_OTLP_PROFILES_ENDPOINT="https://my-api-endpoint:443" - HTTP:
export OTEL_EXPORTER_OTLP_PROFILES_ENDPOINT="http://my-api-endpoint/v1/profiles"
Header 配置
以下环境变量允许您将其他 Header 配置为键值对列表,添加到出站 gRPC 或 HTTP 请求中。
OTEL_EXPORTER_OTLP_HEADERS
应用于所有出站数据(跟踪、指标和日志)的 Header 列表。
默认值: N/A
示例: export OTEL_EXPORTER_OTLP_HEADERS="api-key=key,other-config-value=value"
OTEL_EXPORTER_OTLP_TRACES_HEADERS
应用于所有出站跟踪的 Header 列表。
默认值: N/A
示例: export OTEL_EXPORTER_OTLP_TRACES_HEADERS="api-key=key,other-config-value=value"
OTEL_EXPORTER_OTLP_METRICS_HEADERS
应用于所有出站指标的 Header 列表。
默认值: N/A
示例: export OTEL_EXPORTER_OTLP_METRICS_HEADERS="api-key=key,other-config-value=value"
OTEL_EXPORTER_OTLP_LOGS_HEADERS
应用于所有出站日志的 Header 列表。
默认值: N/A
示例: export OTEL_EXPORTER_OTLP_LOGS_HEADERS="api-key=key,other-config-value=value"
OTEL_EXPORTER_OTLP_PROFILES_HEADERS
应用于所有出站配置文件的 Header 列表。
默认值: None
示例: export OTEL_EXPORTER_OTLP_PROFILES_HEADERS="api-key=key,other-config-value=value"
超时配置
以下环境变量配置 OTLP 导出器在传输下一批数据之前将等待的最大时间(以毫秒为单位)。
OTEL_EXPORTER_OTLP_TIMEOUT
所有出站数据(跟踪、指标和日志)的超时值(以毫秒为单位)。
默认值: 10000 (10s)
示例: export OTEL_EXPORTER_OTLP_TIMEOUT=500
OTEL_EXPORTER_OTLP_TRACES_TIMEOUT
所有出站跟踪的超时值(以毫秒为单位)。
默认值: 10000 (10s)
示例: export OTEL_EXPORTER_OTLP_TRACES_TIMEOUT=500
OTEL_EXPORTER_OTLP_METRICS_TIMEOUT
所有出站指标的超时值(以毫秒为单位)。
默认值: 10000 (10s)
示例: export OTEL_EXPORTER_OTLP_METRICS_TIMEOUT=500
OTEL_EXPORTER_OTLP_LOGS_TIMEOUT
所有出站日志的超时值(以毫秒为单位)。
默认值: 10000 (10s)
示例: export OTEL_EXPORTER_OTLP_LOGS_TIMEOUT=500
OTEL_EXPORTER_OTLP_PROFILES_TIMEOUT
所有出站配置文件的超时值(以毫秒为单位)。
默认值: 10000 (10s)
示例: export OTEL_EXPORTER_OTLP_PROFILES_TIMEOUT=500
协议配置
以下环境变量配置 OTLP 导出器使用的 OTLP 传输协议。
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
OTEL_EXPORTER_OTLP_LOGS_PROTOCOL
指定用于日志数据的 OTLP 传输协议。
默认值: 依赖于 SDK,但通常为 http/protobuf 或 grpc。
示例: export OTEL_EXPORTER_OTLP_LOGS_PROTOCOL=grpc
有效值包括:
grpc用于 OTLP/gRPChttp/protobuf用于 OTLP/HTTP + protobufhttp/json用于 OTLP/HTTP + JSON
OTEL_EXPORTER_OTLP_PROFILES_PROTOCOL
指定用于配置文件数据的 OTLP 传输协议。
默认值: 依赖于 SDK,但通常为 http/protobuf 或 grpc。
示例: export OTEL_EXPORTER_OTLP_PROFILES_PROTOCOL=grpc
有效值包括:
grpc用于 OTLP/gRPChttp/protobuf用于 OTLP/HTTP + protobufhttp/json用于 OTLP/HTTP + JSON