Monitoraggio di Google Maps Platform

Cloud Monitoring raccoglie le metriche per le API, il servizio e alle risorse della piattaforma Google Cloud 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 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 su Cloud Monitoring documentazione.

Configurazione di Cloud Monitoring

Monitoring 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 per i tuoi progetti siano disponibili, procedi nel seguente modo: seguenti:

  1. Nella console Google Cloud, 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 pagina visualizzata quando è selezionato il progetto AllEnvironments:

    Screenshot delle metriche monitorate per il progetto. Ogni progetto, insieme all'ID progetto e al ruolo.

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

  • Progetto di definizione dell'ambito: questo progetto archivia il tempo di attività di controllo, criteri di avviso, gruppi e dashboard che configuri. C'è un Relazione 1:1 tra un ambito delle metriche e un progetto di definizione dell'ambito. Per questo Ad esempio, il progetto AllEnvironments è il progetto di definizione dell'ambito.
  • Progetto monitorato: le metriche per il parametro sono visibili all'attuale ambito delle metriche. In questo esempio, i progetti di gestione temporanea e produzione sono progetti monitorati.

La tabella con l'etichetta I progetti elencati di seguito possono visualizzare metriche del progetto elenca i progetti il cui ambito delle metriche include progetto attuale. Lo screenshot precedente mostra che nessun altro progetto può accedere le metriche archiviate dal progetto AllEnvironments.

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

esplora le metriche

Per esplorare i dati delle metriche, crea un grafico utilizzando Esplora metriche che è incluso in Cloud Monitoring. Ad esempio, se vuoi l'utilizzo della quota di un'API, puoi usare Esplora metriche per costruisci un grafico che mostra i dati più recenti.

Nell'immagine seguente è riportato un grafico che illustra in dettaglio l'utilizzo della quota per le API di Google Maps:

Screenshot dei dati delle metriche della quota per tutte le API di Google Maps. Mostra un grafico a barre in cui ogni segmento della barra hte 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 grafici, ad esempio grafici a linee, grafici a barre e mappe termiche. Puoi anche creare un singolo grafico che mostri a 10 metriche diverse.

In questa immagine:

  • I campi Tipo di risorsa e Metrica a sinistra del grafico definisci 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, sia impostato su Grafico a barre in pila.
  • L'intervallo di tempo sopra il grafico è impostato su 1 W (una settimana).
  • Sotto il grafico è presente l'elenco di service, quota_metrics, metodo API e metrica value che definisce i dati del grafico. Seleziona Aggiungi. Filtra per utilizzare queste informazioni e perfezionare i dati visualizzati.

Quando esci dalla pagina Esplora metriche, il grafico viene viene eliminato in modo da non avere artefatti indesiderati da eliminare. In alternativa, puoi salvare il grafico in una dashboard personalizzata o condividerlo. Consulta Crea dashboard di seguito per saperne di più informazioni sull'aggiunta di un grafico a una dashboard.

Tracciare un grafico di una metrica singola

Per configurare un grafico utilizzando Esplora metriche, segui questi passaggi:

  1. Nella console Cloud, seleziona Monitoring:

    Vai a Monitoring

  2. Nel riquadro di navigazione, seleziona Esplora metriche.
  3. Nella barra degli strumenti, seleziona Grafico a barre in pila dal grafico. del menu a discesa dei tipi per visualizzare i dati delle metriche sotto forma di grafico a barre.
  4. Seleziona un intervallo di tempo, ad esempio 1 sett. (una settimana).
  5. Specifica i dati da visualizzare nel grafico. Per utilizzare un'interfaccia basata su menu per inserire un filtro, seleziona la scheda Configurazione. Per utilizzare Monitoring Query Language (MQL), seleziona MQL .
    1. Per tracciare un 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 utilizzata o API di Google Maps (consulta Metriche di utilizzo per maggiori 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 Utilizzo quota di frequenza. Il grafico si aggiorna automaticamente per visualizzare la metrica e i dati di Google Cloud. Come vedi, sono disponibili altre opzioni di quota per la metrica. Passa il mouse sopra ogni metrica per visualizzare una descrizione. Per maggiori informazioni informazioni sui campi di Esplora metriche, consulta Selezionare le metriche e Scelta della 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 filtri. Per aggiungere un filtro, seleziona Aggiungi filtro e completa la finestra di dialogo. Per maggiori informazioni le informazioni, vedi 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 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, verrà selezionato automaticamente un valore per il campo Aggregator (Aggregatore).
    3. Per specificare come combinare le serie temporali, imposta l'Aggregatore . Ad esempio, se il campo Raggruppa per è vuoto e Il campo Aggregatore è impostato su significa, quindi il grafico mostra la media delle serie temporali.
    4. Per configurare la modalità di elaborazione delle singole serie temporali, seleziona Opzioni avanzate. Consulta la sezione Selezione quando utilizzi Esplora metriche per saperne di più.

  7. Se vuoi, puoi aggiungerlo a una dashboard.

    Quando esci dalla scheda Esplora metriche, il grafico viene ignorato. Puoi facoltativamente seleziona Salva grafico per salvarlo in un nuovo dashboard esistente. Consulta la sezione Creazione di dashboard. di seguito per ulteriori informazioni sull'aggiunta di un grafico a una dashboard.

Traccia più metriche su un grafico

In alcune situazioni potresti voler visualizzare più metriche contemporaneamente grafico. Ad esempio, potresti voler mostrare il limite di quota negli stessi grafici che viene visualizzato 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 in nella parte inferiore dello schermo.
  2. Seleziona la metrica e specifica come visualizzare le relative serie temporali. nello stesso modo in cui hai configurato la metrica originale sopra.

Per ulteriori informazioni sull'esplorazione delle metriche, consulta:

Creazione di dashboard

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

  • Le dashboard predefinite vengono installate automaticamente ai servizi della piattaforma Google Cloud che utilizzi. Queste dashboard non sono configurabile.
  • Le dashboard personalizzate sono quelle create da te. Le dashboard personalizzate ti consentono di definire i dati che vuoi visualizzare e come visualizzarli e i dati di Google Cloud. Ad esempio, puoi visualizzare dati delle metriche, criteri di avviso e log archiviati nel tuo progetto. Puoi visualizzare i dati delle serie temporali su una grafico, con un indicatore o un prospetto o in formato tabulare.

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

  • Un grafico della quota a sinistra
  • Un grafico del conteggio delle API a destra

Uno screenshot di una dashboard personalizzata che mostra due grafici. Il grafico su a sinistra è presente un grafico della quota, mentre il grafico a destra è un grafico dell'utilizzo dell'API. Entrambi i grafici elencano i punti temporali sul proprio asse orizzontale.

Crea una dashboard personalizzata creando grafici delle metriche e poi aggiungendo il parametro grafici alla dashboard. Puoi creare il grafico nella sezione Metriche Explorer, poi aggiungilo 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 API Cloud Monitoring, Esplora metriche offre due utili utilità:

  • a generare la rappresentazione JSON per un grafico a cui prevedi di aggiungerlo. configura il grafico con Esplora metriche. Puoi quindi accedere Rappresentazione JSON da Altre opzioni nella barra degli strumenti di Esplora metriche.
  • Per identificare la sintassi di un filtro di Monitoring, utilizzato con 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 a modalità di filtro diretto per visualizzare il filtro di Monitoring equivalente.

Crea una dashboard personalizzata

Per creare una dashboard personalizzata:

  1. Nella console Cloud, 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 da dalla libreria 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 dell'esplorazione metriche che utilizzi per creare un grafico per a una dashboard.

    2. Seleziona il Tipo di risorsa e la Metrica. e applicare eventuali filtri come hai fatto in precedenza durante la creazione di un grafico.

      Per ulteriori informazioni sulle scelte disponibili, vedi Aggiungi widget alla dashboard.

  5. (Facoltativo) Nella barra degli strumenti della dashboard, fai clic su Aggiungi grafico. per aggiungere un altro grafico, poi ripeti i passaggi precedenti per personalizzare grafico.
  6. Al termine della modifica, seleziona la Freccia sinistra per uscire dalla dashboard oppure seleziona qualsiasi altra voce di menu in Monitoring. La tua dashboard è stata salvata automaticamente.

Visualizzare una dashboard

Per visualizzare una dashboard, procedi nel seguente modo:

  1. Nella console Cloud, seleziona Monitoring:

    Vai a Monitoring

  2. Nel riquadro di navigazione, seleziona Dashboard.
  3. Seleziona la tua 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 del servizio (tipo di risorsa consumed_api) per la maggior parte delle API Google Cloud e le metriche di Google Maps Platform, Metriche specifiche delle API 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 e version location e credential_id. Vedi le descrizioni delle etichette delle risorse nella documentazione per la risorsa Metrics corrispondente:

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

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

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

Ulteriori dettagli su tipi di metriche ed etichette nella documentazione per i tipi di metriche corrispondenti Gruppo di metriche:

Mappatura delle etichette del codice di risposta e dello stato della risposta

La tabella seguente mostra la mappatura tra il codice di stato della risposta e la risposta HTTP restituito in risposta alle richieste API e alle etichette dei codici di risposta di Google Maps Platform 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 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 Google Maps Codice di risposta HTTP Codice di risposta HTTP Classe del 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 (NON_VALIDO)
INVALID_REQUEST (parametro non valido/mancante, errore di analisi della richiesta) 200,
400		 400 4xx 3 (NON_VALIDO)
REQUEST_DENIED 200, 403,
200, 400		 403,
401(1)		 4xx(1) 7 (PERMISSION_DENIED),
16 (NON AUTENTICATO)
OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT,
RESOURCE_EXHAUSTED,
giornalieroLimite superato,
rateLimitExceeded,
userRateLimitExceeded 		200,
403,
429		 429(1) 4xx(1) 8 (RESOURCE_EXHAUSTED)
UNKNOWN_ERROR 200, 500,
503		 500(1),
503		 5xx(1) 2 (SCONOSCIUTA)/13 (INTERNO)(1),
14 (NON DISPONIBILE)
1 Per migliorare la coerenza dei report sui codici di errore, Google Maps Platform È in corso la migrazione delle API: 1) da codice/classe di risposta HTTP 200/2xx a 404/4xx (e codice di stato GRPC da 0 (OK) a 5 (NOT_FOUND)) per Maps Stati dell'API: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS - stato, 2) da codice/classe di risposta HTTP 200/2xx,400/4xx a 403/4xx (e codice di stato GRPC 7 (PERMISSION_DENIED)) per lo stato dell'API di Google Maps: REQUEST_DENIED, 3) Da codice/classe di risposta HTTP 200/2xx,403/4xx a a 401/4xx (codice di stato GRPC 16 (UNAUTHENTICATED)) per lo stato dell'API di Google Maps: REQUEST_DENIED, 4) da codice/classe di risposta HTTP 200/2xx,403/4xx a 429/4xx per gli stati dell'API di Google Maps: OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded, 5) da codice/classe di risposta HTTP 200/2xx a 500/5xx (e codice di stato GRPC 2 (UNKNOWN), 13 (INTERNAL)) per Stato dell'API di Google Maps: UNKNOWN_ERROR. Durante il periodo di transizione puoi visualizzare entrambi i codici di risposta. Risposta I codici restituiti nelle risposte dell'API di Google Maps non cambiano. Puoi Esplora la suddivisione dei codici di risposta riportati nel tempo in Metrics Explorer.

crea avvisi

Avvisi: consapevolezza tempestiva dei problemi nelle applicazioni, risolvere rapidamente i problemi. In Cloud Monitoring, un criterio di avviso descrive in cui vuoi ricevere un avviso e come vuoi notificato.

I criteri di avviso possono essere semplici o complessi. I criteri di avviso ti consentono configurare se una singola serie temporale può causare il soddisfacimento di una condizione; 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 un periodo di 5 minuti.
  • Invia una notifica al team disponibile quando il 90° percentile di risposte HTTP 200 supera una latenza di 100 ms per 3 o più API.

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

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

In questa immagine:

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

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

  • Un incidente è un record permanente che archivia informazioni le risorse monitorate quando la condizione è stata soddisfatta. Quando la condizione smette di essere soddisfatto, l'incidente viene automaticamente chiuso. Puoi visualizzare tutti gli incidenti, aprire tramite la dashboard per gli avvisi.
  • Sei tu a specificare chi deve ricevere una notifica quando configuri un criterio di avviso. Monitoring supporta i canali di notifica più comuni, tra cui email, Cloud Mobile App e servizi come PagerDuty o Slack. Per un elenco completo canali di notifica, vedi Opzioni di notifica.

Tipi di avvisi

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

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

Vedi Tipi di criteri di avviso per ulteriori informazioni.

Gestisci criteri di avviso

Puoi aggiungere un criterio di avviso al tuo progetto utilizzando il metodo la console Cloud o l'API Cloud Monitoring. Per informazioni su come visualizzare un elenco degli avvisi basati sulle metriche del progetto e le modalità di modifica dei criteri, consulta le seguenti risorse:

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'attivazione di avviso quando La percentuale di utilizzo del servizio Google Maps Platform per qualsiasi API supera le 2 richieste per una finestra di 5 minuti.

Per creare l'avviso, segui questi passaggi:

  1. Nella console Cloud, seleziona Monitoring:

    Vai a Monitoring

  2. Seleziona Avvisi.
  3. Seleziona Modifica canale notifiche per definire in che modo l'avviso emette la relativa notifica. In questo esempio, utilizzerai il tuo indirizzo email.
    1. Per il Canale di posta, seleziona Aggiungi Nuovo.
    2. Inserisci un Indirizzo email e un Indirizzo di visualizzazione Nome.
    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 e poi su Consumata. API come risorsa e Conteggio richieste come metrica. e seleziona Applica.
    2. (Facoltativo) Sotto il grafico è presente l'elenco di service (servizio), quota_metrics, metodo API e metrica valore. Seleziona Aggiungi filtro per filtrare i dati. sulla base di queste informazioni. Ad esempio, puoi utilizzare il filtro per specificare Il metodo deve essere uguale google.places.Autocomplete.http per attivare l'avviso.
    3. In Trasforma dati, seleziona 5 min per il Finestra temporale continua e media per il tipo Funzione finestra temporale continua.
    4. Seleziona Avanti.
  8. In Configura trigger di avviso, imposta la Soglia value su 2 per specificare di attivare l'avviso quando sono presenti più di 2 nell'intervallo di 5 minuti. Nota che il grafico ora mostra linea rossa che indica il limite di avvisi per l'intervallo di tempo selezionato. Da puoi vedere dove è stato attivato un avviso. Puoi utilizzare questo che ti consente di regolare il limite in base alle tue esigenze.
  9. Fai clic su Avanti.
  10. Nell'avviso Configura le notifiche e finalizza pagina:
      .
    1. Seleziona l'indirizzo email che hai creato per la notifica canale.
    2. In Assegna un nome all'avviso, inserisci My Test (Il mio test) Avviso.
    3. Seleziona Crea criterio.
  11. Effettuare 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 sezione Avvisi .
    1. Nella tabella in cui sono elencati gli avvisi, fai clic sull'avviso per visualizzare ulteriori informazioni.
    2. Fai clic sul nome dell'avviso per visualizzarne le informazioni, incluso un grafico che mostra l'evento che l'ha attivato.

Per ulteriori informazioni sugli avvisi, vedi: