gRPC Access Log Service (ALS)

service.accesslog.v2.StreamAccessLogsResponse

[service.accesslog.v2.StreamAccessLogsResponse proto]

Empty response for the StreamAccessLogs API. Will never be sent. See below.

{}

service.accesslog.v2.StreamAccessLogsMessage

[service.accesslog.v2.StreamAccessLogsMessage proto]

Stream message for the StreamAccessLogs API. Envoy will open a stream to the server and stream access logs without ever expecting a response.

{
  "identifier": "{...}",
  "http_logs": "{...}"
}
identifier
(service.accesslog.v2.StreamAccessLogsMessage.Identifier) Identifier data that will only be sent in the first message on the stream. This is effectively structured metadata and is a performance optimization.
http_logs
(service.accesslog.v2.StreamAccessLogsMessage.HTTPAccessLogEntries, REQUIRED) Batches of log entries of a single type. Generally speaking, a given stream should only ever include one type of log entry.

service.accesslog.v2.StreamAccessLogsMessage.Identifier

[service.accesslog.v2.StreamAccessLogsMessage.Identifier proto]

{
  "node": "{...}",
  "log_name": "..."
}
node
(core.Node, REQUIRED) The node sending the access log messages over the stream.
log_name
(string, REQUIRED) The friendly name of the log configured in CommonGrpcAccessLogConfig.

service.accesslog.v2.StreamAccessLogsMessage.HTTPAccessLogEntries

[service.accesslog.v2.StreamAccessLogsMessage.HTTPAccessLogEntries proto]

Wrapper for batches of HTTP access log entries.

{
  "log_entry": []
}
log_entry
(data.accesslog.v2.HTTPAccessLogEntry, REQUIRED)