Cloud Load Balancing 回调的日志记录和监控

本页面介绍了如何为 Cloud Load Balancing 配置和使用 Cloud Logging 和 Cloud Monitoring，并将其与服务扩展程序调用搭配使用。

日志记录

本部分介绍了应用负载平衡器调用的日志记录。

在后端服务上启用日志记录

您可以在创建服务时为应用负载平衡器回调启用日志记录功能，方法是为作为请求目标的后端服务（而不是与扩展程序关联的后端服务）启用日志记录功能。

如需为目标后端服务启用日志记录，请使用 gcloud compute backend-services update 命令。

gcloud compute backend-services update BACKEND_SERVICE \
    --enable-logging \
    --logging-sample-rate=RATE \
    --region=REGION \
    --logging-optional=LOGGING_OPTIONAL_MODE \
    --logging-optional-fields=OPTIONAL_FIELDS

替换以下内容：

  • BACKEND_SERVICE：后端服务的名称
  • RATE：介于 0.0 到 1.0 之间的值，其中 0.0 表示不在日志中记录任何请求，1.0 表示在日志中记录所有请求。默认值为 1.0。 此设置仅在与 enable-logging 参数搭配使用时有效。如果您省略 enable-logging，则系统会停用日志记录功能。
  • REGION：后端的区域

  • LOGGING_OPTIONAL_MODE：启用以下模式之一的可选字段的日志记录：

    • INCLUDE_ALL_OPTIONAL 包含所有可选字段。
    • EXCLUDE_ALL_OPTIONAL（默认值）：排除所有可选字段。
    • CUSTOM 包含可选字段的自定义列表。
  • OPTIONAL_FIELDS：选择 CUSTOM 模式时可选字段的英文逗号分隔列表

为后端服务启用日志记录功能后，HTTP 或 HTTPS 请求会通过 Cloud Logging 记录到日志中。

如需查看日志，请在 Google Cloud 控制台中前往 Logs Explorer 页面。

如需了解详情，请参阅应用负载平衡器文档的“监控和问题排查”页面，例如内部应用负载平衡器日志记录和监控。

后端服务的日志消息

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

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

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

字段 类型 说明
backend_target_name 字符串 扩展程序的后端目标的名称。
backend_target_type 字符串 后端目标的类型。
chain 字符串 服务扩展程序资源中与请求匹配的扩展程序链的名称。
extension 字符串 扩展程序链中扩展程序的名称。
grpc_status 枚举 gRPC 流的最新状态。如需了解详情，请参阅 gRPC 状态代码。
per_processing_request_info 数组 ext_proc 扩展程序的 ProcessingRequest 统计信息或通过 gRPC 流发生的 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 消息的最后一个字节为止，这段时间的长短。
resource 字符串 扩展资源名称

监控

本部分介绍如何监控为 Cloud Load Balancing 使用服务扩展程序配置的调出。

查看 Monitoring 信息中心

应用负载平衡器会将监控数据导出到 Cloud Monitoring。

监控指标适用于以下用途：

  • 评估负载平衡器的配置、使用情况和性能
  • 问题排查
  • 提高资源利用率并改善用户体验

如需查看预定义的信息中心，请按以下步骤操作：

  1. 在 Google Cloud 控制台中，前往信息中心概览页面。

    前往信息中心概览

  2. 在类别部分中，点击 GCP。
    • 如需查看所有负载平衡器的信息中心列表，请在 GCP 信息中心列表中点击名为 Google Cloud 负载平衡器的信息中心。 如需查看特定负载均衡器的信息中心，请在列表中找到相应负载均衡器，然后点击其名称。
    • 如需仅查看负载平衡器的预定义信息中心，请选择相应的信息中心。

除了 Monitoring 中的预定义信息中心，您还可以通过 Cloud Monitoring API 创建自定义信息中心、设置提醒和查询指标。

如需了解详情，请参阅应用负载平衡器文档的“监控和问题排查”页面，例如内部应用负载平衡器日志记录和监控。

监控展示广告附加信息的指标

您可以监控以下针对插桩后端服务的指标。

这些指标的前缀为 loadbalancing.googleapis.com/。表中的条目省略了该前缀。

指标类型 显示名
种类、类型、单位
说明
https/backend_request_count、
https/external/regional/backend_request_count、
https/internal/backend_request_count 		后端请求数
DELTA、INT64、1
从应用负载平衡器调用插桩后端服务的次数。
https/backend_request_bytes_count、
https/external/regional/backend_request_bytes_count、
https/internal/backend_request_bytes_count 		后端请求字节数
DELTA、INT64、By
从负载均衡器发送到回调后端服务的字节数。
https/backend_response_bytes_count、
https/external/regional/backend_response_bytes_count、
https/internal/backend_response_bytes_count 		后端响应字节数
DELTA、INT64、By
负载均衡器从扩展后端接收的字节数。
https/backend_latencies、
https/external/regional/backend_latencies、
https/internal/backend_latencies 		后端延迟时间
DELTA、DISTRIBUTION、ms
一种分布，根据负载均衡器与调出后端服务之间每次扩展调用延迟时间的总和计算得出。每 60 秒采样一次。

后续步骤