File access log¶

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

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:

envoy.access_loggers

config.accesslog.v2.FileAccessLog¶

[config.accesslog.v2.FileAccessLog proto]

Custom configuration for an AccessLog that writes log entries directly to a file. Configures the built-in envoy.access_loggers.file AccessLog.

{
  "path": "...",
  "format": "...",
  "json_format": "{...}",
  "typed_json_format": "{...}"
}

path: (string, REQUIRED) A path to a local file to which to write the access log entries.

format

(string) Access log format string. Envoy supports custom access log formats as well as a default format.

Only one of format, json_format, typed_json_format may be set.

json_format

(Struct) Access log format dictionary. All values are rendered as strings.

Only one of format, json_format, typed_json_format may be set.

typed_json_format

(Struct) Access log format dictionary. Values are rendered as strings, numbers, or boolean values as appropriate. Nested JSON objects may be produced by some command operators (e.g.FILTER_STATE or DYNAMIC_METADATA). See the documentation for a specific command operator for details.

Only one of format, json_format, typed_json_format may be set.