Seleziona le metriche quando utilizzi Metrics Explorer

Questo documento descrive come configurare un grafico temporaneo che mostra i dati delle serie temporali raccolti dal tuo progetto. Metrics Explorer può visualizzare solo dati numerici delle serie temporali.

Seleziona i dati da visualizzare

Per configurare le serie temporali da visualizzare in un grafico, puoi creare una query effettuando selezioni dai menu oppure scriverne una. Quando scrivi una query, selezioni il relativo linguaggio e poi utilizzi un editor di query o un'interfaccia basata su testo:

• Le query MQL (Monitoring Query Language) specificano le serie temporali e il modo in cui vengono raggruppate e allineate. L'interfaccia MQL supporta un editor di codice con suggerimenti e controlli della sintassi.

  In genere non è possibile convertire le query MQL in moduli utilizzabili da altre interfacce. Le query non salvate vengono eliminate quando si passa alla o dalla scheda MQL.

• Le query Prometheus Query Language (PromQL) specificano le serie temporali e il modo in cui queste sono raggruppate e allineate. L'interfaccia PromQL supporta un editor con suggerimenti.

  In genere non è possibile convertire le query PromQL in moduli utilizzabili da altre interfacce. Le query non salvate vengono eliminate quando si passa alla o dalla scheda PromQL.

• Le query di filtro di monitoraggio specificano le serie temporali ma non includono istruzioni di raggruppamento o di allineamento.

  Qualsiasi serie temporale che può essere tracciata da Monitoring può essere specificata utilizzando un filtro di Monitoring. Ad esempio, per rappresentare su grafico il numero di processi in esecuzione su una VM, devi utilizzare un filtro di Monitoring che specifica una funzione.

  Non è sempre possibile convertire un filtro di Monitoring nel modulo richiesto da altre interfacce. Di conseguenza, la query potrebbe essere ignorata se passi a un'interfaccia diversa.

In genere le query specificano un tipo di metrica, un tipo di risorsa e filtri:

• Un tipo di metrica identifica le misurazioni da raccogliere da una risorsa. Include una descrizione di ciò che viene misurato e di come le misurazioni vengono interpretate. Talvolta, un tipo di metrica viene definito metrica. Un esempio di metrica è "Utilizzo CPU". Per informazioni concettuali, consulta Tipi di metriche.

• Un tipo di risorsa specifica da quale risorsa vengono acquisiti i dati della metrica. Il tipo di risorsa viene a volte chiamato tipo di risorsa monitorata o risorsa. Un esempio di risorsa è un'"istanza di macchina virtuale (VM) Compute Engine". Per informazioni concettuali, consulta Risorse monitorate.

Sia le query MQL che PromQL includono istruzioni di raggruppamento e di allineamento. Tuttavia, quando scrivi un filtro di Monitoring o utilizzi i menu per selezionare le serie temporali da rappresentare su grafico, puoi configurare le impostazioni di raggruppamento e allineamento utilizzando i menu.

Nota: nella console Google Cloud è possibile visualizzare solo dati numerici. Per recuperare le metriche con un tipo di String, utilizza un metodo nell'API, ad esempio timeSeries.list.

Crea query utilizzando i menu

La creazione di query tramite menu è la configurazione predefinita. In genere, se selezioni una metrica e un filtro e poi passi a un'interfaccia diversa, le selezioni vengono conservate e riformattate per l'interfaccia. Ciò significa che una query creata da menu può essere convertita in una query MQL.

Puoi tornare dalle altre interfacce all'interfaccia basata su menu selezionando Builder. Tuttavia, la query viene ignorata. Ciò significa che una query MQL non può essere convertita in un modulo equivalente basato su menu.

Legacy

Per creare la query utilizzando i menu:

1. Nella console Google Cloud, seleziona Monitoring, quindi  Metrics Explorer oppure fai clic sul pulsante seguente:

   Vai a Metrics Explorer

2. Nella barra degli strumenti del riquadro delle query, procedi nel seguente modo:

   1. Espandi il menu Seleziona una metrica.

   2. (Facoltativo) Per ridurre il numero di opzioni visualizzate nel menu, inserisci il nome della metrica o della risorsa nella barra dei filtri . Ad esempio, se inserisci util limiti il menu in modo da visualizzare le voci che includono util. Le voci vengono mostrate quando superano un test "contiene" senza distinzione tra maiuscole e minuscole.

      Per visualizzare un elenco di tutte le metriche, anche quelle senza dati recenti, attiva l'opzione Mostra solo risorse e metriche attive. Per impostazione predefinita, nei menu vengono mostrate solo le metriche e le risorse con dati.

   3. Nel menu Risorse, seleziona la risorsa da cui vengono acquisiti i dati della metrica.

      Quando una metrica non viene scritta su una risorsa, seleziona Non specificato.

   4. Nel menu Categorie di metriche, seleziona la categoria della metrica.

      In genere la categoria corrisponde al primo termine dopo il dominio del servizio. Se ad esempio viene utilizzato il tipo di metrica di Compute Engine compute.googleapis.com/instance/utilization, il dominio di servizio è compute.googleapis.com e la categoria è instance.

   5. Nel menu Metriche, seleziona la metrica da rappresentare su grafico.

   6. Fai clic su Applica.

   Ad esempio, per rappresentare graficamente l'utilizzo della CPU di una macchina virtuale di Compute Engine, segui questi passaggi:

   1. Inserisci util nella barra dei filtri .
   2. Nel menu Risorse, seleziona Istanza VM.
   3. Nel menu Categorie di metriche, seleziona Istanza.
   4. Nel menu Metriche, seleziona Utilizzo CPU e fai clic su Applica.

   Dopo aver selezionato il tipo di risorsa e la metrica, il grafico mostra tutte le serie temporali disponibili per quella coppia:

   

   Il grafico precedente contiene più dati di quelli che possono essere visualizzati; i grafici hanno un limite di 50 linee visualizzabili. Il grafico segnala che ci sono troppi dati da visualizzare. Per ridurre la quantità di dati, fai clic su Aggiungi ordinamento e limite, quindi completa la finestra di dialogo. Per ulteriori informazioni, consulta la pagina Mostrare i valori anomali.

   Puoi anche utilizzare le opzioni di filtro e aggregazione per ridurre la quantità di dati del grafico. Queste tecniche rendono i grafici più utili per la diagnostica e l'analisi e aumentano le prestazioni e la reattività dell'interfaccia utente stessa.

3. (Facoltativo) Aggiungi filtri per limitare le serie temporali da visualizzare. La sezione successiva descrive le opzioni di filtro.

4. (Facoltativo) Configura il modo in cui le serie temporali vengono raggruppate e allineate. Per ulteriori informazioni, consulta Scegliere come visualizzare i dati dei grafici.

Anteprima

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Per creare la query utilizzando i menu:

1. Nella console Google Cloud, seleziona Monitoring, quindi  Metrics Explorer oppure fai clic sul pulsante seguente:

   Vai a Metrics Explorer

2. Nella barra degli strumenti del riquadro delle query, procedi nel seguente modo:

   1. Nell'elemento Metrica, espandi il menu Seleziona una metrica.

   2. (Facoltativo) Per ridurre il numero di opzioni visualizzate nel menu, inserisci il nome della metrica o della risorsa nella barra dei filtri . Ad esempio, se inserisci util limiti il menu in modo da visualizzare le voci che includono util. Le voci vengono mostrate quando superano un test "contiene" senza distinzione tra maiuscole e minuscole.

      Per visualizzare un elenco di tutte le metriche, anche quelle senza dati recenti, attiva l'opzione Mostra solo risorse e metriche attive. Per impostazione predefinita, nei menu vengono mostrate solo le metriche e le risorse con dati.

   3. Nel menu Risorse, seleziona la risorsa da cui vengono acquisiti i dati della metrica.

      Quando una metrica non viene scritta su una risorsa, seleziona Non specificato.

   4. Nel menu Categorie di metriche, seleziona la categoria della metrica.

      In genere la categoria corrisponde al primo termine dopo il dominio del servizio. Se ad esempio viene utilizzato il tipo di metrica di Compute Engine compute.googleapis.com/instance/utilization, il dominio di servizio è compute.googleapis.com e la categoria è instance.

   5. Nel menu Metriche, seleziona la metrica da rappresentare su grafico.

   6. Fai clic su Applica.

   Ad esempio, per rappresentare graficamente l'utilizzo della CPU di una macchina virtuale di Compute Engine, segui questi passaggi:

   1. Inserisci util nella barra dei filtri .
   2. Nel menu Risorse, seleziona Istanza VM.
   3. Nel menu Categorie di metriche, seleziona Istanza.
   4. Nel menu Metriche, seleziona Utilizzo CPU e fai clic su Applica.

   Dopo aver selezionato il tipo di risorsa e la metrica, il grafico mostra tutte le serie temporali disponibili per quella coppia:

   

   Il grafico precedente contiene più dati di quelli che possono essere visualizzati; i grafici hanno un limite di 50 linee visualizzabili. Il grafico segnala che ci sono troppi dati da visualizzare. Per ridurre la quantità di dati, utilizza l'elemento Ordina e limita nella barra degli strumenti delle query. Per ulteriori informazioni, consulta la pagina Mostrare i valori anomali.

   Puoi anche utilizzare le opzioni di filtro e aggregazione per ridurre la quantità di dati nei grafici. Queste tecniche rendono i grafici più utili per la diagnostica e l'analisi e aumentano le prestazioni e la reattività dell'interfaccia utente stessa.

3. (Facoltativo) Aggiungi filtri per limitare le serie temporali da visualizzare. La sezione successiva descrive le opzioni di filtro.

4. (Facoltativo) Configura il modo in cui le serie temporali vengono raggruppate e allineate. Per ulteriori informazioni, consulta Scegliere come visualizzare i dati dei grafici.

Filtrare i dati del grafico

Puoi ridurre la quantità di dati da rappresentare nel grafico specificando i criteri di filtro, applicando l'aggregazione oppure ordinando le serie temporali che corrispondono a una query e limitando il numero di serie temporali rappresentate nel grafico. Per ulteriori informazioni, consulta la sezione Mostrare i valori anomali.

I filtri assicurano che vengano utilizzate solo le serie temporali che soddisfano una serie di criteri. Quando applichi i filtri, potresti ridurre il numero di linee sul grafico, per migliorarne le prestazioni.

Il resto di questa sezione riguarda la configurazione di un grafico quando si utilizza un'interfaccia basata su menu. Questa sezione non è applicabile alle configurazioni dei filtri MQL, PromQL o Monitoring.

Quando fornisci più criteri di filtro, il grafico corrispondente mostra solo le serie temporali che soddisfano tutti i criteri, ovvero un AND logico. In genere, puoi filtrare per gruppo di risorse, per nome, per etichetta delle risorse, per zona e per etichetta della metrica.

Legacy

Per aggiungere un filtro quando utilizzi l'interfaccia basata su menu, fai clic su Aggiungi filtro e specifica l'etichetta del filtro, il confronto e il valore o l'intervallo di valori:

1. Fai clic su Etichetta e seleziona una voce dal menu.

   Per trovare un'etichetta specifica, puoi utilizzare la barra di scorrimento o inserire il testo nell'area di testo Filtro . Quando inserisci il testo, il menu elenca solo le voci che contengono il testo inserito.

   Il seguente screenshot mostra le etichette di filtro per una metrica specifica:

   

2. Fai clic su Confronto e seleziona una voce dal menu. Puoi scegliere tra quattro operatori: uguale a, =, non uguale, !=, corrispondenza espressione regolare, =~ e espressione regolare non corrisponde, !=~:

   

3. Fai clic su Valore, quindi esegui una delle seguenti operazioni:

   • Per un confronto diretto, = o !=, seleziona il valore dal menu o inserisci un valore e fai clic su Fine. I valori inseriti possono essere valori semplici come us-central1-a; in alternativa, puoi creare una stringa di filtro che inizia con starts_with o ends_with. Ad esempio, per visualizzare i dati relativi a qualsiasi zona us-central1 puoi inserire la stringa di filtro starts_with("us-central1"). Consulta Filtri di monitoraggio per ulteriori informazioni sulle stringhe di filtro.

     Poiché le voci di menu derivano dalle serie temporali ricevute, quando una risorsa monitorata non genera dati per la metrica selezionata, devi inserire un valore per l'etichetta.

     Lo screenshot seguente mostra il menu del valore visualizzato per un determinato progetto quando è selezionata l'etichetta della risorsa zone:

     

   • Per un confronto di espressioni regolari, =~ o !=~, inserisci un'espressione regolare RE2 nel campo Valore e fai clic su Fine. Ad esempio, l'espressione regolare us-central1-.* corrisponde a tutte le us-central1 zone.

     Per trovare la corrispondenza con qualsiasi zona degli Stati Uniti che termina con "a", puoi utilizzare l'espressione regolare ^us.*.a$.

     Non puoi utilizzare le espressioni regolari per filtrare l'etichetta delle risorse project_id.

     Ad esempio, per visualizzare solo le serie temporali di una delle zone us-central1, applica un filtro zone="starts_with("us-central1")" o zone=~"us-central1.*":

     

Nota: per modificare o eliminare un filtro, fai clic su Modifica filtro nel riquadro dei filtri.

Puoi specificare più criteri di filtro e utilizzare la stessa etichetta più volte. Queste funzionalità consentono di specificare un filtro per un intervallo di valori. Devono essere soddisfatti tutti i criteri di filtro; costituiscono un elemento AND logico. Ad esempio, la seguente configurazione ti consente di utilizzare le stringhe di filtro starts_with e ends_with per mostrare solo le zone "a" negli Stati Uniti:

Anteprima

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Per aggiungere un filtro:

1. Nell'elemento Filtro, fai clic su Aggiungi filtro ed effettua una selezione dal menu.

2. Per modificare il confronto, seleziona un valore dal menu Comparatore.

   Puoi scegliere tra quattro operatori: uguale a, =, non uguale, !=, corrispondenza espressione regolare, =~ e espressione regolare non corrisponde, !=~.

3. Nel campo Valore, inserisci o seleziona un valore:

   • Per un confronto diretto, = o !=, seleziona il valore dal menu o inserisci un valore e fai clic su OK. Puoi inserire valori come us-central1-a oppure creare una stringa di filtro che inizi con starts_with o ends_with. Ad esempio, per visualizzare i dati relativi a qualsiasi zona us-central1 puoi inserire la stringa di filtro starts_with("us-central1"). Consulta Filtri di monitoraggio per ulteriori informazioni sulle stringhe di filtro.

     Poiché le voci di menu derivano dalle serie temporali ricevute, quando una risorsa monitorata non genera dati per la metrica selezionata, devi inserire un valore per l'etichetta.

   • Per un confronto di espressioni regolari, =~ o !=~, inserisci un'espressione regolare RE2 nel campo Valore e fai clic su OK. Ad esempio, l'espressione regolare us-central1-.* corrisponde a tutte le us-central1 zone.

     Per trovare la corrispondenza con qualsiasi zona degli Stati Uniti che termina con "a", puoi utilizzare l'espressione regolare ^us.*.a$.

     Non puoi utilizzare le espressioni regolari per filtrare l'etichetta delle risorse project_id.

     Ad esempio, per visualizzare solo le serie temporali di una delle zone us-central1, applica un filtro zone="starts_with("us-central1")" o zone=~"us-central1.*".

Per aggiungere più filtri, ripeti la procedura precedente:

• Puoi utilizzare la stessa etichetta più volte, in modo da specificare un filtro per un intervallo di valori.

• Devono essere soddisfatti tutti i criteri di filtro; costituiscono un elemento AND logico. Ad esempio, per mostrare solo le zone "a" negli Stati Uniti, inserisci due filtri: zone = starts_with("us") e zone = end_with("a").

Per modificare il valore o il comparatore di un filtro, fai clic su Menu nell'elemento filtro, apporta le modifiche e fai clic su OK.

Per eliminare un filtro, fai clic su Annulla.

Scrittura di query MQL

Legacy

Per inserire una query MQL o PromQL, segui questi passaggi:

1. Nella console Google Cloud, seleziona Monitoring, quindi  Metrics Explorer oppure fai clic sul pulsante seguente:

   Vai a Metrics Explorer

2. Nella barra degli strumenti del riquadro Seleziona una metrica, seleziona il pulsante il cui nome inizia con Codice.
3. Seleziona MQL nel pulsante di attivazione/disattivazione Lingua. L'opzione di attivazione/disattivazione della lingua si trova nella stessa barra degli strumenti che consente di formattare la query.
4. (Facoltativo) Disattiva l'opzione di attivazione/disattivazione Esecuzione automatica.

5. Inserisci la query nell'Editor query. Ad esempio, per rappresentare graficamente l'utilizzo della CPU delle istanze VM nel tuo progetto Google Cloud, utilizza la query seguente:

   fetch gce_instance
   | metric 'compute.googleapis.com/instance/cpu/utilization'
   | group_by 1m, [value_utilization_mean: mean(value.utilization)]
   | every 1m
   

   Per saperne di più su MQL, consulta i seguenti documenti:

   • Introduzione a MQL
   • Utilizzare l'editor di codice per MQL

6. Fai clic su Esegui query.

   Quando l'opzione Esecuzione automatica è abilitata, il pulsante Esegui query non viene visualizzato.

Anteprima

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Per inserire una query MQL o PromQL, segui questi passaggi:

1. Nella console Google Cloud, seleziona Monitoring, quindi  Metrics Explorer oppure fai clic sul pulsante seguente:

   Vai a Metrics Explorer

2. Nella barra degli strumenti del riquadro Seleziona una metrica, seleziona il pulsante il cui nome è  MQL o  PromQL.
3. Seleziona MQL nel pulsante di attivazione/disattivazione Lingua. L'opzione di attivazione/disattivazione della lingua si trova nella stessa barra degli strumenti che consente di formattare la query.
4. (Facoltativo) Disattiva l'opzione di attivazione/disattivazione Esecuzione automatica.

5. Inserisci la query nell'Editor query. Ad esempio, per rappresentare graficamente l'utilizzo della CPU delle istanze VM nel tuo progetto Google Cloud, utilizza la query seguente:

   fetch gce_instance
   | metric 'compute.googleapis.com/instance/cpu/utilization'
   | group_by 1m, [value_utilization_mean: mean(value.utilization)]
   | every 1m
   

   Per saperne di più su MQL, consulta i seguenti documenti:

   • Introduzione a MQL
   • Utilizzare l'editor di codice per MQL

6. Fai clic su Esegui query.

   Quando l'opzione Esecuzione automatica è abilitata, il pulsante Esegui query non viene visualizzato.

Scrivi query PromQL

Legacy

Per inserire una query MQL o PromQL, segui questi passaggi:

1. Nella console Google Cloud, seleziona Monitoring, quindi  Metrics Explorer oppure fai clic sul pulsante seguente:

   Vai a Metrics Explorer

2. Nella barra degli strumenti del riquadro Seleziona una metrica, seleziona il pulsante il cui nome inizia con Codice.
3. Seleziona PromQL nel pulsante di attivazione/disattivazione Lingua. L'opzione di attivazione/disattivazione della lingua si trova nella stessa barra degli strumenti che consente di formattare la query.
4. (Facoltativo) Disattiva l'opzione di attivazione/disattivazione Esecuzione automatica.

5. Inserisci la query nell'Editor query. Ad esempio, per rappresentare su grafico l'utilizzo medio della CPU delle istanze VM nel tuo progetto Google Cloud, utilizza la query seguente:

   avg(compute_googleapis_com:instance_cpu_utilization)
   

   Per ulteriori informazioni sull'utilizzo di PromQL, consulta PromQL in Cloud Monitoring.

6. Fai clic su Esegui query.

   Quando l'opzione Esecuzione automatica è abilitata, il pulsante Esegui query non viene visualizzato.

Anteprima

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Per inserire una query MQL o PromQL, segui questi passaggi:

1. Nella console Google Cloud, seleziona Monitoring, quindi  Metrics Explorer oppure fai clic sul pulsante seguente:

   Vai a Metrics Explorer

2. Nella barra degli strumenti del riquadro Seleziona una metrica, seleziona il pulsante il cui nome è  MQL o  PromQL.
3. Seleziona PromQL nel pulsante di attivazione/disattivazione Lingua. L'opzione di attivazione/disattivazione della lingua si trova nella stessa barra degli strumenti che consente di formattare la query.
4. (Facoltativo) Disattiva l'opzione di attivazione/disattivazione Esecuzione automatica.

5. Inserisci la query nell'Editor query. Ad esempio, per rappresentare su grafico l'utilizzo medio della CPU delle istanze VM nel tuo progetto Google Cloud, utilizza la query seguente:

   avg(compute_googleapis_com:instance_cpu_utilization)
   

   Per ulteriori informazioni sull'utilizzo di PromQL, consulta PromQL in Cloud Monitoring.

6. Fai clic su Esegui query.

   Quando l'opzione Esecuzione automatica è abilitata, il pulsante Esegui query non viene visualizzato.

Scrivi query di filtro di Monitoring

Se vuoi eseguire una delle seguenti operazioni, devi utilizzare la modalità di filtro diretto, che ti consente di inserire un filtro Monitoring:

• Visualizza un obiettivo del livello di servizio (SLO).
• Visualizza il numero di processi in esecuzione sulle macchine virtuali (VM).
• Visualizza una metrica personalizzata per la quale non disponi ancora di dati.
• Filtra una serie temporale in base a un'etichetta per la quale non sono ancora disponibili dati.

Un filtro Monitoring, o equivalentemente un filtro metrica, è un'espressione che Monitoring utilizza per identificare le serie temporali da rappresentare su grafico. Ad esempio, la seguente espressione restituisce un grafico che mostra un conteggio dei processi il cui nome include nginx:

 select_process_count("monitoring.regex.full_match(\".*nginx.*\")")
 resource.type="gce_instance"

Puoi anche utilizzare i filtri di Monitoring per identificare le serie temporali in base al tipo di risorsa e metrica. L'espressione seguente genera un grafico che mostra il conteggio delle voci di log per tutte le istanze di macchina virtuale Google Cloud nella zona us-east1-b:

metric.type="logging.googleapis.com/log_entry_count"
resource.type="gce_instance"
resource.label."zone"="us-east1-b"

Legacy

Per inserire un filtro di Monitoring:

1. Nella console Google Cloud, seleziona Monitoring, quindi  Metrics Explorer oppure fai clic sul pulsante seguente:

   Vai a Metrics Explorer

2. Fai clic su Guida nel menu Seleziona una metrica, quindi seleziona Modalità filtro diretto.

   Nella pagina viene visualizzato un campo. Se hai selezionato un tipo di risorsa, una metrica o dei filtri prima di passare alla modalità di filtro diretto, queste impostazioni vengono mostrate nel campo.

3. Inserisci un'espressione di filtro di Monitoring nel campo. Per informazioni sulla sintassi, consulta i seguenti documenti:

   • Filtri di monitoraggio
   • Filtri di integrità di processo
   • Recupero dei dati dello SLO

   Quando utilizzi la modalità di filtro diretto e non sono disponibili dati che soddisfino il filtro, viene visualizzato un errore. I messaggi di errore comuni includono Chart definition invalid e No data is available for the selected timeframe.

4. (Facoltativo) Configura il modo in cui le serie temporali vengono raggruppate e allineate. Per ulteriori informazioni, consulta Scegliere come visualizzare i dati dei grafici.

Per tornare all'interfaccia basata su menu, fai clic su Modalità standard.

Nota: se inserisci un filtro di Monitoring e poi passi a un'altra interfaccia, il filtro di Monitoring viene eliminato.

Anteprima

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Per inserire un filtro di Monitoring:

1. Nella console Google Cloud, seleziona Monitoring, quindi  Metrics Explorer oppure fai clic sul pulsante seguente:

   Vai a Metrics Explorer

2. Fai clic su Guida per l'elemento Metrica, quindi seleziona Modalità filtro diretto.

   Gli elementi Metrica e Filtro vengono eliminati e viene creato un elemento Filtri che consente di inserire testo.

   Se hai selezionato un tipo di risorsa, una metrica o filtri prima di passare alla modalità Modalità filtro diretto, tali impostazioni vengono visualizzate nell'elemento Filtri.

3. Nell'area di testo dell'elemento Filtri, inserisci un'espressione di filtro di Monitoring. Per informazioni sulla sintassi, consulta i seguenti documenti:

   • Filtri di monitoraggio
   • Filtri di integrità di processo
   • Recupero dei dati dello SLO

   Quando utilizzi la modalità di filtro diretto e non sono disponibili dati che soddisfino il filtro, viene visualizzato un errore. I messaggi di errore comuni includono Chart definition invalid e No data is available for the selected timeframe.

4. (Facoltativo) Configura il modo in cui le serie temporali vengono raggruppate e allineate. Per ulteriori informazioni, consulta Scegliere come visualizzare i dati dei grafici.

Per tornare all'interfaccia basata sui menu, fai clic su Esci dalla modalità di filtro diretto.

Nota: se inserisci un filtro di Monitoring e poi passi a un'altra interfaccia, il filtro di Monitoring viene eliminato.

Scegli come visualizzare i dati del grafico

La sezione illustra come visualizzare i dati selezionati impostando i campi di aggregazione. L'aggregazione consiste nell'allineamento di punti dati all'interno di una serie temporale e nella combinazione di diverse serie temporali. Per una spiegazione dettagliata dell'aggregazione, consulta Applicazione di filtri e aggregazione: manipolare le serie temporali.

• Per informazioni sulle opzioni di visualizzazione, consulta Impostare le opzioni di visualizzazione del grafico.
• Per ulteriori informazioni sull'interazione con il grafico, consulta Esplorare i dati dei grafici.

I contenuti di questa sezione non si applicano se hai selezionato i dati per il grafico utilizzando un MQL o PromQL.

Combina serie temporali

Puoi ridurre la quantità di dati restituiti per una metrica combinando diverse serie temporali. Per combinare più serie temporali, in genere è necessario specificare una o più etichette e una funzione. Le serie temporali che hanno lo stesso valore per tutte le etichette specificate vengono raggruppate e la funzione specificata combina queste serie temporali in una nuova serie temporale.

Legacy

Per impostazione predefinita, viene aggiunto un raggruppamento dopo aver selezionato il tipo di risorsa e il tipo di metrica. Questo raggruppamento è configurato per calcolare la media di tutte le serie temporali e, di conseguenza, il grafico mostra una singola riga:

• Per raggruppare in base a etichette specifiche, nella sezione Raggruppa per, fai clic su Etichette ed effettua le tue selezioni. Puoi raggruppare in base a più etichette.

  Quando il campo Etichette è vuoto, vengono combinate tutte le serie temporali e il grafico mostra una sola riga.

• Per visualizzare tutte le serie temporali, nella voce Raggruppa per, fai clic su Elimina raggruppamento.

Ad esempio, se imposti il campo Etichette su user_labels.version e il campo Funzione di raggruppamento su sum, verrà creata una serie temporale per ogni valore dell'etichetta user_labels.version. I punti dati in ogni serie temporale vengono calcolati dalla somma di tutti i valori delle singole serie temporali di una versione specifica:

Quando raggruppi le serie temporali utilizzando più etichette, la funzione di raggruppamento viene applicata all'insieme di serie temporali che hanno gli stessi valori per le etichette selezionate. Il grafico risultante mostra una serie temporale per ogni combinazione di valori delle etichette. L'ordine in cui specifichi le etichette non è importante.

Ad esempio, il seguente screenshot illustra il raggruppamento per user_labels.version e system_labels.machine_image:

Come illustrato, se raggruppi i dati per entrambe le etichette, ottieni una serie temporale per ogni coppia di valori. Il fatto che sia disponibile una serie temporale per ogni combinazione di etichette significa che questa tecnica può facilmente creare più dati di quanti non si possano inserire in un singolo grafico.

Quando specifichi il raggruppamento o se selezioni una funzione di raggruppamento, la serie temporale indicata nei grafici contiene solo le etichette obbligatorie, ad esempio l'identificatore del progetto e le etichette specificate dal raggruppamento.

Anteprima

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Le impostazioni dell'elemento Aggregazione possono modificare il numero di serie temporali visualizzate nel grafico. Le impostazioni predefinite per questo elemento sono determinate dal tipo di metrica selezionato. Per modificare la visualizzazione, procedi in uno dei seguenti modi:

• Per visualizzare tutte le serie temporali, nell'elemento Aggregazione assicurati che il primo menu sia impostato su Non aggregato e il secondo su Nessuno.

• Per combinare le serie temporali, nell'elemento Aggregation procedi nel seguente modo:

  1. Espandi il primo menu e seleziona una funzione.

     Il grafico viene aggiornato e mostra una singola serie temporale. Ad esempio, se selezioni Media, le serie temporali visualizzate corrispondono alla media di tutte le serie temporali.

  2. Per combinare le serie temporali con gli stessi valori di etichetta, espandi il secondo menu e seleziona una o più etichette.

     Il grafico viene aggiornato e mostra una serie temporale per ogni combinazione univoca di valori delle etichette. Ad esempio, per visualizzare le serie temporali per zona, imposta il secondo menu su zone.

• Per configurare la spaziatura tra i punti dati, fai clic su Aggiungi elemento di query, seleziona Intervallo min e inserisci un valore.

Ad esempio, se imposti la funzione su Somma e selezioni l'etichetta user_labels.version, sarà presente una serie temporale per ogni valore dell'etichetta user_labels.version. I punti dati di ogni serie temporale vengono calcolati dalla somma di tutti i valori delle singole serie temporali di una versione specifica:

Quando selezioni più etichette, vengono combinate le serie temporali che hanno gli stessi valori per le etichette selezionate. Il grafico risultante mostra una serie temporale per ogni combinazione di valori delle etichette. L'ordine in cui specifichi le etichette non è importante. Il seguente screenshot mostra un grafico in cui le serie temporali sono combinate dalle etichette user_labels.version e system_labels.machine_image:

Come mostrato, il grafico mostra una serie temporale per ogni coppia di valori delle etichette. Il fatto che sia disponibile una serie temporale per ogni combinazione di etichette significa che questa tecnica può creare più dati di quanti non si possano inserire in un singolo grafico.

Mostra tutte le serie temporali

Legacy

Per visualizzare tutte le serie temporali, fai clic su Elimina raggruppamento.

Anteprima

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Per visualizzare tutte le serie temporali, nell'elemento Aggregazione imposta il primo menu su Non aggregato e il secondo su Nessuno.

Allinea serie temporali

L'allineamento è il processo di conversione dei dati delle serie temporali ricevuti da Monitoring in una nuova serie temporale con punti dati a intervalli fissi. Il processo di allineamento consiste nel raccogliere tutti i punti dati ricevuti in una durata di tempo fissa, applicare una funzione per combinare quei punti dati e assegnare un timestamp al risultato. Questa funzione potrebbe calcolare la media di tutti i campioni oppure estrarre il massimo di tutti i campioni.

Legacy

Per accedere ai campi di allineamento, fai clic su Altre opzioni nel riquadro delle query, quindi vai alla sezione Allineamento dei punti dati:

• Il campo Periodo di allineamento minimo specifica l'intervallo di tempo minimo da utilizzare per l'allineamento dei dati delle serie temporali. Quando sono presenti troppi punti dati da tracciare nel periodo di visualizzazione selezionato, il periodo di allineamento viene aumentato automaticamente in modo che venga rappresentato ogni punto dati. L'impostazione predefinita per questo campo è un minuto.

• Il campo Funzione di allineamento specifica la funzione utilizzata per combinare tutti i punti dati in un periodo di allineamento. La maggior parte degli allineatori svolge funzioni matematiche comuni. Ad esempio, se selezioni min, il punto dati allineato corrisponde al minimo di tutti i punti dati nel periodo di allineamento.

Ad esempio, considera una metrica con un periodo di campionamento di un minuto. Se un grafico è configurato per mostrare un'ora di dati, può visualizzare tutti i 60 punti dati. Se il periodo di allineamento è impostato su 10 minutes, il grafico mostra sei punti dati. Quando il campo Funzione di allineamento ha il valore mean, ogni punto sul grafico corrisponde alla media di tutti i punti in un periodo di allineamento. Tuttavia, se ora configuri il grafico in modo che mostri i dati di una settimana, ci sono troppi punti da visualizzare nel grafico in modo che il periodo venga modificato automaticamente. In questo esempio, il periodo di allineamento modificato è di un'ora.

Sebbene la maggior parte degli allineatori svolga funzioni matematiche comuni, alcuni compiono azioni più complicate:

• successivo: per conservare solo il campione più recente all'interno di un periodo di allineamento, utilizza l'allineatore successivo prima. Questo allineatore viene utilizzato comunemente con i controlli di uptime ed è un'ottima scelta quando ti interessa solo il valore più recente.

  Questo allineatore è valido solo per le metriche dei contatore.

• percentile: per visualizzare una metrica di distribuzione in un grafico a linee, in un grafico ad area in pila o in un grafico a barre in pila, devi selezionare il percentile della distribuzione da visualizzare. Un modo per specificare questo percentile è selezionare un allineatore del percentile. Puoi selezionare il 5°, 50°, 95° e 99° percentile. Il punto dati allineato viene determinato calcolando il percentile specificato utilizzando tutti i punti dati nel periodo di allineamento.

  Questo allineatore è valido solo per le metriche contatore e delta quando hanno un tipo di dati di distribuzione.

• delta: per convertire una metrica cumulativa o una metrica delta in una metrica delta con un campione per periodo di allineamento, utilizza questo allineatore. Questo allineatore potrebbe comportare un'interpolazione dei dati. Per un esempio, consulta la sezione Tipi, tipi e conversioni.

  Questo allineatore è valido solo per le metriche cumulative e delta.

• rate: per convertire una metrica cumulativa o delta in una metrica contatore, utilizza questo allineatore. Se scegli questo allineatore, puoi pensare alle serie temporali trasformate così com'erano con l'allineatore delta e poi divise per il periodo di allineamento. Ad esempio, se l'unità della serie temporale originale è MiB e l'unità del periodo di allineamento è la seconda, il grafico ha un'unità di MiB al secondo. Per ulteriori informazioni, consulta la sezione Tipi, tipi e conversioni.

  Questo allineatore è valido solo per le metriche cumulative e delta.

Per saperne di più sugli allineatori disponibili, consulta Aligner nel riferimento API.

Lo screenshot seguente illustra l'utilizzo della CPU da parte delle istanze VM di Compute Engine in un particolare progetto Google Cloud. In questa immagine, i campi di allineamento sono impostati sui valori predefiniti: la funzione di allineamento è impostata su mean e il periodo di allineamento è impostato su 1 minute:

Per fare un confronto, il seguente screenshot illustra l'effetto della modifica del periodo da 1 minute a 5 minutes:

Aumentando il periodo, il grafico risultante avrà meno punti, che diminuiscono da 60 punti per serie temporale a 10 punti per serie temporale. Ogni punto sul grafico viene calcolato facendo la media dei punti delle serie temporali in un periodo di allineamento. Aumentando il periodo di allineamento, viene calcolata la media di più punti insieme, il che ha un effetto di livellamento sui dati tracciati.

Anteprima

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Imposta intervallo di allineamento

Per specificare un periodo di tempo fisso per la combinazione dei punti, fai clic su Aggiungi elemento di query nel riquadro delle query, seleziona Intervallo min e completa la finestra di dialogo.

Ad esempio, considera una metrica con un periodo di campionamento di un minuto. Se un grafico è configurato per mostrare un'ora di dati, può visualizzare tutti i 60 punti dati. Se il campo Intervallo min è impostato su 10 minutes, il grafico mostra 6 punti dati. Tuttavia, se ora configuri il grafico in modo che mostri i dati di una settimana, ci sono troppi punti da visualizzare nel grafico e l'intervallo durante il quale vengono combinati i punti viene modificato automaticamente. In questo esempio, l'intervallo modificato è di un'ora.

Lo screenshot seguente illustra l'utilizzo della CPU da parte delle istanze VM di Compute Engine in un particolare progetto Google Cloud. In questa immagine, il campo Intervallo min è impostato su 1 minute:

Per fare un confronto, il seguente screenshot illustra l'effetto della modifica dell'intervallo da 1 minute a 5 minutes:

Aumentando il periodo, il grafico risultante avrà meno punti, che diminuiscono da 60 punti per serie temporale a 10 punti per serie temporale. Aumentando il campo Intervallo min, vengono combinati più punti, con un effetto di livellamento sui dati tracciati.

Imposta funzione di allineamento

Quando selezioni la funzione da aggregare, Cloud Monitoring seleziona automaticamente la funzione di allineamento. Cloud Monitoring determina la funzione di allineamento ottimale in base al tipo di metrica selezionato e alla scelta per la funzione di aggregazione. Tuttavia, puoi specificare una funzione di allineamento e sostituire la scelta effettuata da Cloud Monitoring.

Per specificare la funzione di allineamento:

1. Nell'elemento Aggregation, espandi il primo menu e seleziona Configura allineatore. Vengono aggiunti gli elementi Funzione di allineamento e Raggruppamento.
2. Espandi l'elemento Funzione di allineamento ed effettua una selezione.

Sebbene la maggior parte delle funzioni di allineamento supportate svolga funzioni matematiche comuni, alcune compiono azioni più complicate:

• successivo prima: per conservare solo il campione più recente all'interno di un periodo di allineamento, seleziona prossimo precedente. Questa funzione viene comunemente utilizzata con i controlli di uptime ed è un'ottima scelta quando ti interessa solo il valore più recente.

  Questa funzione è valida solo per le metriche contatore.

• percentile: per visualizzare una metrica di distribuzione in un grafico a linee, in un grafico ad area in pila o in un grafico a barre in pila, devi selezionare il percentile della distribuzione da visualizzare. Un modo per specificare questo percentile è selezionare una funzione percentile. Puoi selezionare il 5°, 50°, 95° e 99° percentile. Il punto dati allineato viene determinato calcolando il percentile specificato utilizzando tutti i punti dati nel periodo di allineamento.

  Questa funzione è valida solo per le metriche contatore e delta quando hanno un tipo di dati di distribuzione.

• delta: per convertire una metrica cumulativa o una metrica delta in una metrica delta con un campione per periodo di allineamento, utilizza questa funzione. Quando utilizzi questa funzione potrebbe verificarsi un'interpolazione dei dati. Per un esempio, consulta la sezione Tipi, tipi e conversioni.

  Questa funzione è valida solo per le metriche cumulative e delta.

• rate: per convertire una metrica cumulativa o delta in una metrica contatore, utilizza questa funzione. Se scegli questa funzione, puoi pensare alle serie temporali trasformate com'erano con una funzione delta e poi divise per il periodo di allineamento. Ad esempio, se l'unità della serie temporale originale è MiB e l'unità del periodo di allineamento è la seconda, il grafico ha un'unità di MiB al secondo. Per ulteriori informazioni, consulta la sezione Tipi, tipi e conversioni.

  Questa funzione è valida solo per le metriche cumulative e delta.

Per ulteriori informazioni sulle funzioni di allineamento disponibili, consulta Aligner nel riferimento API.

Raggruppamento secondario e allineamento

Legacy

Quando disponi di più serie temporali che rappresentano già aggregazioni, puoi ridurre tutte le serie temporali sul grafico a una singola serie temporale scegliendo un aggregatore secondario. Ad esempio, se raggruppi i dati per zona, il grafico mostra una serie temporale per ogni zona. Per creare un grafico con una singola serie temporale, utilizza i campi di aggregazione secondari.

Quando imposti il campo Trasforma su un valore diverso da Nessuno, tutti gli altri campi diventano impostazioni di aggregazione secondarie.

Anteprima

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Quando disponi di più serie temporali che rappresentano già aggregazioni, puoi ridurre tutte le serie temporali sul grafico a una singola serie temporale scegliendo un aggregatore secondario. Ad esempio, se raggruppi i dati per zona, il grafico mostra una serie temporale per ogni zona. Per creare un grafico con una singola serie temporale, utilizza i campi di aggregazione secondari.

Per alcuni tipi di metriche, hai la possibilità di trasformare i dati. Se questa opzione è disponibile e se imposti il campo Trasforma su un valore diverso da Nessuno, tutti gli altri campi diventano impostazioni di aggregazione secondarie.

Quando i campi di aggregazione secondari sono configurabili, puoi accedervi nel seguente modo:

1. Fai clic su Aggiungi elemento di query, poi seleziona Aggregazione secondaria.
2. Configura l'elemento Aggregazione secondaria.

Il seguente screenshot mostra diverse serie temporali risultanti dal raggruppamento di un insieme filtrato di dati. L'uso del raggruppamento richiede l'aggregazione; ogni gruppo di righe viene aggregato in una sola. Il seguente screenshot mostra le serie temporali raggruppate per zona:

Lo screenshot seguente mostra il risultato dell'utilizzo dell'aggregazione secondaria per trovare il valore medio nelle serie temporali raggruppate:

Configura il nome di una colonna della legenda

Il campo Alias legenda consente di personalizzare una descrizione per la serie temporale sul grafico. Queste descrizioni vengono visualizzate sulla descrizione comando del grafico e nella legenda del grafico nella colonna Nome. Per impostazione predefinita, le descrizioni nella legenda vengono create automaticamente in base ai valori delle diverse etichette nella serie temporale. Poiché il sistema seleziona le etichette, i risultati potrebbero non essere utili. Per creare un modello per le descrizioni, utilizza questo campo.

Puoi inserire testo normale e modelli nel campo Alias legenda. Quando aggiungi un modello, aggiungi un'espressione che viene valutata quando viene visualizzata la legenda.

Per aggiungere un modello di legenda a un grafico:

1. Nel riquadro Visualizza, espandi Alias legenda.
2. Fai clic su Mostra suggerimenti sulle variabili del modello e seleziona una voce dal menu. Ad esempio, se selezioni zone, viene aggiunto il modello ${resource.labels.zone}.

Ad esempio, il seguente screenshot mostra un modello di legenda contenente testo normale e l'espressione ${resource.labels.zone}:

Nella legenda del grafico, i valori generati dal modello vengono visualizzati in una colonna con l'intestazione Nome e nella descrizione comando:

Puoi configurare il modello di legenda in modo che includa più stringhe di testo e modelli; tuttavia, lo spazio di visualizzazione disponibile nella descrizione comando è limitato.

Passaggi successivi

• Esplorare i dati dei grafici
• Panoramica delle metriche definite dall'utente
• Configurare il modello di legenda
• Impostare le opzioni di visualizzazione del grafico