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/protobufgrpc

示例: export OTEL_EXPORTER_OTLP_PROTOCOL=grpc

有效值包括:

  • grpc 用于 OTLP/gRPC
  • http/protobuf 用于 OTLP/HTTP + protobuf
  • http/json 用于 OTLP/HTTP + JSON

OTEL_EXPORTER_OTLP_TRACES_PROTOCOL

指定用于跟踪数据的 OTLP 传输协议。

默认值: 依赖于 SDK,但通常为 http/protobufgrpc

示例: export OTEL_EXPORTER_OTLP_TRACES_PROTOCOL=grpc

有效值包括:

  • grpc 用于 OTLP/gRPC
  • http/protobuf 用于 OTLP/HTTP + protobuf
  • http/json 用于 OTLP/HTTP + JSON

OTEL_EXPORTER_OTLP_METRICS_PROTOCOL

指定用于指标数据的 OTLP 传输协议。

默认值: 依赖于 SDK,但通常为 http/protobufgrpc

示例: export OTEL_EXPORTER_OTLP_METRICS_PROTOCOL=grpc

有效值包括:

  • grpc 用于 OTLP/gRPC
  • http/protobuf 用于 OTLP/HTTP + protobuf
  • http/json 用于 OTLP/HTTP + JSON

OTEL_EXPORTER_OTLP_LOGS_PROTOCOL

指定用于日志数据的 OTLP 传输协议。

默认值: 依赖于 SDK,但通常为 http/protobufgrpc

示例: export OTEL_EXPORTER_OTLP_LOGS_PROTOCOL=grpc

有效值包括:

  • grpc 用于 OTLP/gRPC
  • http/protobuf 用于 OTLP/HTTP + protobuf
  • http/json 用于 OTLP/HTTP + JSON

OTEL_EXPORTER_OTLP_PROFILES_PROTOCOL

指定用于配置文件数据的 OTLP 传输协议。

默认值: 依赖于 SDK,但通常为 http/protobufgrpc

示例: export OTEL_EXPORTER_OTLP_PROFILES_PROTOCOL=grpc

有效值包括:

  • grpc 用于 OTLP/gRPC
  • http/protobuf 用于 OTLP/HTTP + protobuf
  • http/json 用于 OTLP/HTTP + JSON