Gérer les tableaux de bord personnalisés

Les tableaux de bord personnalisés sont des tableaux de bord que vous créez. Ces tableaux de bord vous permettent d'afficher les informations qui vous intéressent, organisées de manière utile. Pour créer des tableaux de bord personnalisés, vous pouvez utiliser Google Cloud Console ou l'API Cloud Monitoring.

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. Contrairement aux tableaux de bord spécifiques au service, vous pouvez effectuer les opérations suivantes à l'aide de tableaux de bord personnalisés :

  • Représenter graphiquement des métriques et afficher des entrées de journal de plusieurs projets Google Cloud.
  • Représenter graphiquement des métriques pour plusieurs services.
  • Afficher des règles d'alerte.

Vous pouvez également copier, modifier et partager des tableaux de bord personnalisés.

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

Par défaut, les tableaux de bord actualisent automatiquement leur affichage lorsque de nouvelles données sont disponibles. Ils enregistrent automatiquement vos modifications de configuration. Pour en savoir plus sur la modification de ces paramètres, consultez les sections Désactiver l'actualisation des données et Désactiver l'enregistrement automatique des modifications de configuration.

Avant de commencer

Pour afficher un tableau de bord, votre rôle IAM (Identity and Access Management) pour le projet de champ d'application d'un champ d'application de métriques doit inclure l'autorisation de lecteur.

Pour créer ou modifier un tableau de bord, votre rôle IAM pour le projet de champ d'application d'un champ d'application de métriques doit inclure l'autorisation d'éditeur.

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 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é

  1. Dans 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 changer 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 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 Edit dashboard (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 de vos règles, disponible sur la page Alertes dans Cloud Console, consultez la page Gérer les règles.

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

  1. Dans 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 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. Pour copier un tableau de bord, 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 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 Edit dashboard (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. Utilisez l'outil de sélection de projets Cloud Console 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.
    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 souhaitez partager un tableau de bord que vous avez créé avec d'autres projets Google Cloud ou avec d'autres personnes, vous pouvez enregistrer la définition du tableau de bord sur votre système local. Ce fichier peut être partagé et installé dans d'autres 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 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 Edit dashboard (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.

Installer un tableau de bord personnalisé partagé

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 la CLI Google Cloud, consultez la page Installer des exemples de tableaux de bord.

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

  1. Dans 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'exemple d'onglet 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