.. _envoy_api_file_envoy/config/accesslog/v2/file.proto: File access log =============== .. _extension_envoy.access_loggers.file: 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. .. _envoy_api_msg_config.accesslog.v2.FileAccessLog: config.accesslog.v2.FileAccessLog --------------------------------- `[config.accesslog.v2.FileAccessLog proto] `_ Custom configuration for an :ref:`AccessLog ` that writes log entries directly to a file. Configures the built-in *envoy.access_loggers.file* AccessLog. .. code-block:: json { "path": "...", "format": "...", "json_format": "{...}", "typed_json_format": "{...}" } .. _envoy_api_field_config.accesslog.v2.FileAccessLog.path: path (`string `_, *REQUIRED*) A path to a local file to which to write the access log entries. .. _envoy_api_field_config.accesslog.v2.FileAccessLog.format: format (`string `_) Access log :ref:`format string`. Envoy supports :ref:`custom access log formats ` as well as a :ref:`default format `. Only one of :ref:`format `, :ref:`json_format `, :ref:`typed_json_format ` may be set. .. _envoy_api_field_config.accesslog.v2.FileAccessLog.json_format: json_format (`Struct `_) Access log :ref:`format dictionary`. All values are rendered as strings. Only one of :ref:`format `, :ref:`json_format `, :ref:`typed_json_format ` may be set. .. _envoy_api_field_config.accesslog.v2.FileAccessLog.typed_json_format: typed_json_format (`Struct `_) Access log :ref:`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 :ref:`format `, :ref:`json_format `, :ref:`typed_json_format ` may be set.