Monitoraggio di Google Maps Platform

Cloud Monitoring raccoglie le metriche per le API e il servizio e per le risorse Google Cloud che utilizzi. Questo argomento descrive come configurare Cloud Monitoring e come utilizzarlo per monitorare l'utilizzo delle API, creare dashboard e avvisi.

Cloud Monitoring offre un ampio insieme di funzionalità e opzioni. Questo argomento introduce Cloud Monitoring e fornisce esempi di base. Per informazioni su tutte le funzionalità, inclusi molti altri esempi, consulta la documentazione di Cloud Monitoring.

Configurazione di Cloud Monitoring

Il monitoraggio ti consente di visualizzare e gestire le metriche:

  • Per un singolo progetto
  • Per più progetti all'interno di un'unica organizzazione
  • Per più progetti in più organizzazioni

Per assicurarti che le metriche per i tuoi progetti siano disponibili:

  1. Nella console Google Cloud, seleziona Monitoraggio:

    Vai a Monitoring

  2. Assicurati di aver selezionato il progetto corretto.
  3. Nel riquadro di navigazione di Monitoraggio, fai clic su > a destra di Ambito delle metriche. Lo screenshot seguente mostra la pagina visualizzata quando viene selezionato il progetto Tutti gli ambienti:

    Screenshot delle metriche monitorate per il progetto. Ogni progetto, insieme al relativo ID progetto e ruolo, è elencato.

La tabella Metriche monitorate da questo progetto elenca i progetti le cui metriche sono accessibili all'ambito delle metriche corrente. Ogni riga della tabella elenca un progetto e il relativo ruolo:

  • Progetto di ambito: questo progetto memorizza i controlli di uptime, i criteri di avviso, i gruppi e le dashboard che configuri. Esiste una relazione 1:1 tra un ambito delle metriche e un progetto di definizione dell'ambito. Per questo esempio, il progetto AllEnvironments è il progetto di ambito.
  • Progetto monitorato: le metriche del progetto sono visibili nell'ambito delle metriche corrente. Per questo esempio, i progetti di staging e di produzione sono progetti monitorati.

La tabella I progetti elencati di seguito possono visualizzare le metriche di questo progetto elenca i progetti il cui ambito delle metriche include il progetto corrente. Lo screenshot precedente mostra che nessun altro progetto può accedere alle metriche memorizzate dal progetto Tutti gli ambienti.

Per ulteriori informazioni, inclusa la procedura per aggiungere e rimuovere i progetti, consulta Configurare Cloud Monitoring.

esplora le metriche

Per esplorare i dati delle metriche, crea un grafico utilizzando Metrics Explorer , incluso in Cloud Monitoring. Ad esempio, se vuoi visualizzare l'utilizzo della quota di un'API, puoi utilizzare Esplora metriche per creare un grafico che mostri i dati più recenti.

L'immagine seguente mostra un grafico che illustra l'utilizzo della quota per le API Maps:

Screenshot dei dati delle metriche relative alle quote per tutte le API Maps. Mostra un grafico a barre in cui ogni segmento della barra corrisponde a un'API diversa.

Questo esempio mostra un grafico a barre in cui ogni API è rappresentata da una sezione della barra. Puoi creare diversi tipi di grafici, ad esempio grafici a linee, a barre e mappe termiche. Puoi anche creare un singolo grafico che mostri fino a 10 metriche diverse.

In questa immagine:

  • I campi Tipo di risorsa e Metrica a sinistra del grafico definiscono i dati delle metriche visualizzati nel grafico.
  • Il menu a discesa del tipo di grafico sopra il grafico ti consente di selezionare il tipo di grafico. In questo esempio, è impostato su Grafico a barre in pila.
  • L'intervallo di tempo sopra il grafico è impostato su 1 settimana.
  • Sotto il grafico è riportato l'elenco di service, quota_metrics, method dell'API e value della metrica che definiscono i dati del grafico. Seleziona Aggiungi filtro per utilizzare queste informazioni per perfezionare i dati visualizzati.

Quando esci dalla pagina di Esplora metriche, il grafico viene eliminato, quindi non devi eliminare artefatti indesiderati. In alternativa, puoi salvare il grafico in una dashboard personalizzata o condividerlo. Per ulteriori informazioni sull'aggiunta di un grafico a una dashboard, consulta Creare dashboard di seguito.

Grafico di una singola metrica

Per configurare un grafico utilizzando Metrics Explorer:

  1. Nella console Cloud, seleziona Monitoraggio:

    Vai a Monitoring

  2. Nel riquadro di navigazione, seleziona Esplora metriche.
  3. Nella barra degli strumenti, seleziona Grafico a barre in pila dal menu a discesa del tipo di grafico per visualizzare i dati delle metriche come grafico a barre.
  4. Seleziona un intervallo di tempo, ad esempio 1W (una settimana).
  5. Specifica i dati da visualizzare nel grafico. Per utilizzare un'interfaccia basata su menu o inserire un filtro, seleziona la scheda Configurazione. Per utilizzare Monitoring Query Language (MQL), seleziona la scheda MQL.
    1. Per visualizzare il grafico dell'utilizzo della quota, seleziona Consumer Quota (Quota consumer) come Tipo di risorsa. In alternativa, se vuoi creare un grafico per l'utilizzo dell'API, seleziona API consumata o API Google Maps (consulta la sezione Metriche di utilizzo per ulteriori dettagli sulle metriche di utilizzo disponibili per le API di Google Maps Platform). Passa il mouse sopra ogni tipo di risorsa per visualizzarne la descrizione.
    2. Per la metrica, seleziona Rate quota usage (Utilizzo quota di frequenza). Il grafico viene aggiornato automaticamente per visualizzare i dati delle metriche. Tieni presente che esistono altre opzioni di quota per la metrica. Passa il mouse sopra ogni metrica per visualizzarne una descrizione. Per ulteriori informazioni sui campi di Esplora metriche, consulta Selezione delle metriche e Scegliere la modalità di visualizzazione dei dati dei grafici.
  6. (Facoltativo) Utilizza le seguenti opzioni per perfezionare la visualizzazione:
    1. Per specificare un sottoinsieme di dati da visualizzare, aggiungi i filtri. Per aggiungere un filtro, seleziona Aggiungi filtro e completa la finestra di dialogo. Per ulteriori informazioni, consulta la sezione Filtrare i dati dei grafici. Ad esempio, per visualizzare i dati di una singola API:
      1. Nel campo Etichetta, seleziona metodo.
      2. Nel campo Confronto, seleziona = (uguale a).
      3. Nel campo Valore, seleziona il nome di un metodo specifico. Ti verrà chiesto di selezionare il nome di un metodo con i dati da visualizzare.
      4. Seleziona Fine per aggiornare il grafico.
    2. Per raggruppare le serie temporali in base a un'etichetta, utilizza il campo Raggruppa per. La selezione di un valore per questo campo seleziona automaticamente un valore per il campo Aggregatore.
    3. Per specificare come combinare le serie temporali, imposta il campo Aggregatore. Ad esempio, se il campo Raggruppa per è vuoto e il campo Aggregatore è impostato su media, il grafico mostra la media della serie temporale.
    4. Per configurare il modo in cui vengono elaborate le singole serie temporali, seleziona Opzioni avanzate. Per ulteriori informazioni, consulta Selezione delle metriche durante l'utilizzo di Metrics Explorer.

  7. (Facoltativo) Aggiungili a una dashboard.

    Quando esci dalla pagina Metrics Explorer, il grafico viene ignorato. Se vuoi, puoi selezionare Salva grafico per salvarlo in una dashboard nuova o esistente. Per ulteriori informazioni sull'aggiunta di un grafico a una dashboard, consulta la sezione Creare dashboard riportata di seguito.

Grafico con più metriche

In alcuni casi, potresti voler visualizzare più metriche nello stesso grafico. Ad esempio, potresti voler mostrare il limite di quota negli stessi grafici in cui mostri l'utilizzo della quota. Un grafico può mostrare un massimo di 10 metriche.

Per aggiungere una metrica a un grafico esistente:

  1. Nel grafico esistente, seleziona Aggiungi un'altra metrica nella parte inferiore dello schermo.
  2. Seleziona la metrica, quindi specifica come visualizzare la serie temporale per la metrica stessa nello stesso modo in cui hai configurato la metrica originale sopra.

Per ulteriori informazioni sull'esplorazione delle metriche, consulta:

Creare dashboard

Le dashboard ti consentono di visualizzare e monitorare i dati delle serie temporali come una raccolta di grafici. Cloud Monitoring supporta dashboard predefinite e personalizzate:

  • Le dashboard predefinite vengono installate automaticamente per i servizi Google Cloud che utilizzi. Queste dashboard non sono configurabili.
  • Le dashboard personalizzate sono quelle che crei. Le dashboard personalizzate ti consentono di definire i dati da visualizzare e la modalità di visualizzazione. Ad esempio, puoi visualizzare i dati delle metriche, i criteri di avviso e i log memorizzati nel progetto. Puoi visualizzare i dati delle serie temporali su un grafico, con un indicatore o una scheda di controllo o in formato tabulare.

Per creare dashboard personalizzate, puoi utilizzare la console Cloud o l'API Cloud Monitoring. L'immagine seguente mostra una dashboard personalizzata con due grafici:

  • Un grafico delle quote a sinistra
  • Un grafico sul conteggio delle API a destra

Uno screenshot di una dashboard personalizzata che mostra due grafici. Il grafico a sinistra è un grafico delle quote, mentre quello a destra è un grafico dell'utilizzo dell'API. Entrambi i grafici elencano i punti nel tempo sull'asse orizzontale.

Crea una dashboard personalizzata creando grafici delle metriche e poi aggiungendoli alla dashboard. Puoi creare il grafico nell'esploratore metriche, quindi aggiungerlo a una dashboard nuova o esistente. In alternativa, puoi creare la dashboard e poi modificarla per aggiungere un grafico.

Se scegli di gestire le dashboard personalizzate utilizzando l'API Cloud Monitoring, Metrics Explorer fornisce due utilità utili:

  • Per generare la rappresentazione JSON di un grafico che intendi aggiungere a una dashboard, configura il grafico con Metrics Explorer. Puoi quindi accedere alla representation JSON dal menu Altre opzioni nella barra degli strumenti di Metrics Explorer.
  • Per identificare la sintassi di un filtro di monitoraggio, utilizzato con l'API Cloud Monitoring, utilizza l'interfaccia basata su menu di Esplora metriche per configurare il grafico. Dopo aver selezionato la metrica e i filtri, passa alla modalità di filtro diretto per visualizzare il filtro di monitoraggio equivalente.

Creare una dashboard personalizzata

Per creare una dashboard personalizzata:

  1. Nella console Cloud, seleziona Monitoraggio:

    Vai a Monitoring

  2. Nel riquadro di navigazione, seleziona Dashboard.
  3. Nella pagina Panoramica delle dashboard, fai clic su Crea dashboard.
  4. Per ogni grafico che vuoi aggiungere alla dashboard:

    1. Seleziona un tipo di grafico in Aggiungi grafico o trascinane uno dalla raccolta all'area del grafico.

      Viene visualizzato un grafico preconfigurato del tipo selezionato. L'esempio seguente mostra un grafico a linee e il relativo riquadro di configurazione:

      Uno screenshot di Esplora metriche che utilizzi per creare un grafico da aggiungere a una dashboard.

    2. Seleziona Tipo di risorsa e Metrica, quindi applica eventuali filtri come indicato sopra per la creazione di un grafico.

      Per ulteriori informazioni sulle tue scelte, consulta Aggiungere widget della dashboard.

  5. (Facoltativo) Nella barra degli strumenti della dashboard, fai clic su Aggiungi grafico per aggiungere un altro grafico, quindi ripeti i passaggi precedenti per personalizzarlo.
  6. Al termine della modifica, seleziona la Freccia sinistra per uscire dalla dashboard o qualsiasi altro elemento del menu Monitoraggio. La dashboard viene salvata automaticamente.

Visualizzare una dashboard

Per visualizzare una dashboard:

  1. Nella console Cloud, seleziona Monitoraggio:

    Vai a Monitoring

  2. Nel riquadro di navigazione, seleziona Dashboard.
  3. Seleziona la dashboard personalizzata o una dashboard predefinita dall'elenco.

Per ulteriori informazioni sulla creazione di dashboard, consulta:

Metriche di utilizzo

Per il monitoraggio dell'utilizzo delle API di Google Maps Platform sono disponibili due gruppi di metriche: Metriche di runtime del servizio (tipo di risorsa consumed_api) disponibili per la maggior parte delle API Google Cloud e Metriche di Google Maps Platform, metriche specifiche delle API di Google Maps Platform (tipo di risorsa maps.googleapis.com/Api).

Entrambe le metriche supportano lo stesso insieme di etichette delle risorse per suddividere il traffico di utilizzo delle API:project_id, service, method, version,location e credential_id. Consulta le descrizioni delle etichette delle risorse nella documentazione della risorsa Metrics corrispondente:

Ogni gruppo di metriche ha due tipi di metriche per il monitoraggio dell'utilizzo: Conteggio richieste e Tempi di latenza delle richieste.

Nella metrica Conteggio richieste puoi suddividere il traffico di utilizzo in base alle etichette delle metriche protocol, grpc_status_code, response_code e response_code_class. Inoltre, puoi suddividere per platform_type nelle metriche di Google Maps Platform.

Nella metrica Tempi di latenza delle richieste puoi suddividere il traffico di utilizzo in base alle etichette delle metriche protocol, platform_type, response_code e response_code_class solo nelle metriche di Google Maps Platform.

Per ulteriori dettagli su tipi di metriche ed etichette, consulta la documentazione del gruppo Metriche corrispondente:

Mappatura degli stati di risposta e delle etichette dei codici di risposta

La tabella seguente mostra la mappatura tra il codice di stato della risposta e il codice di risposta HTTP restituito in risposta alle richieste dell'API Google Maps Platform e alle etichette dei codici di risposta disponibili in Cloud Monitoring: codice di risposta HTTP, classe del codice di risposta HTTP, codice di stato GRPC. Il codice di stato gRPC è un codice di risposta gRPC numerico per le richieste gRPC o un codice equivalente gRPC per le richieste HTTP.

Codici di risposta restituiti nelle risposte dell'API Codici di risposta segnalati a Monitoring
Stato dell'API di Maps Codice di risposta HTTP Codice di risposta HTTP Classe codice di risposta HTTP Codice di stato GRPC
Ok 200,
204,
302		 200,
204,
302		 2xx,
3xx		 0 (OK)
DATA_NOT_AVAILABLE,
NOT_FOUND,
ZERO_RESULTS		 200 200, 404(1) 2xx,
4xx(1)		 5 (NOT_FOUND)(1)
INVALID_REQUEST (valore parametro non valido),
MAX_ROUTE_LENGTH_EXCEEDED,
MAX_WAYPOINTS_EXCEEDED,
ecc.		 200,
400		 400 4xx 3 (INVALID_ARGUMENT)
INVALID_REQUEST (parametro non valido/mancante, errore di analisi della richiesta) 200,
400		 400 4xx 3 (INVALID_ARGUMENT)
REQUEST_DENIED 200, 403,
200, 400		 403,
401(1)		 4xx(1) 7 (PERMISSION_DENIED),
16 (UNAUTHENTICATED)
OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT,
RESOURCE_EXHAUSTED,
dailyLimitExceeded,
rateLimitExceeded,
userRateLimitExceeded 		200,
403,
429		 429(1) 4xx(1) 8 (RESOURCE_EXHAUSTED)
UNKNOWN_ERROR 200, 500,
503		 500(1),
503		 5xx(1) 2 (SCONOSCIUTO)/13 (INTERNO)(1),
14 (NON DISPONIBILE)
1 Per migliorare la coerenza della segnalazione dei codici di errore, le API di Google Maps Platform stanno eseguendo la migrazione: 1) dal codice/dalla classe di risposta HTTP 200/2xx a 404/4xx (e dal codice di stato GRPC da 0 (OK) a 5 (NOT_FOUND)) per gli stati dell'API Maps: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS - status, 2) dal codice/dalla classe di risposta HTTP 200/2xx,400/4xx a 403/4xx (e dal codice di stato GRPC 7 (PERMISSION_DENIED)) per lo stato dell'API Maps: REQUEST_DENIED, 3) dal codice/dalla classe di risposta HTTP 200/2xx,403/4xx a a 401/4xx (codice di stato GRPC 16 (UNAUTHENTICATED)) per lo stato dell'API Maps: REQUEST_DENIED, 4) dal codice/dalla classe di risposta HTTP 200/2xx,403/4xx a 429/4xx per gli stati dell'API Maps: OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded, 5) dal codice/dalla classe di risposta HTTP 200/2xx a 500/5xx (e dal codice di stato GRPC 2 (UNKNOWN), 13 (INTERNAL)) per lo stato dell'API Maps: UNKNOWN_ERROR. Durante il periodo di transizione puoi vedere entrambi i codici di risposta. I codici di risposta restituiti nelle risposte dell'API di Maps non cambieranno. Puoi esaminare la suddivisione dei codici di risposta registrati nel tempo in Explorer di metriche.

crea avvisi

La funzionalità Avvisi ti consente di essere informato in tempo reale sui problemi delle tue applicazioni, in modo da poterli risolvere rapidamente. In Cloud Monitoring, un criterio di avviso descrive le circostanze in cui vuoi ricevere un avviso e la modalità di invio della notifica.

I criteri di avviso possono essere semplici o complessi. I criteri di avviso ti consentono di configurare se una singola serie temporale può causare la soddisfazione di una condizione o se più serie temporali devono soddisfare la condizione prima che venga soddisfatta. Ad esempio:

  • Inviami una notifica quando il numero di richieste per un'API specifica supera 1000 richieste per finestra di 5 minuti.
  • Avvisa il team di assistenza quando il 90° percentile delle risposte HTTP 200 supera una latenza di 100 ms per tre o più API.

L'immagine seguente mostra una definizione di avviso per generare una notifica quando il conteggio delle richieste per un'API supera 20 richieste in un intervallo di 5 minuti:

Uno screenshot della definizione di avviso che mostra i conteggi delle richieste API per tutte le API Maps come singole righe e la soglia di avviso come una linea orizzontale.

In questa immagine:

  • Il grafico mostra il numero di chiamate API nel tempo per API diverse.
  • La linea rossa mostra la soglia di avviso. Le chiamate API che superano questa soglia per una finestra di 5 minuti attivano l'avviso. In questo esempio, puoi vedere che un'API ha superato il limite.

Quando le condizioni di un criterio di avviso sono soddisfatte, Cloud Monitoring apre un incidente e invia notifiche:

  • Un incidente è un record permanente che memorizza le informazioni sulle risorse monitorate quando la condizione è soddisfatta. Quando la condizione non viene più soddisfatta, l'incidente viene chiuso automaticamente. Puoi visualizzare tutti gli incidenti, aperti e chiusi, utilizzando la dashboard degli avvisi.
  • Quando configuri un criterio di avviso, specifichi chi deve ricevere una notifica. Monitoring supporta i canali di notifica comuni, tra cui email, app mobile Cloud e servizi come PagerDuty o Slack. Per un elenco completo dei canali di notifica, consulta Opzioni di notifica.

Tipi di avvisi

Il monitoraggio cloud supporta molti tipi di avvisi. Ad esempio, puoi definire:

  • Avvisi di soglia delle metriche: attiva un avviso se una metrica supera o scende al di sotto di un valore per una finestra temporale specifica o se una metrica aumenta o diminuisce di una percentuale predefinita.
  • Avvisi relativi al budget: imposta regole di soglia per attivare le notifiche quando i costi (effettivi o previsti) superano una percentuale del budget (in base alle regole impostate). L'avviso non limita l'utilizzo dell'API, ma ti avvisa solo quando l'importo della spesa si avvicina a quello specificato.
  • Avvisi sulle quote: Google Cloud stabilisce varie quote che puoi utilizzare per monitorare e limitare le risorse consumate da un progetto o un'organizzazione. Utilizza gli avvisi per inviare notifiche quando il tuo utilizzo si avvicina a un limite di quota.

Per ulteriori informazioni, consulta la sezione Tipi di criteri di avviso.

Gestire i criteri di avviso

Puoi aggiungere un criterio di avviso al tuo progetto utilizzando la console Cloud o l'API Cloud Monitoring. Per informazioni su come visualizzare un elenco dei criteri di avviso basati su metriche del progetto e su come modificarli, consulta quanto segue:

Crea un avviso

Quando crei un avviso:

  • Definisci le condizioni che attivano gli avvisi in base ai dati delle metriche.
  • Definisci i canali di notifica a cui verranno inviate le notifiche di avviso.

L'esempio seguente mostra come configurare l'attivazione di un avviso quando il tasso di utilizzo del servizio Google Maps Platform per qualsiasi API supera le 2 richieste per un intervallo di 5 minuti.

Per creare l'avviso:

  1. Nella console Cloud, seleziona Monitoraggio:

    Vai a Monitoring

  2. Seleziona Avvisi.
  3. Seleziona Modifica canale di notifica per definire la modalità di invio della notifica da parte dell'avviso. In questo esempio, utilizzerai il tuo indirizzo email.
    1. Per il canale Email, seleziona Aggiungi nuovo.
    2. Inserisci un Indirizzo email e un Nome visualizzato.
    3. Seleziona Salva.
  4. Seleziona Avvisi.
  5. Seleziona Crea criterio.
  6. Seleziona un intervallo di tempo, ad esempio 7 giorni.
  7. In Condizioni di avviso, seleziona Nuova condizione:
    1. Fai clic su Seleziona una metrica, poi seleziona API consumata come risorsa e Conteggio richieste come metrica, quindi seleziona Applica.
    2. (Facoltativo) Sotto il grafico è riportato l'elenco di service, quota_metrics, method dell'API e value della metrica. Seleziona Aggiungi filtro per filtrare i dati in base a queste informazioni. Ad esempio, puoi utilizzare il filtro per specificare che il metodo deve essere uguale google.places.Autocomplete.http per attivare l'avviso.
    3. In Trasforma i dati, seleziona 5 min per la Finestra temporale continua e media per la Funzione finestra temporale continua.
    4. Seleziona Avanti.
  8. In Configura l'attivatore di avvisi, imposta il Valore soglia su 2 per specificare di attivare l'avviso quando sono presenti più di 2 richieste nell'intervallo di 5 minuti. Ora il grafico mostra la linea rossa che indica il limite di avviso per l'intervallo di tempo selezionato. Nel grafico puoi vedere dove sarebbe stato attivato un avviso. Puoi utilizzare questo grafico per regolare il limite in base alle tue esigenze.
  9. Fai clic su Avanti.
  10. Nella pagina Configurare le notifiche e finalizzare l'avviso:
    1. Seleziona l'indirizzo email che hai creato per il canale di notifica.
    2. In Assegna un nome all'avviso, inserisci Il mio avviso di test.
    3. Seleziona Crea criterio.
  11. Esegui alcune richieste API. Assicurati di effettuare più di due richieste API entro cinque minuti per generare la notifica via email di avviso.
  12. Dopo aver ricevuto l'email relativa all'avviso, vai alla pagina Avvisi.
    1. Nella tabella che elenca gli avvisi, fai clic sull'avviso per visualizzare ulteriori informazioni.
    2. Fai clic sul nome dell'avviso per visualizzare le relative informazioni, incluso un grafico che mostra l'evento che lo ha attivato.

Per ulteriori informazioni sugli avvisi, consulta: