Log della piattaforma

Google Cloud offre due tipi di log API Gateway:

Google Cloud services genera automaticamente i log della piattaforma per ogni richiesta API Gateway. Questi log forniscono visibilità sulla gestione delle richieste, sull'autenticazione e sulle interazioni con altri servizi Google Cloud . Questi log sono fondamentali per il debug degli errori del gateway, l'analisi del rendimento e la comprensione dei pattern di traffico. Per saperne di più sui tipi di log della piattaforma, consulta le seguenti risorse:

  1. Richiedere log

    Ogni voce di log rappresenta una query gestita da API Gateway. Contiene informazioni utili come il codice di stato HTTP, la latenza, il motivo della risposta, le dimensioni della richiesta/risposta e altro ancora per ogni richiesta.

    Query sul log

    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"
    • Dove GATEWAY_ID è il nome dell'istanza API Gateway.
    • dove LOCATION è la regione in cui viene eseguito il deployment dell'istanza API Gateway.
    • Dove PROJECT_ID è l'ID progetto Google Cloud .
  2. Log delle query JWKS

    Quando utilizzi l'autenticazione JWT, API Gateway effettua chiamate periodiche per recuperare i JWK richiesti dall'endpoint JWK specificato nella configurazione API. Questi log mostrano informazioni utili sulle richieste riuscite e non riuscite all'endpoint JWK.

    Query sul log

    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"
    • Dove GATEWAY_ID è il nome dell'istanza API Gateway.
    • dove LOCATION è la regione in cui viene eseguito il deployment dell'istanza API Gateway.
    • Dove PROJECT_ID è l'ID progetto Google Cloud .
  3. Log delle query di Service Control

    Quando API Gateway gestisce il traffico, effettua chiamate check (per la verifica della quota e delle chiavi API) e report (per metriche e log) a Google Cloud Service Control. Solo se una chiamata check o report non va a buon fine, viene compilato un log service_control_queries con ulteriori informazioni.

    Query sul log

    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"
    • Dove GATEWAY_ID è il nome dell'istanza API Gateway.
    • dove LOCATION è la regione in cui viene eseguito il deployment dell'istanza di API Gateway.
    • Dove PROJECT_ID è l'ID progetto Google Cloud .
  4. Log delle API prodotte

    Oltre ai log associati a apigateway.googleapis.com, API Gateway compila anche i log dell'API prodotta. Questi log sono associati al tuo servizio gestito e possono essere utilizzati per visualizzare i log in tutti i gateway API che implementano un servizio gestito specifico.

    Query sul log

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

    dove MANAGED_SERVICE è il nome del tuo servizio gestito, che puoi trovare eseguendo una query sulla risorsa API Gateway - API.