Gérer les tableaux de bord personnalisés

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Ce document explique comment créer et gérer des tableaux de bord personnalisés à l'aide de Google Cloud Console. Les tableaux de bord personnalisés vous permettent d'afficher les informations qui vous intéressent, organisées de manière à vous être utiles. 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. Après avoir créé un tableau de bord personnalisé, vous pouvez également le copier, le modifier et le partager. Pour créer des tableaux de bord personnalisés, vous pouvez utiliser Google Cloud Console, l'API Cloud Monitoring ou Google Cloud CLI.

Les tableaux de bord personnalisés sont compatibles avec différents types de widgets, ce qui vous permet de choisir la meilleure façon d'afficher vos données de métriques. Ces tableaux de bord vous permettent également d'afficher les données de métriques de plusieurs projets Google Cloud et les métriques de plusieurs services Google Cloud. En plus des métriques, les tableaux de bord personnalisés peuvent afficher les entrées de journal de plusieurs projets Google Cloud et les règles d'alerte, et vous pouvez créer des variables de modèle pour filtrer votre tableau de bord.

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

Avant de commencer

Assurez-vous que votre rôle Identity and Access Management inclut les autorisations nécessaires:

  • Pour obtenir les autorisations nécessaires pour afficher les tableaux de bord, demandez à votre administrateur de vous attribuer le rôle Lecteur de surveillance (roles/monitoring.viewer).
  • Pour obtenir les autorisations nécessaires pour créer et modifier des tableaux de bord, ainsi que pour modifier des tableaux de bord, demandez à votre administrateur de vous attribuer le rôle Éditeur Monitoring (roles/monitoring.editor).

Pour en savoir plus sur les rôles, consultez la page Contrôle des accès.

Créer un tableau de bord personnalisé

  1. Dans Google Cloud Console, sélectionnez Monitoring ou cliquez sur le bouton suivant :
    Accéder à Monitoring
  2. Dans le volet de navigation, sélectionnez Tableaux de bord.
  3. Sur la page Dashboards Overview (Aperçu des tableaux de bord), cliquez sur Create dashboard (Créer un tableau de bord).
  4. Pour chaque widget que vous souhaitez ajouter au tableau de bord, procédez comme suit :

    1. Sélectionnez un widget dans la bibliothèque de graphiques ou faites-le glisser de la bibliothèque vers la zone du graphique.

      Un widget préconfiguré du type sélectionné s'affiche. L'exemple suivant montre un graphique en courbes et son volet de configuration :

      Exemple de graphique en courbes.

    2. Pour modifier la série temporelle affichée par le widget, sélectionnez la configuration du type que vous souhaitez effectuer, puis remplissez le formulaire. Par exemple, pour réduire le nombre de champs que vous devez remplir, sélectionnez l'onglet De base, puis utilisez les menus de cet onglet pour configurer le widget. Pour en savoir plus sur les choix disponibles, consultez la section Ajouter des widgets au tableau de bord.

Afficher un tableau de bord personnalisé

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

Pour afficher un tableau de bord personnalisé, procédez comme suit :

  1. Dans Google Cloud Console, sélectionnez Monitoring ou cliquez sur le bouton suivant :
    Accéder à Monitoring
  2. Dans le volet de navigation, sélectionnez Tableaux de bord.
  3. Sélectionnez le nom du tableau de bord. Vous pouvez limiter la liste aux tableaux de bord personnalisés en ajoutant le filtre Type : Personnalisé.
  4. Si le bouton Fermer l'éditeur s'affiche, cliquez dessus.
  5. Facultatif: Ajoutez ou modifiez les filtres du tableau de bord pour modifier temporairement la série temporelle affichée par les widgets du tableau de bord. Pour en savoir plus, consultez Filtrer un tableau de bord.

  6. Facultatif: modifiez la période d'affichage de tous les widgets du tableau de bord. Par défaut, le sélecteur de temps est défini sur une heure. Pour les tableaux de bord affichant des données éparses, telles que des métriques de quota, définissez le sélecteur de période sur au moins une semaine.

  7. Facultatif: modifiez la configuration de chaque widget sur un tableau de bord à l'aide des options Paramètres du tableau de bord. Ces options vous permettent, par exemple, d'afficher ou de masquer les légendes.

Modifier un tableau de bord personnalisé

Modifiez un tableau de bord lorsque vous souhaitez ajouter ou supprimer des widgets, modifier la disposition des widgets du tableau de bord, modifier le type d'un widget ou modifier la série temporelle affichée par un widget.

Pour modifier un tableau de bord personnalisé, procédez comme suit :

  1. Dans Google Cloud Console, sélectionnez Monitoring ou cliquez sur le bouton suivant:
    Accéder à Monitoring
  2. Dans le volet de navigation, sélectionnez Tableaux de bord, puis choisissez le tableau de bord que vous souhaitez afficher ou modifier.
  3. Si le bouton Modifier le tableau de bord s'affiche, cliquez dessus.
  4. Modifiez le tableau de bord en effectuant l'une des opérations suivantes :

    • Pour ajouter un widget, cliquez sur Add chart (Ajouter un graphique), sélectionnez le widget qui vous intéresse et renseignez la boîte de dialogue. Pour en savoir plus, consultez la section Ajouter des widgets au tableau de bord.

    • Pour modifier la série temporelle affichée par un widget existant, sélectionnez ce widget, puis effectuez vos modifications à l'aide du volet de configuration du widget. Pour en savoir plus sur la configuration d'un widget, consultez la section Ajouter des widgets au tableau de bord.

    • Pour modifier un widget ou le tableau de bord en modifiant la représentation JSON, cliquez sur Éditeur JSON. Une fois les modifications effectuées, cliquez sur Appliquer les modifications dans la barre d'outils de l'éditeur.

      Lorsque vous ouvrez l'éditeur JSON après avoir sélectionné un widget, l'éditeur ne développe que la représentation de ce widget. Pour afficher la définition complète du tableau de bord, sélectionnez Afficher plus dans l'éditeur JSON :

      Illustrez le bouton de développement dans l'éditeur JSON.

    • Pour modifier le type d'un widget, cliquez sur le nom du widget actuel, puis effectuez une sélection dans le menu. Par exemple, pour modifier un graphique en courbes en graphique en aires empilées, cliquez sur Graphique en courbes et sélectionnez Graphique en aires empilées dans le menu. Pour en savoir plus, consultez la section Modifier le type d'un widget.

    • Pour supprimer un widget, cliquez sur Supprimer dans la barre d'outils du widget.

    • Pour redimensionner ou repositionner un widget, utilisez votre pointeur. Ces options sont désactivées lorsqu'un tableau de bord est en mode grille.

    • Pour modifier la disposition des widgets sur le tableau de bord, utilisez le bouton Grille et Mosaïque. Lorsque vous sélectionnez Grille, tous les widgets ont les mêmes dimensions.

Supprimer un tableau de bord personnalisé

La suppression d'un tableau de bord contenant des graphiques d'alerte ne supprime pas les règles d'alerte dont les données étaient affichées sur ces graphiques d'alerte. 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, accessible à partir de la page Alertes de Google Cloud Console, consultez la page Gérer les règles.

Pour supprimer un tableau de bord personnalisé, procédez comme suit :

  1. Dans Google Cloud Console, sélectionnez Monitoring ou cliquez sur le bouton suivant :
    Accéder à Monitoring
  2. Dans le volet de navigation, sélectionnez Tableaux de bord.
  3. Pour lancer la suppression, recherchez le tableau de bord que vous souhaitez supprimer, puis cliquez sur Supprimer.
  4. Dans la boîte de dialogue de confirmation, cliquez sur Supprimer.

Dupliquer un tableau de bord personnalisé au sein du même projet

Lorsque vous souhaitez tester différentes métriques ou différentes options d'agrégation, une option consiste à dupliquer un tableau de bord et à utiliser la copie à des fins de test.

Pour dupliquer un tableau de bord, procédez comme suit :

  1. Dans Google Cloud Console, sélectionnez Monitoring ou cliquez sur le bouton suivant:
    Accéder à Monitoring
  2. Dans le volet de navigation, sélectionnez Tableaux de bord.
  3. Sur la page Dashboards Overview (Aperçu des tableaux de bord), identifiez le tableau de bord à copier, puis cliquez sur Copier.
  4. Cliquez sur Copier dans la boîte de dialogue de confirmation.

Copier un tableau de bord personnalisé dans un autre projet

Lorsque vous avez plusieurs projets Cloud et que vous souhaitez qu'ils disposent du même tableau de bord personnalisé, vous pouvez créer le tableau de bord dans un projet, puis le copier dans d'autres projets. La copie a la même disposition et les mêmes propriétés que le tableau de bord source. Cependant, les données qu'elle affiche sont différentes.

Pour copier un tableau de bord d'un projet à un autre, votre rôle IAM pour les projets Cloud de destination doit inclure l'autorisation d'éditeur Monitoring. Pour en savoir plus sur les rôles, consultez la page Contrôle des accès.

Pour copier une définition de tableau de bord dans un autre projet Cloud, procédez comme suit :

  1. Dans Google Cloud Console, sélectionnez Monitoring ou cliquez sur le bouton suivant:
    Accéder à Monitoring
  2. Dans le volet de navigation, sélectionnez Tableaux de bord, puis choisissez le tableau de bord que vous souhaitez afficher ou modifier.
  3. Copiez la définition du tableau de bord dans votre presse-papiers:

    1. Si le bouton Modifier le tableau de bord s'affiche, cliquez dessus.
    2. Dans la barre d'outils du tableau de bord, cliquez sur Éditeur JSON pour ouvrir l'éditeur JSON.
    3. Dans la barre d'outils de l'éditeur, cliquez sur Copier.
  4. Collez la définition dans un tableau de bord créé dans un projet différent:

    1. À l'aide du sélecteur de projet Google Cloud Console, sélectionnez le projet dans lequel vous souhaitez enregistrer la définition du tableau de bord.
    2. Cliquez sur Créer un tableau de bord.
    3. Dans la barre d'outils du tableau de bord, cliquez sur Éditeur JSON pour ouvrir l'éditeur JSON.
    4. Collez le contenu de votre presse-papiers dans l'éditeur.
    5. Cliquez sur Appliquer les modifications.

Partager un tableau de bord personnalisé

Lorsque vous examinez une anomalie concernant des données, vous souhaiterez peut-être qu'un autre membre de votre équipe ou de votre organisation affiche un tableau de bord personnalisé. Par exemple, vous pouvez observer une baisse (ou un pic) attendue d'une métrique de performance que vous souhaitez consulter avec un collègue. Dans ce scénario, vous souhaitez que votre collègue voit le tableau de bord et ses données. Pour savoir comment accorder à une autre personne l'autorisation d'afficher un tableau de bord dans votre projet Google Cloud, consultez Accorder l'accès à Cloud Monitoring.

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 dans un emplacement partagé. Par exemple, vous pouvez copier la définition dans un Drive 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 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 Google Cloud Console, sélectionnez Monitoring ou cliquez sur le bouton suivant :
    Accéder à Monitoring
  2. Dans le volet de navigation, sélectionnez Tableaux de bord, puis choisissez le tableau de bord que vous souhaitez afficher ou modifier.
  3. Si le bouton Modifier le tableau de bord s'affiche, cliquez dessus.
  4. Dans la barre d'outils du tableau de bord, cliquez sur Éditeur JSON pour ouvrir l'éditeur JSON.
  5. Pour enregistrer la définition du tableau de bord sur un système local, cliquez sur Télécharger le fichier:

    Le fichier créé, nommé pour 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. Il ne stocke pas les données des séries temporelles.

Installer une définition de tableau de bord personnalisé

Pour utiliser ou personnaliser un tableau de bord créé par un autre utilisateur, installez la définition de ce tableau de bord dans votre projet Cloud. 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. Vous pouvez installer ces définitions dans votre projet Cloud en tant que tableaux de bord personnalisés, puis les modifier pour afficher les données souhaitées.

Pour savoir comment installer un tableau de bord à l'aide de l'API Cloud Monitoring ou de Google Cloud CLI, consultez Installer des exemples de tableaux de bord.

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

  1. Dans Google Cloud Console, sélectionnez Monitoring ou cliquez sur le bouton suivant:
    Accéder à Monitoring

  2. Dans le volet de navigation, sélectionnez Tableaux de bord, puis 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 de l'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

        Remarque : Certaines des définitions de tableaux de bord stockées dans le dépôt GitHub affichent des données de métriques personnalisées. Pour installer ces tableaux de bord, vous devez créer les métriques personnalisées nécessaires. Pour en savoir plus, consultez la documentation par service du dépôt.

      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.

Désactiver l'actualisation des données

Lorsqu'une anomalie de données s'affiche sous forme de graphique, vous pouvez conserver la vue actuelle pendant que vous examinez l'anomalie. Par défaut, les tableaux de bord actualisent automatiquement l'affichage à mesure que de nouvelles données sont disponibles.

Pour arrêter l'actualisation automatique du tableau de bord, cliquez sur le bouton d'actualisation automatique jusqu'à ce que le message Désactivé s'affiche.

Pour activer l'actualisation automatique du tableau de bord, cliquez sur le bouton d'actualisation automatique jusqu'à ce que le message Activé s'affiche.

Désactiver l'enregistrement automatique des modifications de configuration

Par défaut, les tableaux de bord sont configurés pour enregistrer vos modifications au fur et à mesure. Toutefois, lorsque vous souhaitez effectuer des tests ou configurer un tableau de bord en modifiant la représentation JSON, vous pouvez utiliser un processus manuel pour enregistrer vos modifications.

Pour enregistrer manuellement les modifications que vous apportez, procédez comme suit :

  1. Cliquez sur le bouton Enregistrer automatiquement jusqu'à ce que le bouton Enregistrer s'affiche.
  2. Apportez vos modifications au tableau de bord.
  3. Pour conserver vos modifications, cliquez sur Enregistrer.

Pour activer l'enregistrement automatique de vos modifications de configuration, assurez-vous que le bouton Enregistrer automatiquement est activé. Lorsque Cloud done (Cloud terminé) est affiché, vos modifications ont été enregistrées.

Étapes suivantes