Monitoraggio di Google Maps Platform

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

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

Cloud Monitoring offre un ampio set di funzionalità e opzioni. Questo argomento presenta 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

Monitoring ti consente di visualizzare e gestire le metriche:

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

Per assicurarti che le metriche dei tuoi progetti siano disponibili, procedi nel seguente modo:

  1. In Google Cloud Console, seleziona Monitoring:

    Vai a Monitoring

  2. Assicurati di aver selezionato il progetto corretto.
  3. Nel riquadro di navigazione di Monitoring, fai clic su > a destra di Ambito delle metriche. Il seguente screenshot mostra la pagina visualizzata quando è selezionato il progetto AllEnvironments:

    Screenshot delle metriche monitorate per il progetto. Sono elencati tutti i progetti,
  insieme al relativo ID progetto e ruolo.

La tabella Metriche monitorate da questo progetto elenca i progetti le cui metriche sono accessibili nell'ambito delle metriche attuali. Ogni riga della tabella elenca un progetto e il ruolo di quel progetto:

  • Progetto di ambito: questo progetto archivia i controlli di uptime, i criteri di avviso, i gruppi e le dashboard che hai configurato. 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 definizione dell'ambito.
  • Progetto monitorato: le metriche del progetto sono visibili all'ambito delle metriche attuale. Per questo esempio, i progetti di gestione temporanea 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 archiviate dal progetto AllEnvironments.

Per ulteriori informazioni, anche su come aggiungere e rimuovere progetti, consulta Configurare Cloud Monitoring.

Esplora 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 Metrics Explorer per creare un grafico che mostra i dati più recenti.

L'immagine seguente mostra un grafico con i dettagli sull'utilizzo della quota per le API di Google Maps:

Screenshot dei dati sulle metriche della quota per tutte le API di Google Maps. Viene visualizzato un grafico a barre in cui ogni segmento di barra corrisponde a un'API diversa.

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

In questa immagine:

  • I campi Tipo di risorsa e Metrica a sinistra del grafico definiscono i dati della metrica visualizzati al suo interno.
  • Il menu a discesa Tipo di grafico sopra il grafico 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 W (una settimana).
  • Sotto il grafico è riportato l'elenco dei servizi, di quota_metrics, del metodo dell'API e del valore della metrica che definiscono i dati del grafico. Seleziona Aggiungi filtro per utilizzare queste informazioni per perfezionare i dati visualizzati.

Quando esci dalla pagina Metrics Explorer, il grafico viene eliminato in modo da non avere artefatti indesiderati da eliminare. In alternativa, puoi salvare il grafico in una dashboard personalizzata o condividerlo. Consulta la sezione Creare dashboard di seguito per ulteriori informazioni sull'aggiunta di un grafico a una dashboard.

Grafico di una singola metrica

Per configurare un grafico utilizzando Metrics Explorer, procedi come segue:

  1. In Cloud Console, seleziona Monitoring:

    Vai a Monitoring

  2. Nel riquadro di navigazione, seleziona Metrics Explorer.
  3. Nella barra degli strumenti, seleziona Grafico a barre in pila dal menu a discesa Tipo di grafico per visualizzare i dati delle metriche sotto forma di 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 il Monitoring Query Language (MQL), seleziona la scheda MQL.
    1. Per registrare l'utilizzo della quota, seleziona Quota consumatore come Tipo di risorsa. In alternativa, se vuoi creare un grafico per l'utilizzo dell'API, seleziona API utilizzata o API Google Maps (consulta la sezione Metriche di utilizzo per ulteriori dettagli sulle metriche di utilizzo disponibili per le API Google Maps Platform). Passa il mouse sopra ogni tipo di risorsa per visualizzarne la descrizione.
    2. Per la metrica, seleziona Tariffa quota utilizzo. Il grafico viene aggiornato automaticamente per mostrare i dati delle metriche. Nota che esistono altre opzioni di quota per la metrica. Passa il mouse sopra ogni metrica per visualizzare una descrizione. Per ulteriori informazioni sui campi di Metrics Explorer, consulta Selezionare le metriche e Scegliere come visualizzare i 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 maggiori informazioni, consulta Filtrare i dati dei grafici. Ad esempio, per visualizzare i dati relativi a 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. Se selezioni un valore per questo campo, viene selezionato 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 Medio, il grafico mostra la media della serie temporale.
    4. Per configurare la modalità di elaborazione delle singole serie temporali, seleziona Opzioni avanzate. Per ulteriori informazioni, consulta la sezione Selezionare le metriche quando utilizzi Metrics Explorer.
  7. (Facoltativo) Aggiungi a una dashboard.

    Quando esci dalla pagina Metrics Explorer, il grafico viene eliminato. Facoltativamente, puoi selezionare Salva grafico per salvare il grafico in una dashboard nuova o esistente. Consulta la sezione Creazione di dashboard riportata di seguito per ulteriori informazioni sull'aggiunta di un grafico a una dashboard.

Grafico di più metriche

In alcuni casi, potresti voler visualizzare più metriche sullo stesso grafico. Ad esempio, potresti voler mostrare il limite di quota negli stessi grafici in cui viene mostrato l'utilizzo della quota. In un grafico possono essere visualizzate al massimo 10 metriche.

Per aggiungere una metrica a un grafico esistente:

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

Per saperne di più sull'esplorazione delle metriche, consulta:

Creare dashboard

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

  • Le dashboard predefinite vengono installate automaticamente per i servizi Google Cloud Platform che utilizzi. Queste dashboard non sono configurabili.
  • Le dashboard personalizzate sono quelle create da te. Le dashboard personalizzate ti consentono di definire i dati da visualizzare e come visualizzare tali dati. Ad esempio, puoi visualizzare dati delle metriche, criteri di avviso e log archiviati nel tuo progetto. Puoi visualizzare i dati delle serie temporali in un grafico, con un indicatore o un prospetto oppure in forma tabulare.

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

  • Un grafico delle quote a sinistra
  • Un grafico del 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 temporali sul loro asse orizzontale.

Creare una dashboard personalizzata creando grafici delle metriche e poi aggiungendo i grafici alla dashboard. Puoi creare il grafico in Metrics Explorer, quindi aggiungerlo a una dashboard nuova o esistente. In alternativa, puoi creare la dashboard e modificarla per aggiungere un grafico.

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

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

Crea una dashboard personalizzata

Per creare una dashboard personalizzata:

  1. In Cloud Console, seleziona Monitoring:

    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 da Aggiungi grafico o trascinane uno dalla raccolta nell'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 Metrics Explorer che utilizzi per creare un grafico da aggiungere a una dashboard.

    2. Seleziona Tipo di risorsa e Metrica e applica gli stessi filtri applicati durante la creazione di un grafico.

      Per maggiori informazioni sulle scelte disponibili, vedi 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 personalizzare il grafico.
  6. Al termine delle modifiche, seleziona la Freccia sinistra per uscire dalla dashboard oppure seleziona qualsiasi altra voce di menu Monitoring. La dashboard viene salvata automaticamente.

Visualizzare una dashboard

Per visualizzare una dashboard, segui questi passaggi:

  1. In Cloud Console, seleziona Monitoring:

    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 delle dashboard, consulta:

Metriche di utilizzo

Sono disponibili due gruppi di metriche per monitorare l'utilizzo delle API di Google Maps Platform: metriche di runtime (tipo di risorsa consumed_api) disponibili per la maggior parte delle API di 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 set di etichette delle risorse per la suddivisione del traffico di utilizzo delle API: project_id, service, method, version, location e credential_id. Consulta le descrizioni delle etichette delle risorse nella documentazione per la risorsa delle metriche corrispondente:

Ogni gruppo di metriche dispone di due tipi di metriche per il monitoraggio dell'utilizzo: Conteggio richieste e Latenze di richiesta.

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

Nella metrica Latenze di richiesta, puoi suddividere il traffico di utilizzo solo per le etichette delle metriche protocol, platform_type, response_code e response_code_class nelle metriche di Google Maps Platform.

Per ulteriori dettagli sui tipi di metriche e sulle etichette, consulta la documentazione relativa al gruppo di metriche corrispondente:

Mappare lo stato delle risposte e le 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 API di Google Maps Platform e le etichette del codice 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 numerico di risposta gRPC per le richieste gRPC o codice equivalente gRPC per richieste HTTP.

Codici di risposta restituiti nelle risposte dell'API Codici di risposta segnalati a Monitoring
Stato dell'API di Google 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) 0 (OK),
5 (NOT_FOUND)(1)
NOT_FOUND (API di Street View statiche, di geolocalizzazione e strade),
ZERO_RESULTS (API di Street View statica)
404 404 4xx 5 (NOT_FOUND)
INVALID_REQUEST (valore del 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)
RICHIESTA_RICHIESTA 200/403 403 4xx 7 (PERMISSION_DENIED)
OVER_Daily_LIMIT,
OVER_QUERY_LIMIT,
RESOURCE_EXHAUSTED,
DailyLimitExceeded,
rateLimitExceeded,
userRateLimitExceeded
200/403,
429
403,
429
4xx 7 (PERMISSION_DENIED),
8 (RESOURCE_EXHAUSTED)
ERRORE_SCONOSCIUTO 200/500,
503
500,
503
5xx 2 (SCONOSCIUTO)
1 Per migliorare la coerenza dei report sul codice di errore, è in corso la migrazione delle API di Google Maps Platform (stato) dal codice/classe di risposta HTTP> 200/2xx a 404/4xx (e il codice di stato GRPC da 0 (OK) a 5 (NOT_FOUND)) per gli stati dell'API di Maps: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS. Durante il periodo di transizione puoi visualizzare entrambi i codici di risposta. I codici di risposta restituiti nelle risposte dell'API di Google Maps non vengono modificati. Puoi esaminare la suddivisione dei codici di risposta segnalati nel tempo in Metrics Explorer.

Creare avvisi

Gli avvisi indicano tempestivamente i problemi nelle applicazioni in modo da poterli risolvere rapidamente. In Cloud Monitoring, un criterio di avviso descrive le circostanze in cui vuoi ricevere avvisi e il modo in cui vuoi ricevere una notifica.

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

  • Inviami una notifica quando il numero di richieste per un'API specifica supera 1000 richieste per un periodo di 5 minuti.
  • Informa il team su chiamata quando il 90° percentile delle risposte HTTP 200 supera una latenza di 100 ms per 3 o più API.

L'immagine seguente mostra una definizione di avviso per generare una notifica quando il numero di richieste per un'API supera le 20 richieste in una finestra di 5 minuti:

Uno screenshot della definizione dell'avviso che mostra il conteggio delle richieste API per tutte le API di Google Maps come righe singole e la soglia di avviso come linea orizzontale.

In questa immagine:

  • Il grafico mostra il numero di chiamate API nel tempo per diverse API.
  • 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, è possibile notare 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 archivia le informazioni sulle risorse monitorate quando la condizione è stata soddisfatta. Quando la condizione non è più soddisfatta, l'incidente viene chiuso automaticamente. Puoi visualizzare tutti gli incidenti, aperti e chiusi, utilizzando la dashboard degli avvisi.
  • Specifica chi deve ricevere una notifica quando configuri un criterio di avviso. Monitoring supporta canali di notifica comuni, tra cui email, Cloud Mobile App e servizi come PagerDuty o Slack. Per un elenco completo dei canali di notifica, consulta Opzioni di notifica.

Tipi di avvisi

Cloud Monitoring supporta molti tipi di avvisi. Ad esempio, puoi definire:

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

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

Gestisci criteri di avviso

Puoi aggiungere un criterio di avviso al progetto utilizzando Cloud Console o l'API Cloud Monitoring. Per informazioni su come visualizzare un elenco di criteri di avviso basati sulle metriche del progetto e su come modificarli, consulta la pagina seguente:

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 un avviso che si attiva quando la percentuale di utilizzo del servizio Google Maps Platform per qualsiasi API supera le 2 richieste per un periodo di 5 minuti.

Per creare l'avviso:

  1. In Cloud Console, seleziona Monitoring:

    Vai a Monitoring

  2. Seleziona Avvisi.
  3. Seleziona Modifica canale di notifica per definire il modo in cui l'avviso emette la notifica. 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, seleziona API utilizzata come risorsa e Conteggio richieste come metrica. Quindi, seleziona Applica.
    2. (Facoltativo) Sotto il grafico è riportato l'elenco dei servizi, quota_metrics, del metodo dell'API e del valore 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 a google.places.Autocomplete.http per attivare l'avviso.
    3. In Trasforma dati seleziona 5 min per la finestra temporale continua e media per la funzione Finestra temporale continua.
    4. Seleziona Avanti.
  8. In Configura trigger di avviso, imposta il Valore soglia su 2 per specificare l'attivazione dell'avviso quando ci sono più di 2 richieste nella finestra di 5 minuti. Il grafico mostra ora la linea rossa che indica il limite di avvisi per l'intervallo di tempo selezionato. Dal grafico potete vedere dove sarebbe stato attivato un avviso. Puoi utilizzare questo grafico per modificare il limite in base alle tue esigenze.
  9. Fai clic su Avanti.
  10. Nella pagina Configura le notifiche e finalizza l'avviso:
    1. Seleziona l'indirizzo email che hai creato per il canale di notifica.
    2. In Assegna un nome all'avviso, inserisci My Test Alert (Il mio avviso di test).
    3. Seleziona Crea criterio.
  11. Effettua 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 per l'avviso, vai alla pagina Avvisi.
    1. Nella tabella degli avvisi della scheda, fai clic sull'avviso per visualizzare ulteriori informazioni.
    2. Fai clic sul nome dell'avviso per visualizzare informazioni sull'avviso, incluso un grafico che mostra l'evento che lo ha attivato.

Per ulteriori informazioni sugli avvisi, vedi: