平台日志
Google Cloud 提供两种类型的 API Gateway 日志:
Google Cloud 服务会自动为每个 API Gateway 请求生成平台日志。这些日志可让您了解请求处理、身份验证以及与其他 Google Cloud 服务的互动情况。这些日志对于调试网关错误、分析性能和了解流量模式至关重要。如需详细了解平台日志的类型,请参阅以下内容:
- 请求日志
每个日志条目都代表 API Gateway 传送的查询。其中包含每个请求的 HTTP 状态代码、延迟时间、响应原因、请求/响应大小等实用信息。
对于 Model Context Protocol (MCP) 请求,该条目还包含
jsonPayload.mcp.method中的 MCP 方法,对于tools/call请求,则包含jsonPayload.mcp.tool中的工具名称。如需了解详情,请参阅配置 Model Context Protocol。日志查询
resource.type="apigateway.googleapis.com/Gateway" resource.labels.gateway_id="GATEWAY_ID" resource.labels.location="LOCATION" log_name="projects/PROJECT_ID/logs/apigateway.googleapis.com%2Frequests"
- 其中,GATEWAY_ID 是 API Gateway 实例的名称。
- 其中,LOCATION 是 API Gateway 实例部署到的区域。
- 其中,PROJECT_ID 是您的 Google Cloud 项目 ID。
- JWKS 查询日志
使用 JWT 身份验证时,API Gateway 会定期发出调用,以从 API 配置中指定的 JWK 端点提取所需的 JWK。这些日志会显示有关对 JWK 端点的成功和失败请求的实用信息。
日志查询
resource.type="apigateway.googleapis.com/Gateway" resource.labels.gateway_id="GATEWAY_ID" resource.labels.location="LOCATION" log_name="projects/PROJECT_ID/logs/apigateway.googleapis.com%2Fjwks_queries"
- 其中,GATEWAY_ID 是 API Gateway 实例的名称。
- 其中,LOCATION 是 API Gateway 实例部署到的区域。
- 其中,PROJECT_ID 是您的 Google Cloud 项目 ID。
- Service Control 查询日志
当 API Gateway 传送流量时,它会向 Google Cloud Service Control 发出
check(用于验证配额和 API 密钥)和report(用于指标和日志)调用。只有在check或report调用失败时,系统才会填充包含更多信息的service_control_queries日志。日志查询
resource.type="apigateway.googleapis.com/Gateway" resource.labels.gateway_id="GATEWAY_ID" resource.labels.location="LOCATION" log_name="projects/PROJECT_ID/logs/apigateway.googleapis.com%2Fservice_control_queries"
- 其中,GATEWAY_ID 是 API Gateway 实例的名称。
- 其中,LOCATION 是 API Gateway 实例部署到的区域。
- 其中,PROJECT_ID 是您的 Google Cloud 项目 ID。
- Products API 日志
除了与
apigateway.googleapis.com关联的日志之外,API Gateway 还会填充 Products API 日志。这些日志与您的代管式服务相关联,可用于查看实现特定代管式服务的所有 API Gateway 的日志。日志查询
resource.type="api" resource.labels.service="MANAGED_SERVICE"
其中,MANAGED_SERVICE 是代管式服务的名称,可通过查询 API Gateway - API 资源找到。