平台記錄檔
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 也會填入產生的 API 記錄。這些記錄與代管服務相關聯,可用於查看所有實作特定代管服務的 API Gateway 記錄。記錄查詢
resource.type="api" resource.labels.service="MANAGED_SERVICE"
其中 MANAGED_SERVICE 是代管服務的名稱,您可以查詢 API Gateway - API 資源來找到這個名稱。