Registros de plataforma
OGoogle Cloud oferece dois tipos de registros do gateway de API:
Os serviços doGoogle Cloud geram automaticamente registros de plataforma para cada solicitação do gateway de API. Esses registros dão visibilidade sobre o processamento de solicitações, a autenticação e as interações com outros serviços do Google Cloud . Esses registros são essenciais para depurar erros de gateway, analisar o desempenho e entender os padrões de tráfego. Para mais informações sobre os tipos de registros de plataforma, consulte:
- Registros de solicitações
Cada entrada de registro representa uma consulta exibida pelo gateway de API. Ele contém informações úteis, como o código de status HTTP, a latência, o motivo da resposta, os tamanhos de solicitação/resposta e muito mais para cada solicitação.
Para uma solicitação do Protocolo de Contexto de Modelo (MCP), a entrada também contém o método MCP em
jsonPayload.mcp.methode, para uma solicitaçãotools/call, o nome da ferramenta emjsonPayload.mcp.tool. Para mais informações, consulte Configurar o protocolo de contexto do modelo.Consulta de registro
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"
- Em que GATEWAY_ID é o nome da instância do gateway de API.
- Em que LOCATION é a região em que a instância do gateway de API está implantada.
- Em que PROJECT_ID é o ID do projeto do Google Cloud .
- Registros de consultas JWKS
Ao usar a autenticação JWT, o gateway de API fará chamadas periódicas para buscar as JWKs necessárias no endpoint de JWKs especificado na configuração da API. Esses registros mostram informações úteis sobre solicitações bem-sucedidas e malsucedidas para seu endpoint de JWKs.
Consulta de registro
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"
- Em que GATEWAY_ID é o nome da instância do gateway de API.
- Em que LOCATION é a região em que a instância do gateway de API está implantada.
- Em que PROJECT_ID é o ID do projeto do Google Cloud .
- Registros de consultas do Service Control
Quando o gateway de API veicula tráfego, ele faz chamadas
check(para verificar cotas e chaves de API) ereport(para métricas e registros) para o Google Cloud Service Control. Somente se uma chamadacheckoureportfalhar, um registroservice_control_queriescom mais informações será preenchido.Consulta de registro
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"
- Em que GATEWAY_ID é o nome da instância do gateway de API.
- Em que LOCATION é a região em que a instância do gateway de API está implantada.
- Em que PROJECT_ID é o ID do projeto do Google Cloud .
- Registros de API produzidos
Além dos registros associados a
apigateway.googleapis.com, o gateway de API também preenche os registros de API produzidos. Esses registros estão associados ao seu serviço gerenciado e podem ser usados para visualizar registros em todos os gateways de API que implementam um serviço gerenciado específico.Consulta de registro
resource.type="api" resource.labels.service="MANAGED_SERVICE"
Em que MANAGED_SERVICE é o nome do serviço gerenciado, que pode ser encontrado consultando o recurso de API do gateway de API.