Installare un modello di dashboard

Cloud Monitoring fornisce un insieme selezionato di modelli di dashboard su GitHub specifici per una serie di servizi, ad esempio Compute Engine, Cloud Storage, BigQuery e altri. Google Cloud I grafici di queste dashboard presentano una selezione di metriche pertinenti a 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 dalla consoleGoogle Cloud o archiviato nel repository GitHub monitoring-dashboard-samples. Ogni modello viene archiviato come file JSON. Questa pagina descrive anche come visualizzare la dashboard nella consoleGoogle Cloud .

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

Installare un modello di dashboard

Console Google Cloud

Per installare un modello di dashboard utilizzando la console Google Cloud :

  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 . Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione.

  3. Esegui una di queste operazioni:

    • Per installare un modello dalla libreria disponibile nella consoleGoogle Cloud , segui questi passaggi:

      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 poi completa la finestra di dialogo.

        La finestra di dialogo ti consente di selezionare il nome della dashboard e 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

      2. Fai clic su Crea dashboard.

      3. 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": {}
        }
        
      4. Nella barra degli strumenti dell'editor, fai clic su Caricamento file.

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

        Una volta 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.

      6. (Facoltativo) Personalizza la dashboard. Ad esempio, puoi aggiornare il titolo, aggiungere un widget di testo che indica l'origine del report, eliminare grafici indesiderati o aggiungere grafici.

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

Interfaccia a riga di comando gcloud

Per installare una definizione del 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 oppure scaricare l'intero repository:

    git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples.git
    
  2. Identifica i 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, emetti 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.

API Cloud Monitoring

Per installare una definizione del 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 oppure scaricare l'intero repository:

    git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples.git
    
  2. Identifica i 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 il numero dashboards.create e fornisci la rappresentazione JSON della dashboard. Nella chiamata API, il progetto padre è il progetto in cui creare il monitoraggio 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 la pagina Creare e gestire 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 . 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 per dashboard personalizzate o per il nome della nuova dashboard.

Il seguente screenshot mostra la parte della dashboard installata:

Esempio della dashboard Monitoraggio delle istanze VM di Compute Engine.

Aggiungere o rimuovere etichette definite dall'utente

Le etichette possono aiutarti a individuare le dashboard in base al tipo di contenuti che visualizzano. Ad esempio, potresti aggiungere l'etichetta prod alle dashboard che mostrano informazioni sui sistemi di produzione. Allo stesso modo, potresti 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 pulsante Aggiungi etichette alla dashboard, puoi configurare le etichette da applicare alla dashboard.

Per aggiungere o rimuovere etichette definite dall'utente in 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.