package envoy.service.accesslog.v3

Get desktop application:
View/edit binary Protocol Buffers messages

Service for streaming access logs from Envoy to an access log server.

• rpc StreamAccessLogs (stream StreamAccessLogsMessage, StreamAccessLogsResponse)

  als.proto:28

  Envoy will connect and send StreamAccessLogsMessage messages forever. It does not expect any response to be sent as nothing would be done in the case of failure. The server should disconnect if it expects Envoy to reconnect. In the future we may decide to add a different API for "critical" access logs in which Envoy will buffer access logs for some period of time until it gets an ACK so it could then retry. This API is designed for high throughput with the expectation that it might be lossy.

  message StreamAccessLogsMessage

  als.proto:40

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

  • optional StreamAccessLogsMessage.Identifier identifier = 1

    Identifier data that will only be sent in the first message on the stream. This is effectively structured metadata and is a performance optimization.

  • oneof log_entries

    Batches of log entries of a single type. Generally speaking, a given stream should only ever include one type of log entry.

    • StreamAccessLogsMessage.HTTPAccessLogEntries http_logs = 2

    • StreamAccessLogsMessage.TCPAccessLogEntries tcp_logs = 3

  message StreamAccessLogsResponse

  als.proto:33

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

  (message has no fields)

Wrapper for batches of HTTP access log entries.

Used in: StreamAccessLogsMessage

• repeated data.accesslog.v3.HTTPAccessLogEntry log_entry = 1

Used in: StreamAccessLogsMessage

• optional config.core.v3.Node node = 1

  The node sending the access log messages over the stream.

• string log_name = 2

  The friendly name of the log configured in :ref:`CommonGrpcAccessLogConfig <envoy_v3_api_msg_extensions.access_loggers.grpc.v3.CommonGrpcAccessLogConfig>`.

Wrapper for batches of TCP access log entries.

Used in: StreamAccessLogsMessage

• repeated data.accesslog.v3.TCPAccessLogEntry log_entry = 1