Registos da plataforma

Google Cloud oferece dois tipos de registos do API Gateway:

OsGoogle Cloud serviços geram automaticamente registos da plataforma para cada pedido do API Gateway. Estes registos oferecem visibilidade sobre o processamento de pedidos, a autenticação e as interações com outros Google Cloud serviços. Estes registos são essenciais para depurar erros de gateway, analisar o desempenho e compreender os padrões de tráfego. Para mais informações sobre os tipos de registos da plataforma, consulte o seguinte:

  1. Registos de pedidos

    Cada entrada de registo representa uma consulta publicada pelo seu API Gateway. Contém informações úteis, como o código de estado HTTP, a latência, o motivo da resposta, os tamanhos dos pedidos/respostas e muito mais para cada pedido.

    Consulta do registo

    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 sua instância do API Gateway.
    • Em que LOCATION é a região onde a sua instância do API Gateway está implementada.
    • Onde PROJECT_ID é o ID do seu Google Cloud projeto.
  2. Registos de consultas JWKS

    Quando usa a autenticação JWT, o seu API Gateway faz chamadas periódicas para obter os JWKs necessários do ponto final de JWKs especificado na configuração da API. Estes registos mostram informações úteis sobre pedidos bem-sucedidos e sem êxito ao seu ponto final JWKs.

    Consulta do registo

    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 sua instância do API Gateway.
    • Em que LOCATION é a região onde a sua instância do API Gateway está implementada.
    • Onde PROJECT_ID é o ID do seu Google Cloud projeto.
  3. Registos de consultas do Controlo de Serviços

    Quando o gateway de APIs processa tráfego, faz chamadas check (para validar a quota e as chaves da API) e report (para métricas e registos) para o Google Cloud controlo de serviços. Só é preenchido um registo service_control_queries com mais informações se uma chamada check ou report falhar.

    Consulta do registo

    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 sua instância do API Gateway.
    • Em que LOCATION é a região onde a sua instância do API Gateway está implementada.
    • Onde PROJECT_ID é o ID do seu Google Cloud projeto.
  4. Registos da API produzidos

    Além dos registos associados ao apigateway.googleapis.com, o API Gateway também preenche os registos da API produzida. Estes registos estão associados ao seu serviço gerido e podem ser usados para ver registos em todos os gateways de APIs que implementam um serviço gerido específico.

    Consulta do registo

    resource.type="api"
resource.labels.service="MANAGED_SERVICE"

    Onde MANAGED_SERVICE é o nome do seu serviço gerido, que pode encontrar consultando o recurso da API do API Gateway.