1syntax = "proto3";
2
3package envoy.extensions.access_loggers.file.v4alpha;
4
5import "envoy/config/core/v4alpha/substitution_format_string.proto";
6
7import "google/protobuf/struct.proto";
8
9import "udpa/annotations/status.proto";
10import "udpa/annotations/versioning.proto";
11import "validate/validate.proto";
12
13option java_package = "io.envoyproxy.envoy.extensions.access_loggers.file.v4alpha";
14option java_outer_classname = "FileProto";
15option java_multiple_files = true;
16option (udpa.annotations.file_status).package_version_status = NEXT_MAJOR_VERSION_CANDIDATE;
17
18// [#protodoc-title: File access log]
19// [#extension: envoy.access_loggers.file]
20
21// Custom configuration for an :ref:`AccessLog <envoy_api_msg_config.accesslog.v4alpha.AccessLog>`
22// that writes log entries directly to a file. Configures the built-in *envoy.access_loggers.file*
23// AccessLog.
24// [#next-free-field: 6]
25message FileAccessLog {
26 option (udpa.annotations.versioning).previous_message_type =
27 "envoy.extensions.access_loggers.file.v3.FileAccessLog";
28
29 reserved 2, 3, 4;
30
31 reserved "format", "json_format", "typed_json_format";
32
33 // A path to a local file to which to write the access log entries.
34 string path = 1 [(validate.rules).string = {min_len: 1}];
35
36 oneof access_log_format {
37 // Configuration to form access log data and format.
38 // If not specified, use :ref:`default format <config_access_log_default_format>`.
39 config.core.v4alpha.SubstitutionFormatString log_format = 5
40 [(validate.rules).message = {required: true}];
41 }
42}
View as plain text