Installer des exemples de tableaux de bord

Cloud Monitoring fournit un ensemble organisé de définitions de tableau de bord sur GitHub spécifiques à divers services Google Cloud, tels que Compute Engine, Cloud Storage, BigQuery, etc. Les graphiques de ces tableaux de bord présentent une sélection de métriques pertinentes pour un service spécifique. Vous pouvez installer ces définitions dans votre projet Google Cloud en tant que tableaux de bord personnalisés à l'aide de l'API Cloud Monitoring ou de la console Google Cloud.

Cette page explique comment installer une définition de tableau de bord stockée dans le dépôt GitHub monitoring-dashboard-samples. Chaque définition est stockée sous la forme d'un fichier JSON. Cette page explique également comment afficher le tableau de bord dans la console Google Cloud.

Installer un exemple de tableau de bord

Console Google Cloud

Pour installer une définition de tableau de bord à l'aide de la console Google Cloud, procédez comme suit:

  1. Dans la console Google Cloud, accédez à la page Tableaux de bord .

    Accéder à la page Tableaux de bord

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

  2. Effectuez l'une des opérations suivantes :

    • Pour installer un tableau de bord à partir de l'exemple de bibliothèque, procédez comme suit :

      1. Cliquez sur l'onglet Exemple de bibliothèque.

        Affichage de l'onglet "Exemple de bibliothèque" sélectionné.

      2. Sélectionnez les tableaux de bord que vous souhaitez installer.

      3. (Facultatif) Pour afficher les détails d'un tableau de bord ou pour prévisualiser son contenu, cliquez sur Aperçu.

      4. (Facultatif) Pour afficher la représentation JSON d'un tableau de bord, cliquez sur Aperçu, puis sur JSON.

      5. Cliquez sur Import (Importer).

    • Pour installer un tableau de bord en important un fichier JSON, procédez comme suit :

      1. (Facultatif) Pour installer une définition de tableau de bord organisée, téléchargez le dépôt GitHub :

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

      2. Cliquez sur Créer un tableau de bord.

      3. Dans la barre d'outils du tableau de bord, cliquez sur  Éditeur JSON.

        Pour un nouveau tableau de bord, le code affiché est semblable à celui-ci:

        {
          "category": "CUSTOM",
          "displayName": "New Dashboard",
          "mosaicLayout": {
            "columns": 12
          },
        }
        
      4. Dans la barre d'outils de l'éditeur, cliquez sur Importation de fichiers.

      5. Sélectionnez le fichier contenant la définition du tableau de bord, puis cliquez sur Ouvrir.

        Une fois le fichier importé, le fichier JSON du tableau de bord est mis à jour.

        Si le message suivant s'affiche "Impossible d'enregistrer le tableau de bord : Field mosaicLayout.tiles[0] possède une valeur non valide", sélectionnez Grille dans la barre d'outils du tableau de bord.

      6. (Facultatif) Personnalisez le tableau de bord. Par exemple, vous pouvez mettre à jour le titre, ajouter une zone de texte indiquant la source du tableau de bord, supprimer les graphiques indésirables ou ajouter des graphiques.

CLI gcloud

Pour installer une définition de tableau de bord à l'aide de Google Cloud CLI, procédez comme suit:

  1. Assurez-vous que votre système local peut accéder à la définition du tableau de bord.

    Pour les tableaux de bord stockés dans le dépôt GitHub, vous pouvez enregistrer des tableaux de bord spécifiques ou télécharger l'intégralité du dépôt:

    git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples.git
    
  2. Identifiez les tableaux de bord que vous souhaitez installer.

    Par exemple, dans le dépôt GitHub, le répertoire monitoring-dashboard-samples/dashboards/compute contient un fichier nommé gce-vm-instance-monitoring.json.

  3. Exécutez la commande gcloud monitoring dashboards create et fournissez la représentation JSON du tableau de bord.

    Par exemple, pour installer le tableau de bord gce-vm-instance-monitoring.json, exécutez la commande suivante:

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

API Cloud Monitoring

Pour installer une définition de tableau de bord à l'aide de Google Cloud CLI, procédez comme suit:

  1. Assurez-vous que votre système local peut accéder à la définition du tableau de bord.

    Pour les tableaux de bord stockés dans le dépôt GitHub, vous pouvez enregistrer des tableaux de bord spécifiques ou télécharger l'intégralité du dépôt:

    git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples.git
    
  2. Identifiez les tableaux de bord que vous souhaitez installer.

    Par exemple, dans le dépôt GitHub, le répertoire monitoring-dashboard-samples/dashboards/compute contient un fichier nommé gce-vm-instance-monitoring.json.

  3. Appelez dashboards.create et fournissez la représentation JSON du tableau de bord.

    Pour en savoir plus, consultez la section Créer et gérer des tableaux de bord.

Afficher le tableau de bord installé

Chaque fichier du dépôt crée un tableau de bord personnalisé. Par exemple, le fichier gce-vm-instance-monitoring.json crée un tableau de bord intitulé "GCE VM Instance Monitoring" (Surveillance des instances de VM GCE). Pour afficher ce tableau de bord, procédez comme suit:

  1. Dans la console Google Cloud, accédez à la page Tableaux de bord .

    Accéder à la page Tableaux de bord

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

  2. Dans la liste des tableaux de bord, cliquez sur "GCE VM Instance Monitoring" (Surveillance des instances de VM GCE). Si vous avez de nombreux tableaux de bord, vous pouvez filtrer les tableaux de bord personnalisés ou le nom du nouveau tableau de bord.

La capture d'écran suivante montre la partie du tableau de bord installé :

Exemple de tableau de bord Compute Engine VM Instance Monitoring