Installare un modello di dashboard

Cloud Monitoring fornisce un insieme curato di modelli di dashboard su GitHub specifici per una varietà di Google Cloud servizi, ad esempio Compute Engine, Cloud Storage, BigQuery e altri. I grafici di queste dashboard presentano una selezione di metriche pertinenti a un servizio specifico. Puoi installare questi modelli nel tuo Google Cloud progetto come dashboard personalizzate utilizzando l'API Cloud Monitoring o la Google Cloud console.

Questa pagina descrive come installare un modello disponibile dalla Google Cloud console o archiviato nel repository GitHub monitoring-dashboard-samples. Ogni modello viene archiviato come file JSON. Questa pagina descrive anche come visualizzare la dashboard nella Google Cloud console.

Questa funzionalità è supportata solo per i Google Cloud progetti. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione.

Installare un modello di dashboard

Nota: alcuni dei modelli di dashboard archiviati nel repository monitoring-dashboard-samples GitHub mostrano i dati metrica personalizzata. Per installare correttamente queste dashboard, devi creare le metriche definite dall'utente necessarie. Per ulteriori informazioni, consulta la documentazione per servizio nel repository.

Google Cloud Console

Per installare un modello di dashboard utilizzando la Google Cloud console, procedere come segue:

1. Nella Google Cloud console, vai alla pagina  Dashboard:

   Vai a Dashboard

   Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

2. Nella barra degli strumenti della Google Cloud console, seleziona il tuo Google Cloud progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione.

3. Esegui una delle seguenti operazioni:

   • Per installare un modello dalla libreria disponibile nella Google Cloud console:

     1. Fai clic su Modelli di dashboard.
     2. Trova la dashboard che vuoi installare.
     3. (Facoltativo) Per visualizzare l'anteprima della dashboard, selezionala.
     4. Fai clic su Aggiungi dashboard all'elenco e completa la finestra di dialogo.

     La finestra di dialogo ti consente di selezionare il nome della dashboard e di aggiungere etichette alla dashboard.

   • Per installare una dashboard caricando un file JSON:

     1. (Facoltativo) Per installare un modello di dashboard curato, scarica il repository GitHub:

     git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples.git

     1. Fai clic su Crea dashboard.
     2. Nella barra degli strumenti della dashboard, Impostazioni, poi JSON e infine seleziona Editor JSON.

     Per una nuova dashboard, il codice visualizzato è simile al seguente:

     {
         "displayName": "New Dashboard",
         "mosaicLayout": {
           "columns": 12,
           "tiles": []
         },
         "dashboardFilters": [],
         "labels": {}
     }
     

     1. Nella barra degli strumenti dell'editor, fai clic su Carica Caricamento file.
     2. Seleziona il file che contiene il modello e fai clic su Apri.

     Dopo aver caricato il file, il JSON della dashboard viene aggiornato.

     Se visualizzi il messaggio "Impossibile salvare la dashboard: il campo mosaicLayout.tiles[0] ha un valore non valido", seleziona Griglia nella barra degli strumenti della dashboard.

     1. (Facoltativo) Personalizza la dashboard. Ad esempio, puoi aggiornare il titolo, aggiungere un widget di testo che indica l'origine della dashboard, eliminare i grafici indesiderati o aggiungere grafici.
     2. Per salvare la dashboard modificata, fai clic su Salva nella barra degli strumenti.

Gcloud CLI

Per installare una definizione di dashboard utilizzando Google Cloud CLI:

1. Assicurati che la definizione della dashboard sia accessibile al tuo sistema locale.

   Per le dashboard archiviate nel repository GitHub, puoi salvare dashboard specifiche o scaricare l'intero repository:

   git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples.git
   

2. Identifica le dashboard che vuoi installare.

   Ad esempio, nel repository GitHub, la directory monitoring-dashboard-samples/dashboards/compute contiene un file denominato gce-vm-instance-monitoring.json.

3. Esegui il gcloud monitoring dashboards create comando e fornisci la rappresentazione JSON della dashboard.

   Ad esempio, per installare la dashboard gce-vm-instance-monitoring.json, esegui il seguente comando:

   gcloud monitoring dashboards create --config-from-file=gce-vm-instance-monitoring.json --project=PROJECT_ID
   

   Prima di eseguire il comando precedente, sostituisci quanto segue:

   • PROJECT_ID: l'identificatore del progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione.

REST

Per installare una definizione di dashboard utilizzando Google Cloud CLI:

1. Assicurati che la definizione della dashboard sia accessibile al tuo sistema locale.

   Per le dashboard archiviate nel repository GitHub, puoi salvare dashboard specifiche o scaricare l'intero repository:

   git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples.git
   

2. Identifica le dashboard che vuoi installare.

   Ad esempio, nel repository GitHub, la directory monitoring-dashboard-samples/dashboards/compute contiene un file denominato gce-vm-instance-monitoring.json.

3. Chiama dashboards.create e fornisci la rappresentazione JSON della dashboard. Nella chiamata API, il progetto padre è il progetto in cui creare il monitor sintetico. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione. Questo campo ha il seguente formato:

   projects/PROJECT_ID
   

Per saperne di più, consulta Creare e gestire le dashboard.

Visualizzare la dashboard installata

Ogni file nel repository crea una nuova dashboard personalizzata. Ad esempio, il file gce-vm-instance-monitoring.json crea una dashboard con il titolo "Monitoraggio delle istanze VM GCE". Per visualizzare questa dashboard:

1. Nella Google Cloud console, vai alla pagina  Dashboard:

   Vai a Dashboard

   Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

2. Nella barra degli strumenti della Google Cloud console, seleziona il tuo Google Cloud progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione.
3. Nell'elenco delle dashboard, fai clic su "Monitoraggio delle istanze VM GCE". Se hai molte dashboard, potresti voler filtrare le dashboard personalizzate o il nome della nuova dashboard.

Lo screenshot seguente mostra la parte della dashboard installata:

Aggiungere o rimuovere etichette definite dall'utente

Le etichette possono aiutarti a individuare le dashboard in base al tipo di contenuti visualizzati. Ad esempio, puoi aggiungere l'etichetta prod alle dashboard che mostrano informazioni sui sistemi di produzione. Allo stesso modo, puoi aggiungere l'etichetta staging per indicare che la dashboard mostra informazioni sui sistemi di staging.

Puoi aggiungere etichette solo alle dashboard personalizzate. Quando una dashboard mostra il Aggiungi etichette alla dashboard pulsante, puoi configurare le etichette applicate alla dashboard.

Per aggiungere o rimuovere etichette definite dall'utente a una dashboard personalizzata:

1. Nella Google Cloud console, vai alla pagina  Dashboard:

   Vai a Dashboard

   Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

2. Nell'elenco delle dashboard, individua la dashboard e poi fai clic su Aggiungi etichette alla dashboard.
3. Esegui una delle seguenti operazioni:

   • Per creare un'etichetta e aggiungerla alla dashboard, nella sezione Crea una nuova etichetta, inserisci il nome dell'etichetta nella casella di testo e fai clic su Crea e applica.

   • Per configurare le etichette da aggiungere alla dashboard, fai clic su Seleziona le etichette da applicare, seleziona le etichette e fai clic su Ok.
4. Per salvare le modifiche, fai clic su Conferma.