Créer et gérer des tableaux de bord personnalisés

Ce document explique comment créer et gérer des tableaux de bord personnalisés à l'aide de la console Google Cloud. Les tableaux de bord personnalisés vous permettent d'afficher les informations qui vous intéressent, organisées de manière utile. Par exemple, vous pouvez créer un tableau de bord pour afficher les journaux, les métriques de performances et les règles d'alerte pour les machines virtuelles (VM) dans votre environnement de production. Une fois que vous avez créé un tableau de bord personnalisé, vous pouvez également le copier, le modifier et le partager. Pour créer des tableaux de bord, vous pouvez utiliser la console Google Cloud, l'API Cloud Monitoring ou la Google Cloud CLI.

Ce document explique comment créer et gérer vos tableaux de bord personnalisés à l'aide de la console Google Cloud:

• Pour en savoir plus sur l'API et la Google Cloud CLI, consultez la page Créer et gérer des tableaux de bord à l'aide d'API.
• Pour en savoir plus sur les tableaux de bord Google Cloud spécifiques au service, consultez la page Afficher les tableaux de bord Google Cloud.

À propos des tableaux de bord personnalisés

Les tableaux de bord personnalisés sont compatibles avec différents types de widgets. Vous pouvez ainsi choisir la meilleure façon d'afficher vos données. Par défaut, les tableaux de bord affichent toutes les données de métriques disponibles pour votre projet Google Cloud. Si vous configurez un champ d'application des métriques, votre tableau de bord peut afficher les données de métriques de plusieurs projets Google Cloud.

Un tableau de bord personnalisé peut afficher tous les éléments suivants:

• Graphiques et indicateurs
• Entrées de journaux provenant de plusieurs projets ou vues de journaux Google Cloud
• Graphiques pour les règles d'alerte :
• Incidents
• Objectifs de niveau de service (SLO)
• Texte

Vous pouvez améliorer le temps de chargement ou l'usabilité d'un tableau de bord en groupant des widgets. Par exemple, vous pouvez ajouter des sections à un tableau de bord. Vous pouvez également ajouter des widgets à un conteneur développé ou réduit.

Une fois que vous avez créé un tableau de bord, vous pouvez ajouter des filtres, des événements ou des libellés:

• Les filtres appliqués à l'ensemble du tableau de bord s'appliquent à tous les widgets du tableau de bord, ou à certains d'entre eux. Ces filtres peuvent être utiles pour le dépannage. Par exemple, vous pouvez utiliser ces filtres pour n'afficher que les données d'une zone spécifique. Pour en savoir plus, consultez la section Ajouter ou supprimer des filtres.

• Les événements, tels que le plantage d'un pod Google Kubernetes Engine, peuvent vous aider à corréler les données de différentes sources lorsque vous résolvez un problème. Pour en savoir plus, consultez la section Afficher des événements dans un tableau de bord.

• Les libellés peuvent vous aider à trouver des tableaux de bord en fonction du type de contenu qu'ils affichent. Par exemple, vous pouvez ajouter le libellé prod aux tableaux de bord qui affichent des informations sur les systèmes de production. De même, vous pouvez ajouter le libellé staging pour indiquer que le tableau de bord affiche des informations sur les systèmes de préproduction.

  Lorsque vous consultez vos tableaux de bord, vous pouvez sélectionner un libellé pour filtrer la liste sur les tableaux de bord qui contiennent le libellé sélectionné.

Avant de commencer

Pour obtenir les autorisations nécessaires pour créer et modifier des tableaux de bord personnalisés à l'aide de la console Google Cloud, demandez à votre administrateur de vous accorder le rôle IAM Éditeur Monitoring (roles/monitoring.editor) sur votre projet. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

Pour en savoir plus sur les rôles, consultez la section Contrôler les accès avec Identity and Access Management.

Ajouter un tableau de bord personnalisé à votre projet

Vous pouvez utiliser différentes approches pour ajouter un tableau de bord personnalisé à votre projet Google Cloud:

• Vous pouvez créer un tableau de bord.
• Vous pouvez copier ou dupliquer un tableau de bord.
• Vous pouvez copier un tableau de bord d'un projet à un autre.
• Vous pouvez importer ou installer des tableaux de bord à partir d'un emplacement partagé.
• Vous pouvez importer un tableau de bord depuis Grafana.

Par exemple, supposons que vous ayez plusieurs projets Google Cloud et que vous souhaitiez qu'ils définissent le même tableau de bord personnalisé. Dans ce cas, vous pouvez créer le tableau de bord dans un projet, puis copier sa définition dans d'autres projets. Vous pouvez également télécharger la définition du tableau de bord sur votre système local, puis installer cette définition dans d'autres projets Google Cloud.

Créer un tableau de bord

Pour créer un tableau de bord personnalisé, 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. Sur la page Dashboards (Tableaux de bord), cliquez sur Create custom dashboard (Créer un tableau de bord personnalisé).

3. Pour ajouter des widgets à votre tableau de bord, procédez comme suit:

   1. Dans la barre d'outils du tableau de bord, cliquez sur add Ajouter un widget.

   2. Dans le volet Ajouter un widget, sélectionnez un widget à ajouter à votre tableau de bord.

      Vous pouvez sélectionner un widget en fonction du type de données à afficher ou de la façon dont vous souhaitez les afficher. Dans tous les cas, un volet de configuration s'ouvre. Par exemple, vous pouvez sélectionner le widget Métrique, puis définir la visualisation sur Aire cumulée. Vous pouvez également sélectionner le widget Zone empilée, puis la métrique.

   3. Configurez le widget.

   4. Pour appliquer vos modifications au tableau de bord, cliquez sur Appliquer dans la barre d'outils. Pour supprimer vos modifications, cliquez sur Annuler.

      Une fois le widget ajouté à votre tableau de bord, vous pouvez modifier sa configuration.

4. Pour enregistrer le tableau de bord modifié, cliquez sur Enregistrer dans la barre d'outils.

5. Facultatif: Ajoutez des libellés à votre tableau de bord:

   1. Dans la liste des tableaux de bord, recherchez le tableau de bord, puis cliquez sur check_box_outline_blank Sélectionner.
   2. Dans la barre d'outils, cliquez sur Étiquettes, puis effectuez l'une des opérations suivantes :

      • Pour créer un libellé et l'ajouter à votre tableau de bord, saisissez son nom dans la zone de texte Créer un libellé, puis cliquez sur Créer et appliquer.

        L'étiquette est créée et ajoutée à votre tableau de bord.

      • Pour configurer les libellés à ajouter à votre tableau de bord, cliquez sur arrow_drop_down Sélectionner les libellés à appliquer, sélectionnez les libellés, puis cliquez sur OK.
   3. Pour enregistrer vos modifications, cliquez sur Confirmer.

Copier un tableau de bord

Lorsque vous souhaitez tester différentes métriques ou différentes options d'agrégation, vous pouvez copier un tableau de bord, puis utiliser le nouveau tableau de bord à des fins de test.

Pour copier un 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. Sur la page Aperçu des tableaux de bord, identifiez le tableau de bord à copier, puis cliquez sur content_copy Copier le tableau de bord.
3. Facultatif: Modifiez le nom du tableau de bord.
4. Cliquez sur Copier dans la boîte de dialogue de confirmation.

Copier un tableau de bord dans un autre projet

Pour copier un tableau de bord d'un projet à un autre, votre rôle IAM pour les projets Google Cloud de destination doit inclure l'autorisation d'éditeur Monitoring. Pour en savoir plus sur les rôles, consultez Contrôler les accès avec Identity and Access Management.

Pour copier un tableau de bord dans un autre projet 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. Copiez la définition du tableau de bord dans votre presse-papiers:

   1. Dans la barre d'outils du tableau de bord, cliquez sur settings Paramètres, puis sur JSON, puis sur Éditeur JSON.
   2. Dans la barre d'outils de l'éditeur, cliquez sur content_copy Copier.

3. Collez la définition dans un tableau de bord créé dans un projet différent:

   1. Utilisez l'outil de sélection de projets de la console Google Cloud pour sélectionner le projet dans lequel vous souhaitez enregistrer la définition du tableau de bord.
   2. Cliquez sur Créer un tableau de bord personnalisé.
   3. Dans la barre d'outils du tableau de bord, cliquez sur settings Paramètres, sur JSON, puis sur Éditeur JSON.
   4. Collez le contenu de votre presse-papiers dans l'éditeur.
   5. Cliquez sur Appliquer les modifications.
   6. Pour enregistrer le tableau de bord modifié, cliquez sur Enregistrer dans la barre d'outils.

Installer un tableau de bord

Vous pouvez importer dans votre projet Google Cloud un tableau de bord personnalisé dont la définition est stockée dans un emplacement partagé. Cloud Monitoring fournit, par exemple, un ensemble organisé de définitions de tableau de bord sur GitHub spécifiques à divers services Google Cloud. Les graphiques de ces tableaux de bord présentent une sélection de métriques pertinentes pour un service spécifique.

Une fois que vous avez importé une définition de tableau de bord, vous pouvez la modifier pour afficher les données souhaitées.

Pour en savoir plus, consultez Installer des exemples de tableaux de bord.

Importer un tableau de bord depuis Grafana

Cloud Monitoring fournit un outil permettant d'importer des fichiers de tableau de bord Grafana au format JSON dans Cloud Monitoring. Pour en savoir plus, consultez la page Importer des tableaux de bord Grafana dans Cloud Monitoring.

Rechercher et afficher un tableau de bord

Les tableaux de bord personnalisés s'affichent dans la même liste que les tableaux de bord spécifiques au service créés par Cloud Monitoring lorsque vous ajoutez des ressources à votre projet Google Cloud.

Pour afficher un tableau de bord:

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.

   La page Mes tableaux de bord répertorie tous les tableaux de bord de votre projet Google Cloud.

2. Pour rechercher un tableau de bord, procédez comme suit:

   • Sélectionnez une catégorie. Par exemple, pour lister les tableaux de bord créés automatiquement par Google Cloud en fonction de votre utilisation des services Google Cloud, sélectionnez G​C​P. Pour affiner davantage la liste, utilisez la barre Filtrer.

   • Sélectionnez un libellé défini par l'utilisateur. Par exemple, supposons que vous ayez créé un libellé nommé Staging, puis que vous ayez appliqué ce libellé à vos tableaux de bord qui affichent des informations sur vos ressources de préproduction. Pour afficher ces tableaux de bord, sélectionnez le libellé Staging (Préparation). Pour affiner davantage la liste, utilisez la barre Filtrer.

   • Ajoutez des filtres à la barre Filtre:

     • Pour afficher les tableaux de bord dont le nom ou la description contient un texte spécifique, saisissez ce texte dans la barre Filtrer.

     • Pour afficher la liste des tableaux de bord après avoir filtré par la valeur du champ "Tableau de bord", procédez comme suit:

       1. Sélectionnez Filtrer les tableaux de bord, puis un champ à filtrer. Vous pouvez filtrer par les champs de tableau de bord suivants: nom, description, type et libellé défini par l'utilisateur.

       2. Saisissez une valeur pour le filtre ou effectuez une sélection dans le menu.

     • Pour afficher la liste des tableaux de bord sans graphiques, sélectionnez Filtrer les tableaux de bord, Libellés, puis (Vide).

     Lorsque vous ajoutez plusieurs filtres et que vous n'incluez pas l'opérateur OU entre deux filtres, un opérateur AND joint les filtres.

3. Une fois que vous avez trouvé le tableau de bord, sélectionnez-le.

Modifier un tableau de bord

Après avoir créé un tableau de bord, vous pouvez déterminer qu'il doit être modifié pour vous être plus utile. Par exemple, vous pouvez ajouter ou supprimer des widgets, modifier la mise en page ou la façon dont un widget affiche les données. Vous pouvez également ajouter des libellés à un tableau de bord pour le trouver plus facilement ou pour indiquer le type de contenu qu'il contient.

Ajouter ou supprimer des libellés

Pour ajouter ou supprimer des étiquettes, 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, recherchez le tableau de bord, puis cliquez sur check_box_outline_blank Sélectionner.
3. Dans la barre d'outils, cliquez sur Étiquettes, puis effectuez l'une des opérations suivantes :

   • Pour créer un libellé et l'ajouter à votre tableau de bord, saisissez son nom dans la zone de texte Créer un libellé, puis cliquez sur Créer et appliquer.

     L'étiquette est créée et ajoutée à votre tableau de bord.

   • Pour configurer les libellés à ajouter à votre tableau de bord, cliquez sur arrow_drop_down Sélectionner les libellés à appliquer, sélectionnez les libellés, puis cliquez sur OK.
4. Pour enregistrer vos modifications, cliquez sur Confirmer.

Ajouter ou supprimer des filtres et des variables

Une fois le tableau de bord créé, vous pouvez ajouter des filtres et des variables. Les filtres s'appliquent à tous les widgets d'un tableau de bord. Les variables s'appliquent à certains widgets du tableau de bord. Les filtres et les variables peuvent être utiles pour résoudre les problèmes. Par exemple, vous pouvez utiliser un filtre pour que le tableau de bord n'affiche que les données d'une zone spécifique.

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. Recherchez et sélectionnez le tableau de bord.

   • Pour ajouter un filtre appliqué à l'ensemble du tableau de bord qui ne s'applique qu'à votre session en cours, utilisez la barre de filtre filter_list du tableau de bord. Pour en savoir plus, consultez la section Filtres temporaires.

   • Pour ajouter un filtre permanent à l'ensemble du tableau de bord, dans la barre d'outils du tableau de bord, accédez à settings Paramètres, puis sélectionnez Gérer les filtres. Pour en savoir plus, consultez la section Créer et gérer des variables et des filtres épinglés.

Modifier les widgets ou la mise en page

Pour modifier les widgets d'un tableau de bord ou sa mise en page, 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. Recherchez et sélectionnez le tableau de bord.

3. (Facultatif) Pour ajouter un widget à votre tableau de bord, dans la barre d'outils du tableau de bord, cliquez sur add Ajouter un widget, puis sélectionnez et configurez le widget. Pour appliquer vos modifications au tableau de bord, cliquez sur Appliquer dans la barre d'outils. Pour supprimer vos modifications, cliquez sur Annuler.

   Pour en savoir plus, consultez les pages suivantes :

   • Ajouter des graphiques et des tableaux
   • Afficher les règles d'alerte et les incidents
   • Afficher les journaux
   • Afficher les SLO
   • Ajouter du texte et des regroupements

4. Facultatif: Pour modifier un widget, procédez comme suit:

   • Placez votre pointeur sur le widget pour activer la barre d'outils, cliquez sur edit Modifier le widget, puis mettez à jour le widget. Pour appliquer vos modifications au tableau de bord, cliquez sur Appliquer dans la barre d'outils. Pour supprimer vos modifications, cliquez sur Annuler.

     Vous pouvez modifier la plupart des paramètres du widget, y compris son type. Par exemple, pour modifier un graphique en courbes en graphique en aires empilées, cliquez sur Graphique en courbes arrow_drop_down, puis sélectionnez Graphique en aires empilées dans le menu. Pour en savoir plus, consultez la section Modifier le type d'un widget.

   • Cliquez sur settings Paramètres, sur JSON, puis sur Éditeur JSON. Si vous modifiez le fichier JSON, vous devez cliquer sur Appliquer les modifications.

     Vous pouvez également accéder au fichier JSON d'un widget en le modifiant dans la barre d'outils des widgets, puis en cliquant sur code Afficher le code.

5. Facultatif: Pour supprimer un widget, placez votre pointeur sur le widget afin d'activer la barre d'outils, puis effectuez l'une des opérations suivantes:

   • Si la barre d'outils du widget affiche un bouton delete Supprimer, cliquez dessus.
   • Sinon, cliquez sur more_vert Plus d'options, puis sélectionnez Supprimer le widget.

   Pour appliquer vos modifications au tableau de bord, cliquez sur Appliquer dans la barre d'outils. Pour supprimer vos modifications, cliquez sur Annuler.

6. Facultatif: Pour repositionner un widget, utilisez votre pointeur au niveau son en-tête pour le faire glisser vers un nouvel emplacement. Pour appliquer vos modifications au tableau de bord, cliquez sur Appliquer dans la barre d'outils. Pour supprimer vos modifications, cliquez sur Annuler.

   Vous ne pouvez pas repositionner les widgets lorsqu'un tableau de bord est en mode grille.

7. Facultatif: Pour redimensionner un widget, utilisez votre pointeur sur le coin droit du widget pour le repositionner. Pour appliquer vos modifications au tableau de bord, cliquez sur Appliquer dans la barre d'outils. Pour supprimer vos modifications, cliquez sur Annuler.

   Vous ne pouvez pas redimensionner les widgets lorsqu'un tableau de bord est en mode grille.

8. Pour enregistrer le tableau de bord modifié, cliquez sur Enregistrer dans la barre d'outils.

Supprimer un tableau de bord

La suppression d'un tableau de bord contenant un graphique pour une règle d'alerte ne supprime pas les règles d'alerte dont les données étaient affichées sur ces graphiques. Par conséquent, vous pourrez recevoir des notifications de ces règles après la suppression du tableau de bord. Pour en savoir plus sur la gestion des règles via la page Alertes de la console Google Cloud, consultez la page Gérer les règles d'alerte.

Pour supprimer un tableau de bord personnalisé, 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. Pour lancer la suppression, recherchez le tableau de bord que vous souhaitez supprimer, puis cliquez sur delete Supprimer.
3. Dans la boîte de dialogue de confirmation, cliquez sur Supprimer.
4. Pour enregistrer le tableau de bord modifié, cliquez sur Enregistrer dans la barre d'outils.

Enregistrer une définition de tableau de bord sur un système local

Vous avez peut-être créé un tableau de bord personnalisé que d'autres membres de votre équipe ou de votre organisation souhaitent installer dans leurs projets. Lorsque vous souhaitez partager une définition de tableau de bord, enregistrez-la sur votre système local, puis déplacez-la ou copiez-la vers un emplacement partagé. Par exemple, vous pouvez copier la définition sur un disque partagé ou dans un dépôt de code source tel que GitHub. Toute personne ayant accès à l'emplacement stocké peut installer le tableau de bord dans ses projets Google Cloud.

Pour enregistrer la définition d'un tableau de bord personnalisé dans un fichier au format JSON stocké sur votre système local, 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 barre d'outils du tableau de bord, cliquez sur settings Paramètres, sur JSON, puis sur Éditeur JSON.

3. Pour enregistrer la définition du tableau de bord sur un système local, cliquez sur Télécharger le fichier:

   Le fichier créé, qui porte le même nom que le tableau de bord, contient une représentation JSON du tableau de bord. Ce fichier ne stocke que la définition du tableau de bord, et non les données de série temporelle.

Partager un tableau de bord

Lorsque vous examinez une anomalie de données, vous pouvez demander à un autre membre de votre équipe ou de votre organisation de consulter les mêmes données que vous. Par exemple, vous pouvez constater une baisse ou un pic inattendus dans une métrique de performances et vous souhaitez consulter un collègue. Dans ce scénario, vous souhaitez que votre collègue affiche le tableau de bord et ses données.

Pour savoir comment partager un lien vers un tableau de bord, consultez la section Partager un tableau de bord personnalisé.

Configurer l'actualisation des données

Lorsque vous ouvrez un tableau de bord, l'actualisation automatique est désactivée. La barre d'outils affiche un bouton d'activation/de désactivation, sync_disabled, qui indique cet état.

Pour activer l'actualisation automatique de votre session en cours, accédez à la barre d'outils et sélectionnez sync_disabled Enable auto refresh (Activer l'actualisation automatique).

Pour désactiver l'actualisation automatique après l'avoir activée, accédez à la barre d'outils, puis sélectionnez sync (synchroniser) Disabled auto refresh (Désactiver l'actualisation automatique).

Activer l'enregistrement automatique des modifications de configuration

Par défaut, les tableaux de bord n'enregistrent pas vos modifications. Pour activer l'enregistrement automatique, cliquez sur le bouton Enregistrer automatiquement jusqu'à ce qu'il soit Activé. Lorsque cloud_done Cloud Done (Cloud terminé) est affiché, vos modifications ont été enregistrées.

Étape suivante

• Ajouter des graphiques et des tableaux
• Explorer les données représentées graphiquement
• Configurer un champ d'application des métriques pour plusieurs projets