Common access log types

config.accesslog.v3.AccessLog

[config.accesslog.v3.AccessLog proto]

  1. {
  2. "name": "...",
  3. "filter": "{...}",
  4. "typed_config": "{...}"
  5. }

name

(string) The name of the access log implementation to instantiate. The name must match a statically registered access log. Current built-in loggers include:

  1. “envoy.access_loggers.file”

  2. “envoy.access_loggers.http_grpc”

  3. “envoy.access_loggers.tcp_grpc”

filter

(config.accesslog.v3.AccessLogFilter) Filter which is used to determine if the access log needs to be written.

typed_config

(Any) Custom configuration that depends on the access log being instantiated. Built-in configurations include:

  1. “envoy.access_loggers.file”: FileAccessLog

  2. “envoy.access_loggers.http_grpc”: HttpGrpcAccessLogConfig

  3. “envoy.access_loggers.tcp_grpc”: TcpGrpcAccessLogConfig

config.accesslog.v3.AccessLogFilter

[config.accesslog.v3.AccessLogFilter proto]

  1. {
  2. "status_code_filter": "{...}",
  3. "duration_filter": "{...}",
  4. "not_health_check_filter": "{...}",
  5. "traceable_filter": "{...}",
  6. "runtime_filter": "{...}",
  7. "and_filter": "{...}",
  8. "or_filter": "{...}",
  9. "header_filter": "{...}",
  10. "response_flag_filter": "{...}",
  11. "grpc_status_filter": "{...}",
  12. "extension_filter": "{...}"
  13. }

status_code_filter

(config.accesslog.v3.StatusCodeFilter) Status code filter.

Precisely one of status_code_filter, duration_filter, not_health_check_filter, traceable_filter, runtime_filter, and_filter, or_filter, header_filter, response_flag_filter, grpc_status_filter, extension_filter must be set.

duration_filter

(config.accesslog.v3.DurationFilter) Duration filter.

Precisely one of status_code_filter, duration_filter, not_health_check_filter, traceable_filter, runtime_filter, and_filter, or_filter, header_filter, response_flag_filter, grpc_status_filter, extension_filter must be set.

not_health_check_filter

(config.accesslog.v3.NotHealthCheckFilter) Not health check filter.

Precisely one of status_code_filter, duration_filter, not_health_check_filter, traceable_filter, runtime_filter, and_filter, or_filter, header_filter, response_flag_filter, grpc_status_filter, extension_filter must be set.

traceable_filter

(config.accesslog.v3.TraceableFilter) Traceable filter.

Precisely one of status_code_filter, duration_filter, not_health_check_filter, traceable_filter, runtime_filter, and_filter, or_filter, header_filter, response_flag_filter, grpc_status_filter, extension_filter must be set.

runtime_filter

(config.accesslog.v3.RuntimeFilter) Runtime filter.

Precisely one of status_code_filter, duration_filter, not_health_check_filter, traceable_filter, runtime_filter, and_filter, or_filter, header_filter, response_flag_filter, grpc_status_filter, extension_filter must be set.

and_filter

(config.accesslog.v3.AndFilter) And filter.

Precisely one of status_code_filter, duration_filter, not_health_check_filter, traceable_filter, runtime_filter, and_filter, or_filter, header_filter, response_flag_filter, grpc_status_filter, extension_filter must be set.

or_filter

(config.accesslog.v3.OrFilter) Or filter.

Precisely one of status_code_filter, duration_filter, not_health_check_filter, traceable_filter, runtime_filter, and_filter, or_filter, header_filter, response_flag_filter, grpc_status_filter, extension_filter must be set.

header_filter

(config.accesslog.v3.HeaderFilter) Header filter.

Precisely one of status_code_filter, duration_filter, not_health_check_filter, traceable_filter, runtime_filter, and_filter, or_filter, header_filter, response_flag_filter, grpc_status_filter, extension_filter must be set.

response_flag_filter

(config.accesslog.v3.ResponseFlagFilter) Response flag filter.

Precisely one of status_code_filter, duration_filter, not_health_check_filter, traceable_filter, runtime_filter, and_filter, or_filter, header_filter, response_flag_filter, grpc_status_filter, extension_filter must be set.

grpc_status_filter

(config.accesslog.v3.GrpcStatusFilter) gRPC status filter.

Precisely one of status_code_filter, duration_filter, not_health_check_filter, traceable_filter, runtime_filter, and_filter, or_filter, header_filter, response_flag_filter, grpc_status_filter, extension_filter must be set.

extension_filter

(config.accesslog.v3.ExtensionFilter) Extension filter.

Precisely one of status_code_filter, duration_filter, not_health_check_filter, traceable_filter, runtime_filter, and_filter, or_filter, header_filter, response_flag_filter, grpc_status_filter, extension_filter must be set.

config.accesslog.v3.ComparisonFilter

[config.accesslog.v3.ComparisonFilter proto]

Filter on an integer comparison.

  1. {
  2. "op": "...",
  3. "value": "{...}"
  4. }

op

(config.accesslog.v3.ComparisonFilter.Op) Comparison operator.

value

(config.core.v3.RuntimeUInt32) Value to compare against.

Enum config.accesslog.v3.ComparisonFilter.Op

[config.accesslog.v3.ComparisonFilter.Op proto]

EQ

(DEFAULT) ⁣=

GE

⁣>=

LE

⁣<=

config.accesslog.v3.StatusCodeFilter

[config.accesslog.v3.StatusCodeFilter proto]

Filters on HTTP response/status code.

  1. {
  2. "comparison": "{...}"
  3. }

comparison

(config.accesslog.v3.ComparisonFilter, REQUIRED) Comparison.

config.accesslog.v3.DurationFilter

[config.accesslog.v3.DurationFilter proto]

Filters on total request duration in milliseconds.

  1. {
  2. "comparison": "{...}"
  3. }

comparison

(config.accesslog.v3.ComparisonFilter, REQUIRED) Comparison.

config.accesslog.v3.NotHealthCheckFilter

[config.accesslog.v3.NotHealthCheckFilter proto]

Filters for requests that are not health check requests. A health check request is marked by the health check filter.

  1. {}

config.accesslog.v3.TraceableFilter

[config.accesslog.v3.TraceableFilter proto]

Filters for requests that are traceable. See the tracing overview for more information on how a request becomes traceable.

  1. {}

config.accesslog.v3.RuntimeFilter

[config.accesslog.v3.RuntimeFilter proto]

Filters for random sampling of requests.

  1. {
  2. "runtime_key": "...",
  3. "percent_sampled": "{...}",
  4. "use_independent_randomness": "..."
  5. }

runtime_key

(string, REQUIRED) Runtime key to get an optional overridden numerator for use in the percent_sampled field. If found in runtime, this value will replace the default numerator.

percent_sampled

(type.v3.FractionalPercent) The default sampling percentage. If not specified, defaults to 0% with denominator of 100.

use_independent_randomness

(bool) By default, sampling pivots on the header x-request-id being present. If x-request-id is present, the filter will consistently sample across multiple hosts based on the runtime key value and the value extracted from x-request-id. If it is missing, or use_independent_randomness is set to true, the filter will randomly sample based on the runtime key value alone. use_independent_randomness can be used for logging kill switches within complex nested AndFilter and OrFilter blocks that are easier to reason about from a probability perspective (i.e., setting to true will cause the filter to behave like an independent random variable when composed within logical operator filters).

config.accesslog.v3.AndFilter

[config.accesslog.v3.AndFilter proto]

Performs a logical “and” operation on the result of each filter in filters. Filters are evaluated sequentially and if one of them returns false, the filter returns false immediately.

  1. {
  2. "filters": []
  3. }

filters

(config.accesslog.v3.AccessLogFilter, REQUIRED)

config.accesslog.v3.OrFilter

[config.accesslog.v3.OrFilter proto]

Performs a logical “or” operation on the result of each individual filter. Filters are evaluated sequentially and if one of them returns true, the filter returns true immediately.

  1. {
  2. "filters": []
  3. }

filters

(config.accesslog.v3.AccessLogFilter, REQUIRED)

config.accesslog.v3.HeaderFilter

[config.accesslog.v3.HeaderFilter proto]

Filters requests based on the presence or value of a request header.

  1. {
  2. "header": "{...}"
  3. }

header

(config.route.v3.HeaderMatcher, REQUIRED) Only requests with a header which matches the specified HeaderMatcher will pass the filter check.

config.accesslog.v3.ResponseFlagFilter

[config.accesslog.v3.ResponseFlagFilter proto]

Filters requests that received responses with an Envoy response flag set. A list of the response flags can be found in the access log formatter documentation.

  1. {
  2. "flags": []
  3. }

flags

(string) Only responses with the any of the flags listed in this field will be logged. This field is optional. If it is not specified, then any response flag will pass the filter check.

config.accesslog.v3.GrpcStatusFilter

[config.accesslog.v3.GrpcStatusFilter proto]

Filters gRPC requests based on their response status. If a gRPC status is not provided, the filter will infer the status from the HTTP status code.

  1. {
  2. "statuses": [],
  3. "exclude": "..."
  4. }

statuses

(config.accesslog.v3.GrpcStatusFilter.Status) Logs only responses that have any one of the gRPC statuses in this field.

exclude

(bool) If included and set to true, the filter will instead block all responses with a gRPC status or inferred gRPC status enumerated in statuses, and allow all other responses.

Enum config.accesslog.v3.GrpcStatusFilter.Status

[config.accesslog.v3.GrpcStatusFilter.Status proto]

OK

(DEFAULT)

CANCELED

UNKNOWN

INVALID_ARGUMENT

DEADLINE_EXCEEDED

NOT_FOUND

ALREADY_EXISTS

PERMISSION_DENIED

RESOURCE_EXHAUSTED

FAILED_PRECONDITION

ABORTED

OUT_OF_RANGE

UNIMPLEMENTED

INTERNAL

UNAVAILABLE

DATA_LOSS

UNAUTHENTICATED

config.accesslog.v3.ExtensionFilter

[config.accesslog.v3.ExtensionFilter proto]

Extension filter is statically registered at runtime.

  1. {
  2. "name": "...",
  3. "typed_config": "{...}"
  4. }

name

(string) The name of the filter implementation to instantiate. The name must match a statically registered filter.

typed_config

(Any) Custom configuration that depends on the filter being instantiated.