Installare un modello di dashboard

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

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

Questa funzionalità è supportata solo per i progetti Google Cloud.

Installare un modello di dashboard

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

Console Google Cloud

Per installare un modello di dashboard utilizzando la console Google Cloud, segui questi passaggi:

1. Nella console Google Cloud, 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 console Google Cloud, seleziona il tuo progetto Google Cloud.

3. Esegui una di queste operazioni:

   • Per installare un modello dalla raccolta disponibile nella console Google Cloud, segui questi passaggi:

     1. Fai clic su Modelli di dashboard.
     2. Cerca la dashboard che vuoi installare.
     3. (Facoltativo) Per visualizzare l'anteprima della dashboard, selezionala.

     4. Fai clic su Aggiungi dashboard al tuo elenco e completa la finestra di dialogo.

        La finestra di dialogo ti consente di selezionare il nome della dashboard e di aggiungervi le etichette.

   • Per installare una dashboard caricando un file JSON:

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

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

     2. Fai clic su Crea dashboard.

     3. Nella barra degli strumenti della dashboard, Impostazioni, quindi JSON e seleziona Editor JSON.

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

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

     4. Nella barra degli strumenti dell'editor, fai clic su Carica file.

     5. Seleziona il file che contiene il modello e fai clic su Apri.

        Dopo il caricamento del file, il file JSON della dashboard viene aggiornato.

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

     6. (Facoltativo) Personalizza la dashboard. Ad esempio, puoi aggiornare il titolo, aggiungere un widget di testo che indichi l'origine della dashboard, eliminare i grafici indesiderati o aggiungerne altri.

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

Interfaccia a riga di comando gcloud

Per installare una definizione della dashboard utilizzando Google Cloud CLI, segui questi passaggi:

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 comando gcloud monitoring dashboards create 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.

API Cloud Monitoring

Per installare una definizione della dashboard utilizzando Google Cloud CLI, segui questi passaggi:

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 representatione JSON della dashboard. Nella chiamata all'API, il progetto principale è il progetto in cui creare il monitoraggio sintetico. Questo campo ha il seguente formato:

   projects/PROJECT_ID
   

Per scoprire 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 console Google Cloud, 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 console Google Cloud, seleziona il tuo progetto Google Cloud.
3. Nell'elenco delle dashboard, fai clic su "Monitoraggio delle istanze VM GCE". Se hai molte dashboard, ti consigliamo di filtrare in base alle dashboard personalizzate o al 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 trovare 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. Analogamente, potresti aggiungere l'etichetta staging per indicare che la dashboard mostra informazioni sui sistemi di staging.

Puoi aggiungere etichette solo alle dashboard personalizzate. Quando in una dashboard viene visualizzato il pulsante Aggiungi etichette alla dashboard, puoi configurare le etichette da applicare alla dashboard.

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

1. Nella console Google Cloud, 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 poi 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 poi fai clic su Ok.
4. Per salvare le modifiche, fai clic su Conferma.