跳到主要内容

OTLP 导出器配置

端点配置​

以下环境变量允许您为跟踪、指标和日志配置 OTLP/gRPC 或 OTLP/HTTP 端点。

OTEL_EXPORTER_OTLP_ENDPOINT​

任何信号类型的基本端点 URL，可以选择指定端口号。当您向同一端点发送多个信号并希望用一个环境变量控制端点时，这非常有用。

默认值：

  • gRPC: "http://localhost:54317"
  • HTTP: "http://localhost:54318"

示例：

  • 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:54317"
  • HTTP: "http://localhost:54318/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:54317"
  • HTTP: "http://localhost:54318/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:54317"
  • HTTP: "http://localhost:54318/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"

头配置​

以下环境变量允许您配置附加头作为键值对列表，以添加到传出的 gRPC 或 HTTP 请求中。

OTEL_EXPORTER_OTLP_HEADERS​

应用于所有传出数据（跟踪、指标和日志）的头列表。

默认值： N/A

示例： export OTEL_EXPORTER_OTLP_HEADERS="api-key=key,other-config-value=value"

OTEL_EXPORTER_OTLP_TRACES_HEADERS​

应用于所有传出跟踪的头列表。

默认值： N/A

示例： export OTEL_EXPORTER_OTLP_TRACES_HEADERS="api-key=key,other-config-value=value"

OTEL_EXPORTER_OTLP_METRICS_HEADERS​

应用于所有传出指标的头列表。

默认值： N/A

示例： export OTEL_EXPORTER_OTLP_METRICS_HEADERS="api-key=key,other-config-value=value"

OTEL_EXPORTER_OTLP_LOGS_HEADERS​

应用于所有传出日志的头列表。

默认值： N/A

示例： export OTEL_EXPORTER_OTLP_LOGS_HEADERS="api-key=key,other-config-value=value"

超时配置​

以下环境变量配置 OTLP 导出器在传输下一批数据前等待的最大时间（以毫秒为单位）。

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

协议配置​

以下环境变量配置 OTLP 导出器使用的 OTLP 传输协议。

OTEL_EXPORTER_OTLP_PROTOCOL​

指定用于所有遥测数据的 OTLP 传输协议。

默认值： 取决于 SDK，但通常是 http/protobuf 或 grpc。

示例： 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/protobuf 或 grpc。

示例： 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/protobuf 或 grpc。

示例： 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/protobuf 或 grpc。

示例： export OTEL_EXPORTER_OTLP_LOGS_PROTOCOL=grpc

有效值为：

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