gRPC 存取日誌服務 (ALS) (proto)

extensions.access_loggers.grpc.v3.HttpGrpcAccessLogConfig

[extensions.access_loggers.grpc.v3.HttpGrpcAccessLogConfig proto]

內建 envoy.access_loggers.http_grpc AccessLog 的組態。此組態將會填入 StreamAccessLogsMessage.http_logs。

此擴充功能具有限定名稱 envoy.access_loggers.http_grpc

注意

此擴充功能旨在針對不受信任的下游流量保持穩健。它假設上游是受信任的。

提示

此擴充功能擴展並可與下列擴充功能類別一起使用

envoy.access_loggers

此擴充功能必須使用下列其中一種類型 URL 進行組態

type.googleapis.com/envoy.extensions.access_loggers.grpc.v3.HttpGrpcAccessLogConfig

{
  "common_config": {...},
  "additional_request_headers_to_log": [],
  "additional_response_headers_to_log": [],
  "additional_response_trailers_to_log": []
}

common_config: (extensions.access_loggers.grpc.v3.CommonGrpcAccessLogConfig，必要)

additional_request_headers_to_log: (重複字串) 要記錄在 HTTPRequestProperties.request_headers 中的額外請求標頭。

additional_response_headers_to_log: (重複字串) 要記錄在 HTTPResponseProperties.response_headers 中的額外回應標頭。

additional_response_trailers_to_log: (重複字串) 要記錄在 HTTPResponseProperties.response_trailers 中的額外回應尾部。

extensions.access_loggers.grpc.v3.TcpGrpcAccessLogConfig

[extensions.access_loggers.grpc.v3.TcpGrpcAccessLogConfig proto]

內建 envoy.access_loggers.tcp_grpc 類型的組態。此組態將會填入 StreamAccessLogsMessage.tcp_logs。

此擴充功能具有限定名稱 envoy.access_loggers.tcp_grpc

注意

此擴充功能旨在針對不受信任的下游流量保持穩健。它假設上游是受信任的。

提示

此擴充功能擴展並可與下列擴充功能類別一起使用

envoy.access_loggers

此擴充功能必須使用下列其中一種類型 URL 進行組態

type.googleapis.com/envoy.extensions.access_loggers.grpc.v3.TcpGrpcAccessLogConfig

{
  "common_config": {...}
}

common_config: (extensions.access_loggers.grpc.v3.CommonGrpcAccessLogConfig，必要)

extensions.access_loggers.grpc.v3.CommonGrpcAccessLogConfig

[extensions.access_loggers.grpc.v3.CommonGrpcAccessLogConfig proto]

gRPC 存取日誌的通用組態。

{
  "log_name": ...,
  "grpc_service": {...},
  "transport_api_version": ...,
  "buffer_flush_interval": {...},
  "buffer_size_bytes": {...},
  "filter_state_objects_to_log": [],
  "grpc_stream_retry_policy": {...},
  "custom_tags": []
}

log_name: (字串，必要) 要在 StreamAccessLogsMessage.Identifier 中傳回的存取日誌易記名稱。這可讓存取日誌伺服器區分來自相同 Envoy 的不同存取日誌。

grpc_service: (config.core.v3.GrpcService，必要) 存取日誌服務的 gRPC 服務。

transport_api_version: (config.core.v3.ApiVersion) 存取日誌服務傳輸協定的 API 版本。這描述了存取日誌服務 gRPC 端點，以及線路上使用的訊息版本。

buffer_flush_interval: (Duration) 將存取日誌刷新到 gRPC 資料流的間隔。記錄器將在每次經過此間隔時，或當達到批次大小限制時刷新請求，以先到者為準。預設值為 1 秒。

buffer_size_bytes: (UInt32Value) 存取日誌條目緩衝區的軟體大小限制（以位元組為單位）。記錄器將緩衝請求直到達到此限制，或每次經過刷新間隔，以先到者為準。將其設定為零會有效地停用批次處理。預設值為 16384。

filter_state_objects_to_log: (重複字串) 要記錄在 filter_state_objects 中的額外篩選器狀態物件。記錄器將呼叫 FilterState::Object::serializeAsProto 來序列化篩選器狀態物件。

grpc_stream_retry_policy: (config.core.v3.RetryPolicy) 設定 gRPC 資料流建立失敗時的重試策略。如果資料流至少成功建立一次，則無論收到何種 gRPC 狀態，都不會執行重試。請注意，在此組態中只會使用 num_retries。此功能僅在您使用 Envoy gRPC 用戶端時使用。

custom_tags: (重複 type.tracing.v3.CustomTag) 具有唯一標籤名稱的自訂標籤清單，用於為日誌建立標籤。