Utilizzare la dashboard di Cloud Monitoring

Questa pagina descrive come utilizzare una dashboard di Cloud Monitoring per visualizzare le metriche disponibili, creare una dashboard personalizzata e impostare avvisi.

Visualizzare le metriche di Firestore

Per visualizzare le diverse metriche di Firestore e creare grafici, utilizza una delle seguenti opzioni:

  • La pagina Monitoraggio nella sezione Firestore della console Google Cloud. Questa pagina include una dashboard di monitoraggio predefinita. Puoi anche creare fino a una dashboard personalizzata. Per accedere alla pagina Monitoraggio di un database:

    1. Nella console Google Cloud, apri la pagina Database di Firestore.

      Vai a Database

    2. Seleziona un database dall'elenco.

    3. Nel menu di navigazione, fai clic su Monitoraggio per aprire una dashboard.

  • Esplora metriche in Cloud Monitoring nella console Google Cloud. Per ulteriori informazioni sulla creazione di grafici, consulta Creare grafici con Metrics Explorer.

Visualizza la dashboard di Cloud Monitoring

In Cloud Monitoring, le dashboard personalizzate ti consentono di visualizzare le informazioni pertinenti per te in modo organizzato. Ad esempio, potresti creare una dashboard per visualizzare le metriche sul rendimento e i criteri di avviso per il tuo progetto nell'ambiente di produzione.

Per scoprire di più sulla configurazione di una dashboard personalizzata, vedi Gestire una dashboard personalizzata e Aggiungere widget della dashboard.

Monitorare le percentuali di errore

Puoi creare una dashboard di monitoraggio per monitorare i tassi di errore e garantire la disponibilità del database. La disponibilità si riferisce alla frequenza con cui il database risponde entro un periodo di tempo previsto con un codice di stato positivo. L'SLA di Firestore definisce i dettagli specifici di ciò che viene classificato come richiesta valida.

La percentuale di errori viene determinata dividendo il numero di richieste che hanno generato una risposta di errore per il numero totale di richieste inviate.

Un esempio di dashboard per il calcolo delle percentuali di errore può essere creato calcolando il rapporto A/B per api/request_count delle richieste valide con codici di errore 4xx o 5xx rispetto al api/request_count di tutte le richieste valide.

 Informazioni sulla disponibilità con il tasso di errore
Figura 1. Scopri la disponibilità con il tasso di errore.

Nella figura 1 puoi vedere come visualizzare il rapporto sul tasso di errori utilizzando le metriche api/request_count in Metrics Explorer.

Crea un criterio di avviso

Cloud Monitoring ti consente di creare avvisi per informarti quando si verifica una modifica in una condizione della metrica. Puoi utilizzare questi avvisi per ricevere una notifica di potenziali problemi prima che si ripercuotano sugli utenti.

Per saperne di più sulla creazione di avvisi, consulta Creare criteri di avviso basati su soglie di metriche.

Considera l'esempio seguente in cui viene creato un criterio di avviso sulla latenza. Il criterio di avviso controlla la latenza p99 in una finestra temporale continua di 5 minuti. Se la latenza p99 rimane superiore a 250 ms per 5 minuti, viene attivato l'avviso.

Console

  1. Nella console Google Cloud, vai alla pagina Monitoraggio e poi seleziona  Avvisi.

    Vai a Monitoring

  2. Seleziona Crea criterio.

  3. Seleziona la metrica Tempi di latenza della richiesta dalla risorsa API consumata.

  4. Aggiungi un filtro di servizio per firestore.googleapis.com per i database Firestore Native.

    Seleziona la metrica api/request_latencies per creare l'attivatore.
  5. Fai clic su Avanti per configurare l'attivatore.

  6. Seleziona Soglia come Tipo di condizione.

    Una condizione di soglia è impostata su un valore di soglia di 250 ms. Viene attivato un avviso quando il valore della latenza P99 rimane invariato per l'intero periodo della finestra mobile (5 minuti).

    Aggiungi la soglia per la metrica.
  7. Imposta il Valore soglia su 250.

  8. Fai clic su Avanti per configurare le notifiche.

  9. Imposta il nome del criterio di avviso e fai clic su Avanti.

  10. Rivedi le configurazioni degli avvisi e fai clic su Crea criterio.

MQL

Puoi implementare lo stesso criterio di avviso sulla latenza utilizzando una query Monitoring Query Language (MQL). Per altri esempi di utilizzo di MQL, consulta Query MQL di esempio.

      fetch consumed_api
      | metric 'serviceruntime.googleapis.com/api/request_latencies'
      | filter (resource.service == 'firestore.googleapis.com')
      | group_by 5m,
          [value_request_latencies_percentile:
            percentile(value.request_latencies, 99)]
      | every 5m
      | condition val() > 0.25 's'