Questa pagina descrive come utilizzare la dashboard di Cloud Monitoring per visualizzare le metriche disponibili, creare una dashboard personalizzata e impostare avvisi.
Visualizza le metriche di Firestore in modalità Datastore
Per visualizzare le diverse metriche di Firestore in modalità Datastore e creare grafici, utilizza Metrics Explorer all'interno di Cloud Monitoring nella console Google Cloud. Per saperne di più sulla creazione dei grafici, consulta Creare grafici con Metrics Explorer.
Configura una dashboard di Cloud Monitoring
In Cloud Monitoring, le dashboard personalizzate consentono di visualizzare le informazioni pertinenti in modo organizzato. Ad esempio, potresti creare una dashboard per visualizzare le metriche sulle prestazioni e i criteri di avviso per il tuo progetto nell'ambiente di produzione.
Per ulteriori informazioni sulla configurazione di una dashboard personalizzata, consulta Gestire una dashboard personalizzata e Aggiungere widget della dashboard.
Monitorare i tassi di errore
Puoi creare una dashboard di monitoraggio per monitorare i tassi di errore e garantire la disponibilità del database. Per disponibilità si intende la frequenza con cui il tuo database risponde entro un periodo di tempo previsto con un codice di stato riuscito. Lo SLA di Firestore in modalità Datastore definisce i dettagli specifici di ciò che viene classificato come una richiesta valida.
Il tasso di errore viene determinato dividendo il numero di richieste che hanno generato una risposta di errore per il numero totale di richieste inviate.
È possibile creare una dashboard di esempio per il calcolo dei tassi di errore calcolando il rapporto A/B per api/request_count delle richieste valide con codici di errore 4xx o 5xx in contrasto con il api/request_count di tutte le richieste valide.
Nella figura 1 puoi vedere come visualizzare il rapporto del tasso di errore utilizzando le metriche api/request_count in Metrics Explorer.
crea un criterio di avviso
Cloud Monitoring consente di creare avvisi per ricevere una notifica quando si verifica una modifica in una condizione della metrica. Puoi utilizzare questi avvisi per ricevere notifiche su potenziali problemi prima che abbiano un impatto sui tuoi utenti.
Per saperne di più sulla creazione di avvisi, consulta Creare criteri di avviso per soglia di metriche.
Considera l'esempio seguente in cui creiamo un criterio di avviso di latenza. Il criterio di avviso controlla la latenza P99 in un intervallo continuativo di 5 minuti. Se la latenza p99 rimane superiore a 250 ms per 5 minuti, viene attivato l'avviso.
Console
Nella console Google Cloud, vai alla pagina Monitoring, quindi seleziona notifications Avvisi.
Seleziona Crea criterio.
Seleziona la metrica Latenze di richiesta dalla risorsa API utilizzata.
Aggiungi un filtro di servizio per
datastore.googleapis.com. La metricaapi/request_latenciesviene monitorata per un periodo continuativo di 5 minuti.
Figura 2. Seleziona la metrica api/request_latencies per creare il trigger. Fai clic su Avanti per configurare l'attivatore.
Seleziona Tipi di condizione come Soglia.
Una condizione di soglia è impostata su un valore di soglia di 250 ms. Viene attivato un avviso quando il valore di latenza p99 rimane invariato per l'intero periodo della finestra temporale continua (5 minuti).
Figura 3. Aggiungi la soglia per la metrica. Imposta Valore soglia su 250.
Fai clic su Avanti per configurare le notifiche.
Imposta il nome del criterio di avviso e fai clic su Avanti.
Esamina le configurazioni degli avvisi e fai clic su Crea criterio.
MQL
Puoi implementare lo stesso criterio di avviso di latenza utilizzando una query MQL (Monitoring Query Language). Per altri esempi sull'utilizzo di MQL, consulta Esempi di query MQL.
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'