OTLP Exporter配置

配置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/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
最后修改 December 10, 2023: translate (a4350d6e)