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:

  1. 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.method e, para uma solicitação tools/call, o nome da ferramenta em jsonPayload.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 .
  2. 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 .
  3. 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) e report (para métricas e registros) para o Google Cloud Service Control. Somente se uma chamada check ou report falhar, um registro service_control_queries com 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 .
  4. 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.