Log di Endpoints

Quando gli utenti inviano richieste alla tua API, Extensible Service Proxy (ESP) utilizza Cloud Logging per registrare informazioni sulle richieste e sulle risposte. Questa pagina descrive le informazioni registrate.

Per individuare i log di Cloud Endpoints nella pagina Esplora log:

  1. Nella console Google Cloud, vai alla pagina Stackdriver > Logging:

    Vai alla pagina Esplora log

  2. Seleziona API prodotta, SERVICE_NAME, dove SERVICE_NAME è il nome del servizio Endpoints.

  3. Fai clic sul log che vuoi esaminare. Il log contiene un file JSON strutturato messaggio simile al seguente:

    {
  insertId: "…"
  jsonPayload: {…}
  resource: {
    type: "api"
    labels: {…}
  }
  timestamp: "2017-05-08T15:00:02.804424422Z"
  severity: "INFO"
  logName: "…"
}

L'oggetto jsonPayload contiene tutte le informazioni registrate dall'ESP. La seguente tabella descrive i relativi campi:

Campo Descrizione
url Percorso dell'URL della richiesta.
producer_project_id L'ID progetto Google Cloud proprietario dell'API.
api_name Nome dell'API richiamata.
api_version Versione dell'API denominata richiamata.
api_method Metodo dell'API denominata richiamata.
api_key Chiave API utilizzata dal consumer chiamante, se presente.
http_method Metodo HTTP della richiesta, ad esempio GET e POST.
request_size_in_bytes Dimensioni del corpo della richiesta in byte.
http_response_code Codice di stato HTTP della risposta, ad esempio 200, 404 e 500.
response_size_in_bytes Dimensioni del corpo della risposta in byte.
request_latency_in_ms Tempo impiegato per rispondere alla richiesta in millisecondi, compreso il tempo impiegato da ESP e dal relativo backend. Non presente per i metodi di inserimento flussi.
timestamp Timestamp della richiesta.
location La zona Google Cloud che ha gestito la richiesta.
log_message Breve messaggio sul metodo chiamato e sul suo stato se viene rifiutato. Non viene registrato alcun campo con informazioni API per le chiamate rifiutate.
error_cause Messaggio di errore se la risposta è un errore.
labels La sezione labels contiene informazioni che identificano l'origine del log, ad esempio l'ID progetto Google Cloud, il nome del servizio Endpoints, il numero di versione dell'API e il nome del metodo.

Passaggi successivi