Secure Web Proxy 调用的日志记录和监控

本页面介绍了如何为 Secure Web Proxy 配置和使用 Cloud Logging 和 Cloud Monitoring 以及 Service Extensions 标注。

日志记录

Secure Web Proxy 使用 Logging 来捕获和存储多种类型的日志，包括与扩展程序相关的日志。如需了解 Secure Web Proxy 日志记录，请参阅日志。

一般来说，应用负载均衡器日志条目包含对监控和调试 HTTP 或 HTTPS 流量有用的信息。日志条目包含以下类型的信息：

  • 大多数 Google Cloud 日志中显示的信息，例如严重性、项目 ID、项目编号和时间戳，如 LogEntry 日志中所述。
  • HttpRequest 日志字段。

HTTP 和 HTTPS 负载均衡器的请求日志在负载均衡器日志条目 JSON 载荷中包含一个 service_extension_info 对象，其中包含以下信息：

字段 类型 说明
backend_target_name 字符串 扩展程序的后端目标的名称。
backend_target_type 字符串 后端目标的类型。
chain 字符串 与请求匹配的服务扩展程序资源中的扩展程序链的名称。
extension 字符串 扩展程序链中扩展程序的名称。
failed_open 布尔值 如果扩展程序配置将 failOpen 设置为 true，则此指标的值 true 表示在扩展程序超时或失败时继续处理。

仅适用于区域级外部应用负载均衡器、区域级内部应用负载均衡器和跨区域内部应用负载均衡器。
grpc_status 枚举 gRPC 流的最新状态。如需了解详情，请参阅 gRPC 状态代码。
per_processing_request_info 数组 通过 gRPC 流发生的 ext_proc 扩展程序的 ProcessingRequest 统计信息或 ext_authz 扩展程序的 CheckRequest 统计信息的列表。
per_processing_request_info[].event_type 枚举 ProcessingRequest 的事件类型。可以是以下值之一：REQUEST_HEADERS、REQUEST_BODY、RESPONSE_HEADERS 或 RESPONSE_BODY。
per_processing_request_info[].latency 时长 从向扩展程序发送 ProcessingRequest 消息的第一个字节到收到 ProcessingResponse 消息的最后一个字节的时长。
per_processing_request_info[].processing_effect 枚举 处理请求中每个事件的处理结果。

仅适用于区域级外部应用负载均衡器、区域级内部应用负载均衡器和跨区域内部应用负载均衡器。

可以是下列值之一：

  • NONE：表示内容未更改。
  • NONE_FAILED_OPEN：表示未执行任何变更，因为扩展程序无法打开。
  • CONTENT_MODIFIED：表示内容已通过成功应用的 mutate 请求进行了更改。
  • IMMEDIATE_RESPONSE：表示扩展程序发送了即时响应，以停止所有进一步处理。
  • MUTATION_REJECTED：表示扩展程序请求了至少一项不允许的更改，并且进一步处理已终止。系统会记录相应的错误消息。
  • UNSPECIFIED：表示处理效果未知。
per_processing_request_info[].processing_effect_details 字符串 当 processing_effect 为 MUTATION_REJECTED 时，提供有关突变被拒绝的原因的详细信息。

仅适用于区域级外部应用负载均衡器、区域级内部应用负载均衡器和跨区域内部应用负载均衡器。
resource 字符串 扩展程序资源的名称

监控

如需了解 Secure Web Proxy 的 Monitoring 指标，请参阅可用指标。

在预览版中，您可以监控所有类型应用负载均衡器上的扩展程序的以下指标。这些指标的前缀为 networkservices.googleapis.com。 下表中的条目省略了该前缀。

下表提供了每个指标的指标类型、显示名称、种类、类型、单位和说明。

指标类型 显示名称
种类、类型、单位
说明
extension/invocation_count 扩展程序调用次数
DELTA、INT64、1
发送到扩展程序的调用次数。
extension/invocation_latencies 扩展程序调用延迟时间
DELTA、DISTRIBUTION、ms
根据每次扩展程序调用的延迟时间计算出的分布。 仅适用于标注扩展程序；插件不支持此字段。
extension/sent_chunks_count 扩展程序发送的块数
DELTA、INT64、1
仅适用于 request_body 和 response_body 事件。 发送到扩展程序的数据块数量。
extension/received_chunks_count 扩展程序收到的分块数
DELTA、INT64、1
仅适用于 request_body 和 response_body 事件。 从扩展程序收到的块数量。
extension/failed_open_count 扩展程序调用失败（故障开放）
DELTA、INT64、1
当系统配置为故障开放且允许请求继续时，调用失败的次数。
extension/mutation_rejections_count 扩展程序变更拒绝次数
DELTA、INT64、1
请求标头、正文或尾部变更但被拒绝的调用次数。拒绝可能由于多种原因而发生，例如变更无效或超出大小限制。
extension/sent_bytes_count 扩展程序发送的字节数
DELTA、INT64、By
发送到扩展程序的字节数。
extension/received_bytes_count 扩展程序收到的字节数
DELTA、INT64、By
从扩展程序收到的字节数。