Questa pagina descrive come monitorare lo stato delle API di tua proprietà utilizzando i log e le metriche gestiti automaticamente da Cloud Endpoints. Quando gli utenti inviano richieste alla tua API, Endpoints registra informazioni sulle richieste e sulle risposte. Endpoints monitora anche tre dei quattro indicatori principali del monitoraggio: latenza, traffico ed errori. Queste metriche di utilizzo e prestazioni ti aiutano a monitorare la tua API.
Prima di iniziare
Devi eseguire il deployment dell'API e inviare richieste per generare log e metriche da visualizzare. Se non hai ancora configurato nulla, prova la guida introduttiva agli endpoint.
Panoramica dell'API
Quando stai cercando di risolvere un problema con il tuo servizio o vuoi solo assicurarti che tutto funzioni correttamente, vai alla panoramica dell'API:
Nella console Google Cloud, vai alla pagina Endpoint > Servizi per il tuo progetto:
Se hai più di un'API, fai clic su quella che vuoi monitorare.
Assicurati di essere nella scheda Panoramica.
Grafici
In alto sono presenti i grafici di alcune metriche, in modo da poter rilevare immediatamente eventuali picchi e cali. Puoi:
In alto a destra del primo grafico, utilizza l'elenco a discesa Seleziona grafici per visualizzare i grafici relativi alle metriche che ti interessano e rimuovere quelli che non vuoi visualizzare. Ogni voce dell'elenco a discesa ha un punto interrogativo su cui puoi passare il mouse per visualizzare una descrizione della metrica visualizzata.
Nell'angolo in alto a destra della panoramica, modifica i grafici selezionando uno dei vari intervalli di tempo. In questo modo viene modificato l'intervallo di tempo dei valori visualizzati in questi grafici, il che altera anche la granularità dei punti.
Tabella dei metodi
Quando vuoi visualizzare ulteriori dettagli, scorri sotto i grafici per visualizzare una tabella con le metriche per i singoli metodi dell'API. Puoi:
In alto a destra nella tabella, utilizza l'elenco a discesa Seleziona colonne per visualizzare le metriche che ti interessano e rimuovere quelle che non vuoi visualizzare. Le voci qui hanno anche il punto interrogativo sopra il quale puoi tenere premuto il cursore per visualizzare una descrizione.
Nell'angolo in alto a destra della panoramica, seleziona un intervallo di tempo per i valori delle metriche nella tabella utilizzando il selettore dell'intervallo di tempo. Viene selezionato un intervallo di tempo sia per i grafici sia per la tabella.
Log
Quando riscontri un problema nelle metriche, vai alla pagina Esplora log nella console Google Cloud per visualizzare i log delle richieste e delle risposte per la tua API.
Per visualizzare i log dei singoli metodi della tua API, fai clic su Visualizza log nella tabella.
Per visualizzare i log di tutti i metodi dell'API, fai clic su Visualizza tutti i log nell'angolo in basso a destra.
Per trovare i log di Endpoints direttamente dalla pagina Esplora log:
Nella console Google Cloud, vai alla pagina Stackdriver > Logging:
Seleziona API prodotta,
SERVICE_NAME, doveSERVICE_NAMEè il nome del servizio Endpoints.
Per maggiori dettagli sulla struttura dei log in Esplora log, consulta il riferimento ai log degli endpoint.
Scopri cos'altro puoi fare con i log:
Inizia a utilizzare Esplora log.
Crea query per specificare l'insieme di voci di log che vuoi visualizzare, ad esempio tutte le richieste con una latenza superiore a 300 millisecondi.
Configura e gestisci i sink per indirizzare i log alle destinazioni supportate. In questo modo puoi eseguire lo streaming dei log in BigQuery per ulteriori analisi, salvare i log non elaborati in Cloud Storage o inviarli agli argomenti di messaggistica Pub/Sub.
Filtrare per un progetto consumer specifico
Per visualizzare le metriche di un progetto consumer specifico, i tuoi consumer dell'API devono inviare una chiave API quando effettuano una richiesta. Poiché Endpoints utilizza la chiave API per identificare il progetto a cui è associata l'applicazione chiamante, la chiave API deve essere stata creata nel progetto Google Cloud del consumatore dell'API. Per scoprire come limitare l'accesso alla tua API utilizzando una chiave API, consulta Limitare l'accesso alle API con le chiavi API.
Per filtrare le metriche per un progetto consumer specifico:
Recupera il numero del progetto del progetto del consumatore dell'API. Se non disponi dell'autorizzazione per accedere al progetto del consumatore dell'API, chiedi a qualcuno che dispone dell'autorizzazione di recuperare il numero del progetto per te.
Nella console Google Cloud, vai alla pagina Endpoint > Servizi per il tuo progetto.
Nell'angolo in alto a sinistra della pagina Panoramica, inserisci il numero del progetto nel campo Filtra per numero progetto.
Fai clic su Filtra.
Le metriche nella pagina vengono aggiornate in modo da riflettere il traffico solo del progetto specificato.
Avvisi
Le metriche raccolte da Endpoints sono disponibili anche in Cloud Monitoring. Puoi utilizzare Monitoring per configurare avvisi su latenza, traffico ed errori. L'unico indicatore per cui non puoi configurare un avviso utilizzando le metriche di Endpoints è la saturazione. Le metriche da monitorare per la saturazione dipendono dalla tua applicazione. Consulta l'elenco delle metriche disponibili in Cloud Monitoring per individuare quelle che puoi utilizzare per configurare gli avvisi in caso di saturazione.
Per configurare gli avvisi:
Nella console Google Cloud, seleziona il progetto Google Cloud con l'API monitorata di Endpoints associata all'account.
Utilizzando il riquadro di navigazione, seleziona Monitoraggio.
Crea un criterio di avviso per configurare gli avvisi per i indicatori ideali utilizzando quanto segue:
Latenza
- In Tipo di condizione, inserisci
Metric Threshold. - In Tipo di risorsa, inserisci
Produced API. - Per la metrica, inserisci
Request latencies. - Inserisci la soglia per cui vuoi ricevere un avviso e segui il resto della guida agli avvisi.
- In Tipo di condizione, inserisci
Traffico
- In Tipo di condizione, inserisci
Metric Threshold. - In Tipo di risorsa, inserisci
Produced API. - Per la metrica, inserisci
Request count. - Inserisci la soglia per cui vuoi ricevere un avviso e segui il resto della guida agli avvisi.
- In Tipo di condizione, inserisci
Errori
- In Tipo di condizione, inserisci
Metric Threshold. - In Tipo di risorsa, inserisci
Produced API. - Per la metrica, inserisci
Request count. - Per response-code-class, inserisci
5xx. - Inserisci la soglia per cui vuoi ricevere un avviso e segui il resto della guida agli avvisi.
- In Tipo di condizione, inserisci