OpenTelemetry (gRPC) Access Log¶

Warning

This API is work-in-progress and is subject to breaking changes.

extensions.access_loggers.open_telemetry.v3alpha.OpenTelemetryAccessLogConfig¶

Configuration for the built-in envoy.access_loggers.open_telemetry AccessLog. This configuration will populate opentelemetry.proto.collector.v1.logs.ExportLogsServiceRequest.resource_logs. OpenTelemetry Resource attributes are filled with Envoy node info. In addition, the request start time is set in the dedicated field.

This extension may be referenced by the qualified name envoy.access_loggers.open_telemetry

Note

This extension is intended to be robust against untrusted downstream traffic. It assumes that the upstream is trusted.

Tip

This extension extends and can be used with the following extension category:

{
  "common_config": "{...}",
  "body": "{...}",
  "attributes": "{...}"
}

common_config: (extensions.access_loggers.grpc.v3.CommonGrpcAccessLogConfig, REQUIRED)

body

(.opentelemetry.proto.common.v1.AnyValue) OpenTelemetry LogResource fields, following Envoy access logging formatting.

See ‘body’ in the LogResource proto for more details. Example: body { string_value: "%PROTOCOL%" }.

attributes: (.opentelemetry.proto.common.v1.KeyValueList) See ‘attributes’ in the LogResource proto for more details. Example: attributes { values { key: "user_agent" value { string_value: "%REQ(USER-AGENT)%" } } }.