Installer des exemples de tableaux de bord

Cloud Monitoring fournit une sélection de définitions de tableau de bord sur GitHub, spécifiques à divers services Google Cloud, par exemple 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 monitoring-dashboard-samples GitHub. Chaque définition est stockée sous forme de 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:

Dans le panneau de navigation de la console Google Cloud, sélectionnez Surveillance, puis Tableaux de bord:
Accéder à la page Tableaux de bord
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.
  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.

gcloud CLI

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

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

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
```
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.
Appelez dashboards.create et fournissez la représentation JSON du tableau de bord.

Pour en savoir plus, consultez Gérer les 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).

Dans le panneau de navigation de la console Google Cloud, sélectionnez Surveillance, puis Tableaux de bord:
Accéder à la page Tableaux de bord
Cliquez sur "GCE VM Instance Monitoring" (Surveillance des instances de VM GCE) dans la liste. Si vous avez beaucoup de 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 du tableau de bord de surveillance d'une instance de VM Compute Engine.