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: (重复 string) 要在 HTTPRequestProperties.request_headers 中记录的附加请求标头。

additional_response_headers_to_log: (重复 string) 要在 HTTPResponseProperties.response_headers 中记录的附加响应标头。

additional_response_trailers_to_log: (重复 string) 要在 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: (string, 必需) 要在 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: (重复 string) 要在 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) 具有唯一标签名称的自定义标签列表，用于为日志创建标签。