Aggiungere grafici e tabelle a una dashboard personalizzata

Questo documento descrive come aggiungere grafici, tabelle, indicatori e prospetti a una dashboard personalizzata utilizzando la console Google Cloud. Per visualizzare i dati delle metriche in un intervallo di tempo, puoi aggiungere un grafico a linee, un grafico ad area in pila, un grafico a barre o un grafico a mappa termica. Se ti interessano solo le misurazioni più recenti, aggiungi una tabella, un grafico a torta, un contatore o un prospetto. Gli indicatori e i prospetti cambiano colore in base al confronto tra il valore più recente e le soglie di avviso e pericolo.

Le visualizzazioni che puoi aggiungere alle dashboard sono chiamate collettivamente widget. Per informazioni generali sui diversi tipi di widget, consulta la panoramica delle dashboard.

Grafici, tabelle, indicatori e prospetti nelle dashboard personalizzate possono visualizzare qualsiasi tipo di metrica che abbia un valore numerico o di distribuzione, incluse metriche definite dall'utente e metriche basate su log. I grafici non possono rappresentare su grafico dati di tipo stringa.

Questo documento descrive come aggiungere grafici, tabelle, indicatori e prospetti a una dashboard personalizzata. Consulta i seguenti documenti per informazioni sull'aggiunta di altri tipi di widget alle tue dashboard:

Per informazioni sull'API Cloud Monitoring, consulta Gestire le dashboard per API.

Prima di iniziare

  • Per ottenere le autorizzazioni necessarie per creare e modificare dashboard personalizzate utilizzando la console Google Cloud, chiedi all'amministratore di concederti il ruolo IAM Monitoring Editor (roles/monitoring.editor) sul tuo progetto. Per saperne di più sulla concessione dei ruoli, vedi Gestire l'accesso.

    Potresti anche essere in grado di ottenere le autorizzazioni richieste tramite ruoli personalizzati o altri ruoli predefiniti.

    Per ulteriori informazioni sui ruoli, consulta Controllare l'accesso con Identity and Access Management.

  • Puoi inserire fino a 40 widget su una dashboard.

  • Per aggiungere un widget a una dashboard, puoi selezionare la visualizzazione e poi configurare il widget oppure selezionare prima il tipo di dati e poi configurare la visualizzazione.

    Ad esempio, per aggiungere a una dashboard una tabella che mostra l'utilizzo della CPU delle istanze VM, puoi eseguire una delle seguenti operazioni:

    • Seleziona il widget Tabella, quindi configuralo per visualizzare l'utilizzo della CPU delle tue istanze VM.
    • Seleziona il tipo di dati Metrica, configura il widget per visualizzare l'utilizzo della CPU delle istanze VM, quindi modifica il tipo di widget in Tabella.

    Le istruzioni in questa pagina presuppongono che tu abbia selezionato prima il tipo di dati e poi ne configuri la visualizzazione.

Aggiungere grafici e tabelle a una dashboard

Questa sezione descrive come configurare grafici e tabelle utilizzando la console Google Cloud:

  • I grafici mostrano i dati nel tempo e sono disponibili quattro stili: A linee, Area in pila, Barra in pila e Mappa termica. Dopo aver configurato un grafico, puoi modificare il tipo di widget. Per informazioni sui motivi per cui è consigliabile selezionare uno stile specifico, consulta Grafici che mostrano i dati nel tempo.

    Per informazioni sull'utilizzo dell'API Cloud Monitoring per configurare un grafico, consulta la pagina Dashboard con widget XyChart.

  • Le tabelle contengono una riga per ogni serie temporale monitorata e mostrano solo il valore più recente. Esistono due stili di tabelle. Il widget Tabella mostra un valore numerico come "25%". Il widget Elenco principale mostra sia il valore sia un indicatore visivo del valore rispetto all'intervallo di valori possibili. Puoi passare da un tipo di widget all'altro. Per ulteriori informazioni e un esempio, consulta Visualizzare i dati in forma tabulare su una dashboard.

    Per informazioni sull'utilizzo dell'API Cloud Monitoring per configurare una tabella, consulta Dashboard con widget TimeSeriesTable.

Legacy

Per aggiungere un grafico o una tabella a una dashboard:

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

    Vai alle dashboard

  2. Esegui una di queste operazioni:

    • Per creare una nuova dashboard, seleziona Crea dashboard.
    • Per aggiornare una dashboard esistente, individuala nell'elenco di tutte le dashboard e seleziona il nome corrispondente.

  3. Nella barra degli strumenti, fai clic su  Aggiungi widget.

  4. Nella finestra di dialogo Aggiungi widget, seleziona Metrica .

  5. Specifica i dati da visualizzare nel grafico. Puoi utilizzare un'interfaccia basata su menu, Monitoring Query Language (MQL), PromQL oppure puoi inserire un filtro di Monitoring:

    1. Seleziona i dati delle serie temporali che vuoi visualizzare:

      1. Nel riquadro Seleziona una metrica, espandi il menu Metrica e utilizza i menu per selezionare un tipo di risorsa e di metrica. Ad esempio, potresti effettuare le seguenti scelte:

        1. Nel menu Risorse attive, seleziona Istanza VM.
        2. Nel menu Categorie di metriche attive, seleziona uptime_check.
        3. Nel menu Metriche attive, seleziona Latenza richiesta.
        4. Fai clic su Applica.

        Per limitare il numero di opzioni nei menu, inserisci il nome della metrica o della risorsa nella barra dei filtri. Ad esempio, per rappresentare graficamente la latenza delle richieste per un'istanza VM, puoi inserire "latency".

        Dopo aver effettuato le selezioni, il titolo del riquadro cambia. Ad esempio, se hai fornito i suggerimenti precedenti, il titolo del riquadro diventa Latenza richiesta.

      2. (Facoltativo) Per specificare un sottoinsieme di dati da visualizzare, seleziona Aggiungi filtro e completa la finestra di dialogo. Ad esempio, puoi visualizzare i dati per una zona applicando un filtro. Puoi aggiungere più filtri. Per ulteriori informazioni, consulta la sezione Filtrare i dati dei grafici.

      Per saperne di più, consulta Selezionare i dati da rappresentare su grafico.

    2. Raggruppa e allinea le serie temporali:

      • Per visualizzare tutte le serie temporali, nella voce Raggruppa per, fai clic su Elimina raggruppamento.
      • Per combinare le serie temporali con lo stesso valore di etichetta, espandi il menu Etichette e seleziona i valori delle etichette. Puoi anche modificare il valore della funzione di raggruppamento. Ad esempio, un grafico può visualizzare il valore medio delle serie temporali, in cui la media viene calcolata per zona.
      • (Facoltativo) Per configurare la spaziatura tra i punti dati, fai clic su Altre opzioni e poi utilizza i campi Allineamento dei punti dati.

      Per ulteriori informazioni sul raggruppamento e sull'allineamento, consulta Scegliere come visualizzare i dati dei grafici.

    3. (Facoltativo) Per visualizzare solo le serie temporali con i valori più alti o più bassi, fai clic su Aggiungi ordinamento e limite, quindi compila il modulo.

    MQL

    1. Nella barra degli strumenti del riquadro Seleziona una metrica, seleziona il pulsante il cui nome inizia con Codice.
    2. 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.

    3. 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:

    PromQL

    1. Nella barra degli strumenti del riquadro Seleziona una metrica, seleziona il pulsante il cui nome inizia con Codice.
    2. 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.

    3. 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.

    Filtro di monitoraggio

    1. Nella barra degli strumenti del riquadro Seleziona una metrica, fai clic su Guida nel menu Metrica, quindi seleziona Modalità filtro diretto.

      Viene visualizzato il campo Inserisci un filtro di monitoraggio. 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.

    2. Inserisci un filtro di Monitoring.

    3. Raggruppa e allinea le serie temporali:

      • Per visualizzare tutte le serie temporali, nella voce Raggruppa per, fai clic su Elimina raggruppamento.
      • Per combinare le serie temporali con lo stesso valore di etichetta, espandi il menu Etichette e seleziona i valori delle etichette. Puoi anche modificare il valore della funzione di raggruppamento. Ad esempio, un grafico può visualizzare il valore medio delle serie temporali, in cui la media viene calcolata per zona.
      • (Facoltativo) Per configurare la spaziatura tra i punti dati, fai clic su Altre opzioni e poi utilizza i campi Allineamento dei punti dati.

      Per ulteriori informazioni sul raggruppamento e sull'allineamento, consulta Scegliere come visualizzare i dati dei grafici.

  6. (Facoltativo) Configura il grafico in modo da visualizzare più tipi di metriche.

    1. Seleziona Aggiungi query.

      Il nuovo riquadro Seleziona una metrica nasconde le query configurate in precedenza.

    2. Nel riquadro Seleziona una metrica, utilizza i menu per selezionare un tipo di risorsa e un tipo di metrica. Puoi anche usare i menu per aggiungere filtri, raggruppare le serie temporali e impostare i campi di allineamento.

    Per visualizzare tutti i tipi di metriche configurati, vai alla barra degli strumenti del riquadro visualizzato e seleziona Comprimi.

    Lo screenshot seguente illustra la visualizzazione di Metrics Explorer quando nel grafico sono presenti due tipi di metriche:

    Esempio di Metrics Explorer con due tipi di metriche.

    MQL

    Non supportati.

    PromQL

    Non supportati.

    Filtro di monitoraggio

    Non supportati.

  7. (Facoltativo) Configura il grafico in modo da visualizzare un rapporto tra i tipi di metriche.

    1. Configura il grafico in modo da visualizzare due tipi di metriche.
    2. Assicurati che il valore del campo Periodo di allineamento minimo sia lo stesso per entrambi i tipi di metriche. Per visualizzare i parametri di allineamento, fai clic su Altre opzioni.

    3. Aggiorna i campi relativi al raggruppamento.

      Ti consigliamo che i campi di raggruppamento per il tipo di metrica del denominatore corrispondano ai valori impostati per il tipo di metrica del numeratore. Ad esempio, puoi raggruppare entrambi i tipi di metriche in base all'etichetta zone.

      Non è necessario utilizzare lo stesso raggruppamento per entrambi i tipi di metriche; tuttavia, puoi raggruppare solo in base alle etichette comuni a entrambi i tipi di metriche.

    4. Nella barra degli strumenti del riquadro delle query, seleziona Crea rapporto, quindi completa la finestra di dialogo.1.

      Dopo aver creato il rapporto, vengono visualizzate tre query:

      • Il rapporto A/B identifica la query sul rapporto.
      • A identifica la query per il numeratore.
      • B identifica la query per il denominatore.

      L'esempio seguente illustra un rapporto che confronta la somma dei byte scritti su disco per zona e il numero totale di byte scritti su disco:

      Esempio di un rapporto di metriche.

    5. (Facoltativo) Per cambiare le metriche relative al numeratore e al denominatore, procedi nel seguente modo:

      1. Fai clic su Espandi nella barra degli strumenti della query il cui nome inizia con A/B.
      2. Espandi il menu Numeratore e denominatore e seleziona un'opzione.

    MQL

    1. Nella barra degli strumenti del riquadro Seleziona una metrica, seleziona il pulsante il cui nome inizia con Codice.
    2. 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.

    3. Inserisci la query nell'Editor query. MQL consente di calcolare un rapporto tra due metriche diverse, nonché di filtrare una singola metrica in base a un'etichetta e di calcolare il rapporto. La query seguente calcola il rapporto tra le risposte con un valore 500 e il numero totale di risposte:

      fetch https_lb_rule::loadbalancing.googleapis.com/https/request_count
| {
    filter response_code_class = 500
  ;
    ident
  }
| group_by [matched_url_path_rule]
| outer_join 0
| div

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

    PromQL

    1. Nella barra degli strumenti del riquadro Seleziona una metrica, seleziona il pulsante il cui nome inizia con Codice.
    2. 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.

    3. Inserisci la query nell'Editor query. Ad esempio, per rappresentare su grafico il rapporto di latenza media della metrica my_summary_latency_seconds, utilizza la seguente query:

      sum without (instance)(rate(my_summary_latency_seconds_sum[5m])) /
sum without (instance)(rate(my_summary_latency_seconds_count[5m]))

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

    Filtro di monitoraggio

    Non supportati.

  8. (Facoltativo) Per modificare la visualizzazione, nel riquadro Display fai clic su Tipo di widget e poi effettua una selezione.

    Il menu Tipo di widget elenca tutti i tipi di widget che possono visualizzare lo stesso tipo di dati; tuttavia, alcuni widget potrebbero non essere attivi. Ad esempio, supponi di avere un grafico su una dashboard configurata in modo da visualizzare un tipo di metrica. Il grafico a linee mostra più serie temporali e che ogni valore misurato è un doppio:

    • I widget Tabella, Grafico a torta, Grafico a linee, Grafico a barre in pila e Grafico ad area in pila sono elencati come Compatibile. Puoi selezionare uno qualsiasi di questi tipi.

    • I widget Prospetto e Misuratore sono elencati come Compatibile con le regolazioni perché questi widget possono mostrare una sola serie temporale. Per attivare questi tipi di widget, modifica la configurazione del raggruppamento.

    • Il widget Mappa termica è disabilitato perché questi widget possono mostrare solo i dati con valori di distribuzione.

    • Il riquadro dei log non è elencato perché non può mostrare i dati delle serie temporali.

  9. (Facoltativo) Per modificare la modalità di visualizzazione dei dati selezionati nel grafico, utilizza le opzioni nel riquadro Visualizzazione:

  10. Per applicare le modifiche alla dashboard, fai clic su Applica nella barra degli strumenti. Per annullare le modifiche, fai clic su Annulla.

  11. Per salvare la dashboard modificata, fai clic su Salva nella barra degli strumenti.

Anteprima

Per aggiungere un grafico o una tabella a una dashboard:

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

    Vai alle dashboard

  2. Esegui una di queste operazioni:

    • Per creare una nuova dashboard, seleziona Crea dashboard.
    • Per aggiornare una dashboard esistente, individuala nell'elenco di tutte le dashboard e seleziona il nome corrispondente.

  3. Nella barra degli strumenti, fai clic su  Aggiungi widget.

  4. Nella finestra di dialogo Aggiungi widget, seleziona Metrica .

  5. Specifica i dati da visualizzare nel grafico. Puoi utilizzare un'interfaccia basata su menu, Monitoring Query Language (MQL), PromQL oppure puoi inserire un filtro di Monitoring:

    1. Seleziona i dati delle serie temporali che vuoi visualizzare:

      1. Nell'elemento Metrica, fai clic su Seleziona una metrica, poi utilizza i menu per selezionare un tipo di risorsa e di metrica. Ad esempio, potresti effettuare le seguenti scelte:

        1. Nel menu Risorse attive, seleziona Istanza VM.
        2. Nel menu Categorie di metriche attive, seleziona uptime_check.
        3. Nel menu Metriche attive, seleziona Latenza richiesta.
        4. Fai clic su Applica.

        Per limitare il numero di opzioni nei menu, inserisci il nome della metrica o della risorsa nella barra dei filtri. Ad esempio, per rappresentare graficamente la latenza delle richieste per un'istanza VM, puoi inserire "latency".

        Dopo aver effettuato le selezioni, il titolo del riquadro cambia. Ad esempio, se hai fornito i suggerimenti precedenti, il titolo del riquadro diventa Latenza richiesta.

      2. (Facoltativo) Per specificare un sottoinsieme di dati da visualizzare, nell'elemento Filtro seleziona Aggiungi filtro, quindi completa la finestra di dialogo. Ad esempio, puoi visualizzare i dati per una zona applicando un filtro. Puoi aggiungere più filtri. Per ulteriori informazioni, consulta la sezione Filtrare i dati dei grafici.

      Per saperne di più, consulta Selezionare i dati da rappresentare su grafico.

    2. Combinare e allineare le serie temporali:

      • Per visualizzare tutte le serie temporali, nell'elemento Aggregazione imposta il primo menu 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.

          Quando il secondo menu è impostato su Nessuno, il grafico mostra una serie temporale.

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

      Per ulteriori informazioni sul raggruppamento e sull'allineamento, consulta Scegliere come visualizzare i dati dei grafici.

    3. Facoltativo: per visualizzare solo le serie temporali con i valori più alti o più bassi, utilizza l'elemento Ordina e limita.

    MQL

    1. Nella barra degli strumenti del riquadro Seleziona una metrica, seleziona il pulsante il cui nome è  MQL o  PromQL.
    2. 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.

    3. 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:

    PromQL

    1. Nella barra degli strumenti del riquadro Seleziona una metrica, seleziona il pulsante il cui nome è  MQL o  PromQL.
    2. 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.

    3. 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.

    Filtro di monitoraggio

    1. Nell'elemento Metrica, fai clic su Guida, 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 mostrate nel campo dell'elemento Filtri.

    2. Inserisci un filtro di Monitoring nel campo dell'elemento Filtri.

    3. Combinare e allineare le serie temporali:

      • Per visualizzare tutte le serie temporali, nell'elemento Aggregazione imposta il primo menu 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.

          Quando il secondo menu è impostato su Nessuno, il grafico mostra una serie temporale.

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

      Per ulteriori informazioni sul raggruppamento e sull'allineamento, consulta Scegliere come visualizzare i dati dei grafici.

  6. (Facoltativo) Configura il grafico in modo da visualizzare più tipi di metriche.

    1. Seleziona Aggiungi query. Viene aggiunta una nuova query. Ad esempio, potrebbe essere aggiunta una query con l'etichetta B.

    2. Per la nuova query, nell'elemento Metric, seleziona un tipo di risorsa e un tipo di metrica. Puoi anche aggiungere filtri, combinare serie temporali, ordinare e limitare il numero di serie temporali visualizzate.

    Lo screenshot seguente illustra la visualizzazione di Metrics Explorer quando nel grafico sono presenti due tipi di metriche:

    Esempio di Metrics Explorer con due tipi di metriche.

    MQL

    Non supportati.

    PromQL

    Non supportati.

    Filtro di monitoraggio

    Non supportati.

  7. (Facoltativo) Configura il grafico in modo da visualizzare un rapporto tra i tipi di metriche.

    1. Configura il grafico in modo da visualizzare due tipi di metriche che hanno lo stesso tipo di metrica. Ad esempio, entrambe sono metriche GAUGE.
    2. Assicurati che il valore del campo Intervallo min sia lo stesso per entrambi i tipi di metriche. Per accedere a questo campo, fai clic su Aggiungi elemento di query e seleziona Intervallo min.

    3. Aggiorna i campi di aggregazione.

      Ti consigliamo che le etichette per il tipo di metrica del denominatore corrispondano ai valori impostati per il tipo di metrica del numeratore. Ad esempio, potresti selezionare l'etichetta zone per il numeratore e il denominatore.

      Non è necessario utilizzare lo stesso insieme di etichette per entrambi i tipi di metrica; tuttavia, puoi selezionare solo etichette comuni a entrambi i tipi di metrica.

    4. Nella barra degli strumenti del riquadro delle query, seleziona Crea rapporto, quindi completa la finestra di dialogo.

      Dopo aver creato il rapporto, vengono visualizzate tre query:

      • Il rapporto A/B identifica la query sul rapporto.
      • A identifica la query per il numeratore.
      • B identifica la query per il denominatore.

      L'esempio seguente illustra un rapporto che confronta la somma dei byte scritti su disco per zona e il numero totale di byte scritti su disco:

      Esempio di un rapporto di metriche.

    5. (Facoltativo) Per cambiare le metriche del numeratore e del denominatore, nell'elemento Rapporto espandi il menu e poi effettua una selezione.

    MQL

    1. Nella barra degli strumenti del riquadro Seleziona una metrica, seleziona il pulsante il cui nome è  MQL o  PromQL.
    2. 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.

    3. Inserisci la query nell'Editor query. MQL consente di calcolare un rapporto tra due metriche diverse, nonché di filtrare una singola metrica in base a un'etichetta e di calcolare il rapporto. La query seguente calcola il rapporto tra le risposte con un valore 500 e il numero totale di risposte:

      fetch https_lb_rule::loadbalancing.googleapis.com/https/request_count
| {
    filter response_code_class = 500
  ;
    ident
  }
| group_by [matched_url_path_rule]
| outer_join 0
| div

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

    PromQL

    1. Nella barra degli strumenti del riquadro Seleziona una metrica, seleziona il pulsante il cui nome è  MQL o  PromQL.
    2. 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.

    3. Inserisci la query nell'Editor query. Ad esempio, per rappresentare su grafico il rapporto di latenza media della metrica my_summary_latency_seconds, utilizza la seguente query:

      sum without (instance)(rate(my_summary_latency_seconds_sum[5m])) /
sum without (instance)(rate(my_summary_latency_seconds_count[5m]))

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

    Filtro di monitoraggio

    Non supportati.

  8. (Facoltativo) Per modificare la visualizzazione, nel riquadro Display fai clic su Tipo di widget e poi effettua una selezione.

    Il menu Tipo di widget elenca tutti i tipi di widget che possono visualizzare lo stesso tipo di dati; tuttavia, alcuni widget potrebbero non essere attivi. Ad esempio, supponi di avere un grafico su una dashboard configurata in modo da visualizzare un tipo di metrica. Il grafico a linee mostra più serie temporali e che ogni valore misurato è un doppio:

    • I widget Tabella, Grafico a torta, Grafico a linee, Grafico a barre in pila e Grafico ad area in pila sono elencati come Compatibile. Puoi selezionare uno qualsiasi di questi tipi.

    • I widget Prospetto e Misuratore sono elencati come Compatibile con le regolazioni perché questi widget possono mostrare una sola serie temporale. Per attivare questi tipi di widget, modifica la configurazione del raggruppamento.

    • Il widget Mappa termica è disabilitato perché questi widget possono mostrare solo i dati con valori di distribuzione.

    • Il riquadro dei log non è elencato perché non può mostrare i dati delle serie temporali.

  9. (Facoltativo) Per modificare la modalità di visualizzazione dei dati selezionati nel grafico, utilizza le opzioni nel riquadro Visualizzazione:

  10. Per applicare le modifiche alla dashboard, fai clic su Applica nella barra degli strumenti. Per annullare le modifiche, fai clic su Annulla.

  11. Per salvare la dashboard modificata, fai clic su Salva nella barra degli strumenti.

Visualizza solo i dati più recenti

Monitoring offre diversi modi per visualizzare solo le misurazioni più recenti, anziché la cronologia delle misurazioni:

  • Per visualizzare graficamente il valore più recente di ogni serie temporale, in cui ogni valore viene visualizzato come frazione della somma di tutti i valori, aggiungi un grafico a torta. Puoi configurare questi grafici in modo da visualizzare il valore totale.

  • Per visualizzare il valore più recente di ogni serie temporale in forma tabulare, aggiungi una tabella. Puoi limitare il numero di righe in una tabella e configurare le righe di una tabella in modo che mostrino un valore rispetto a un intervallo di valori.

  • Per ottenere un'indicazione di colore verde, ambra o rosso del valore più recente rispetto a un insieme di soglie, aggiungi un indicatore o un prospetto alla dashboard.

Rappresenta in un grafico a torta i dati più recenti

Per visualizzare i dati più recenti come frazione del totale, aggiungi un grafico a torta. Come le tabelle, un grafico a torta può visualizzare qualsiasi tipo di metrica che abbia un valore numerico e i percentili delle metriche basate sulla distribuzione. Ogni serie temporale contribuisce con una fetta alla torta.

Lo screenshot seguente mostra una dashboard che mostra l'utilizzo della CPU delle istanze di macchine virtuali utilizzando due diverse configurazioni di un widget Grafico a torta:

Esempio di widget **PieChart**.

Per informazioni su come aggiungere grafici a torta a una dashboard, consulta i seguenti documenti:

  • Console Google Cloud: consulta la sezione Aggiungere grafici e tabelle in questo documento.

    • Dopo aver selezionato i dati da rappresentare nel grafico, nel riquadro Visualizza imposta il campo Tipo di widget su Grafico a torta.
    • Per visualizzare il valore totale, imposta il campo Tipo di grafico su Anello.

  • API Cloud Monitoring: consulta la pagina Dashboard con widget PieChart.

Visualizza i dati più recenti in forma tabulare

Per visualizzare i dati più recenti in forma tabulare, aggiungi una tabella. Le tabelle possono visualizzare qualsiasi tipo di metrica che abbia un valore numerico e i percentili delle metriche con valore di distribuzione. Le tabelle mostrano solo il valore più recente, in modo simile al comportamento di indicatori e prospetti. Tuttavia, a differenza di indicatori e prospetti, le tabelle contengono una riga per ogni serie temporale monitorata.

Esistono due stili di tabelle. Il widget Elenco principale è preconfigurato in modo da avere due colonne e limitare il numero di righe. Una colonna del widget Elenco in alto mostra un'etichetta come instance_id, mentre l'altra mostra sia il valore che un indicatore visivo del valore rispetto all'intervallo di valori possibili. Il widget Tabella è preconfigurato in modo da visualizzare una colonna per ogni etichetta con più di un valore univoco, una riga per ogni serie temporale e un valore numerico come "25%".

Entrambi i widget sono rappresentati dalla stessa struttura di dati. Pertanto, dopo aver aggiunto uno di questi widget alla dashboard, puoi limitare il numero di righe mostrate, modificare le colonne visualizzate dalla tabella e modificare il modo in cui viene rappresentato il valore.

Lo screenshot seguente mostra una dashboard che mostra l'utilizzo della CPU delle istanze di macchine virtuali utilizzando un widget Elenco principale e un widget Tabella:

Esempio di widget **Top List** e **Tabella**.

Per informazioni su come aggiungere tabelle a una dashboard, consulta i seguenti documenti:

Ordinare e filtrare le tabelle

Puoi modificare l'ordine delle righe nella visualizzazione della tabella e filtrare i contenuti della tabella in modo che vengano visualizzate solo righe specifiche. Queste impostazioni non sono permanenti. Quando esci dalla pagina della dashboard o quando ricarichi la dashboard, le opzioni di ordinamento e filtro applicate vengono ignorate.

Sono disponibili le seguenti opzioni di ordinamento e filtro:

  • Per ordinare la tabella in base a una colonna, fai clic sull'intestazione della colonna.

  • Per modificare le colonne della tabella, fai clic su Visualizza colonne, apporta le modifiche e fai clic su OK.

  • Per elencare solo righe specifiche, aggiungi uno o più filtri. Puoi aggiungere più filtri. Se non specifichi l'operatore OR tra due filtri, un AND logico unisce i filtri.

    Per aggiungere un filtro, fai clic su Enter property name or value, seleziona una proprietà dal menu e poi inserisci un valore o seleziona una voce dal menu Valore. Ad esempio, se filtri in base alla proprietà Name e inserisci il valore demo, la tabella elenca solo le righe in cui il campo Name include il valore demo.

Visualizza i dati più recenti con un'indicazione di avviso o errore

Per visualizzare la misurazione più recente rispetto a un insieme di soglie codificate per colore, aggiungi un contatore o un prospetto. Gli indicatori mostrano solo la misurazione più recente, mentre i prospetti mostrano anche una cronologia delle misurazioni recenti. Anche il colore dello sfondo di questi widget è codificato. Quando il valore più recente rientra negli intervalli previsti, il colore del widget è bianco. Quando il valore rientra in un intervallo di avviso, il widget diventa color ambra. Analogamente, quando il valore si trova in un intervallo di pericolo, il widget diventa rosso.

Entrambi i widget visualizzano una singola serie temporale. Lo screenshot seguente mostra un esempio di indicatore quando la misurazione più recente è inferiore alle soglie di avviso e pericolo:

Esempio di un contatore.

Il resto delle informazioni in questa sezione è per la console Google Cloud. Per informazioni sull'utilizzo dell'API Cloud Monitoring, consulta Dashboard con un Scorecard di base.

Legacy

Per aggiungere un indicatore o un prospetto a una dashboard:

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

    Vai alle dashboard

  2. Esegui una di queste operazioni:

    • Per creare una nuova dashboard, seleziona Crea dashboard.
    • Per aggiornare una dashboard esistente, individuala nell'elenco di tutte le dashboard e seleziona il nome corrispondente.

  3. Nella barra degli strumenti, fai clic su  Aggiungi widget.

  4. Nella finestra di dialogo Aggiungi widget, seleziona Metrica .

  5. Specifica i dati da visualizzare nel grafico. Puoi utilizzare un'interfaccia basata su menu, Monitoring Query Language (MQL), PromQL oppure puoi inserire un filtro di Monitoring:

    1. Seleziona i dati delle serie temporali che vuoi visualizzare:

      1. Nel riquadro Seleziona una metrica, espandi il menu Metrica e utilizza i menu per selezionare un tipo di risorsa e di metrica. Ad esempio, potresti effettuare le seguenti scelte:

        1. Nel menu Risorse attive, seleziona Istanza VM.
        2. Nel menu Categorie di metriche attive, seleziona uptime_check.
        3. Nel menu Metriche attive, seleziona Latenza richiesta.
        4. Fai clic su Applica.

        Per limitare il numero di opzioni nei menu, inserisci il nome della metrica o della risorsa nella barra dei filtri. Ad esempio, per rappresentare graficamente la latenza delle richieste per un'istanza VM, puoi inserire "latency".

        Dopo aver effettuato le selezioni, il titolo del riquadro cambia. Ad esempio, se hai fornito i suggerimenti precedenti, il titolo del riquadro diventa Latenza richiesta.

      2. (Facoltativo) Per specificare un sottoinsieme di dati da visualizzare, seleziona Aggiungi filtro e completa la finestra di dialogo. Ad esempio, puoi visualizzare i dati per una zona applicando un filtro. Puoi aggiungere più filtri. Per ulteriori informazioni, consulta la sezione Filtrare i dati dei grafici.

      Per saperne di più, consulta Selezionare i dati da rappresentare su grafico.

    2. Raggruppa e allinea le serie temporali:

      • Lascia vuoto il menu Etichette.
      • (Facoltativo) Modifica il valore della funzione di raggruppamento.

    MQL

    1. Nella barra degli strumenti del riquadro Seleziona una metrica, seleziona il pulsante il cui nome inizia con Codice.
    2. 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.

    3. Inserisci la query nell'Editor query. Devi assicurarti che i campi di aggregazione siano impostati per combinare tutte le serie temporali. 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
| group_by [], [value_utilization_mean_mean: mean(value_utilization_mean)]

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

    PromQL

    1. Nella barra degli strumenti del riquadro Seleziona una metrica, seleziona il pulsante il cui nome inizia con Codice.
    2. 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.

    3. 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.

    Filtro di monitoraggio

    1. Nella barra degli strumenti del riquadro Seleziona una metrica, fai clic su Guida nel menu Metrica, quindi seleziona Modalità filtro diretto.

      Viene visualizzato il campo Inserisci un filtro di monitoraggio. 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.

    2. Inserisci un filtro di Monitoring.

    3. Raggruppa e allinea le serie temporali:

      • Lascia vuoto il menu Etichette.
      • (Facoltativo) Modifica il valore della funzione di raggruppamento.

  6. Nel riquadro Display, configura l'indicatore o il prospetto:

    1. Fai clic su Tipo di widget e seleziona Indicatore o Scheda punteggi.

    2. Per i widget degli indicatori, fai clic su Intervallo indicatore, quindi imposta i valori minimo e massimo. Quando un contatore mostra una percentuale, imposta questi valori rispettivamente su 0 e 1.

    3. Fai clic su Soglia indicatore, quindi imposta le soglie di avviso e pericolo. I campi Soglia vuoti non vengono utilizzati.

      Per l'indicatore visualizzato in precedenza, sono state impostate due soglie. Valori superiori a 0,9 rientrano nell'intervallo di pericolo. Valori superiori a 0,7 ma non compresi nell'intervallo di pericolo, rientrano nell'intervallo di avviso.

    4. Per i prospetti, fai clic su Visualizzazione grafico Spark, espandi il menu delle opzioni e poi seleziona lo stile di visualizzazione.

  7. Per applicare le modifiche alla dashboard, fai clic su Applica nella barra degli strumenti. Per annullare le modifiche, fai clic su Annulla.

  8. Per salvare la dashboard modificata, fai clic su Salva nella barra degli strumenti.

Anteprima

Per aggiungere un indicatore o un prospetto a una dashboard:

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

    Vai alle dashboard

  2. Esegui una di queste operazioni:

    • Per creare una nuova dashboard, seleziona Crea dashboard.
    • Per aggiornare una dashboard esistente, individuala nell'elenco di tutte le dashboard e seleziona il nome corrispondente.

  3. Nella barra degli strumenti, fai clic su  Aggiungi widget.

  4. Nella finestra di dialogo Aggiungi widget, seleziona Metrica .

  5. Specifica i dati da visualizzare nel grafico. Puoi utilizzare un'interfaccia basata su menu, Monitoring Query Language (MQL), PromQL oppure puoi inserire un filtro di Monitoring:

    1. Seleziona i dati delle serie temporali che vuoi visualizzare:

      1. Nell'elemento Metrica, fai clic su Seleziona una metrica, poi utilizza i menu per selezionare un tipo di risorsa e di metrica. Ad esempio, potresti effettuare le seguenti scelte:

        1. Nel menu Risorse attive, seleziona Istanza VM.
        2. Nel menu Categorie di metriche attive, seleziona uptime_check.
        3. Nel menu Metriche attive, seleziona Latenza richiesta.
        4. Fai clic su Applica.

        Per limitare il numero di opzioni nei menu, inserisci il nome della metrica o della risorsa nella barra dei filtri. Ad esempio, per rappresentare graficamente la latenza delle richieste per un'istanza VM, puoi inserire "latency".

        Dopo aver effettuato le selezioni, il titolo del riquadro cambia. Ad esempio, se hai fornito i suggerimenti precedenti, il titolo del riquadro diventa Latenza richiesta.

      2. (Facoltativo) Per specificare un sottoinsieme di dati da visualizzare, nell'elemento Filtro seleziona Aggiungi filtro, quindi completa la finestra di dialogo. Ad esempio, puoi visualizzare i dati per una zona applicando un filtro. Puoi aggiungere più filtri. Per ulteriori informazioni, consulta la sezione Filtrare i dati dei grafici.

      Per saperne di più, consulta Selezionare i dati da rappresentare su grafico.

    2. Combina le serie temporali utilizzando i campi Aggregazione:

      • Espandi il secondo menu e assicurati che non ci siano etichette selezionate.
      • (Facoltativo) Espandi il primo menu e seleziona la funzione che combina le serie temporali.

    MQL

    1. Nella barra degli strumenti del riquadro Seleziona una metrica, seleziona il pulsante il cui nome è  MQL o  PromQL.
    2. 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.

    3. Inserisci la query nell'Editor query. Devi assicurarti che i campi di aggregazione siano impostati per combinare tutte le serie temporali. 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
| group_by [], [value_utilization_mean_mean: mean(value_utilization_mean)]

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

    PromQL

    1. Nella barra degli strumenti del riquadro Seleziona una metrica, seleziona il pulsante il cui nome è  MQL o  PromQL.
    2. 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.

    3. 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.

    Filtro di monitoraggio

    1. Nell'elemento Metrica, fai clic su Guida, 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 mostrate nel campo dell'elemento Filtri.

    2. Inserisci un filtro di Monitoring.

    3. Raggruppa e allinea le serie temporali:

      • Lascia vuoto il menu Etichette.
      • (Facoltativo) Modifica il valore della funzione di raggruppamento.

  6. Nel riquadro Display, configura l'indicatore o il prospetto:

    1. Fai clic su Tipo di widget e seleziona Indicatore o Scheda punteggi.

    2. Per i widget degli indicatori, fai clic su Intervallo indicatore, quindi imposta i valori minimo e massimo. Quando un contatore mostra una percentuale, imposta questi valori rispettivamente su 0 e 1.

    3. Fai clic su Soglia indicatore, quindi imposta le soglie di avviso e pericolo. I campi Soglia vuoti non vengono utilizzati.

      Per l'indicatore visualizzato in precedenza, sono state impostate due soglie. Valori superiori a 0,9 rientrano nell'intervallo di pericolo. Valori superiori a 0,7 ma non compresi nell'intervallo di pericolo, rientrano nell'intervallo di avviso.

    4. Per i prospetti, fai clic su Visualizzazione grafico Spark, espandi il menu delle opzioni e poi seleziona lo stile di visualizzazione.

  7. Per applicare le modifiche alla dashboard, fai clic su Applica nella barra degli strumenti. Per annullare le modifiche, fai clic su Annulla.

  8. Per salvare la dashboard modificata, fai clic su Salva nella barra degli strumenti.

Passaggi successivi

Alle tue dashboard personalizzate puoi anche aggiungere i seguenti widget:

Per informazioni su come esplorare i dati dei grafici e filtrare le dashboard, consulta i seguenti documenti: