Créez et gérez 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 à vous être 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) de 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 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 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 divers types de widgets, ce qui vous permet de 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 :
• Les entrées de journal 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 la facilité d'utilisation d'un tableau de bord en regroupant les 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.

Après avoir créé un tableau de bord, vous pouvez ajouter des filtres, des événements ou des libellés:

• Les filtres à l'échelle du tableau de bord s'appliquent à tous les widgets du tableau de bord ou à certains d'entre eux. Ces filtres peuvent être utiles lors du 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 Ajouter ou supprimer des filtres.

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

• Les libellés peuvent vous aider à localiser les 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 en fonction des 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 attribuer le rôle IAM Éditeur Monitoring (roles/monitoring.editor) sur votre projet. Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

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 page Contrôler les accès avec Identity and Access Management.

Ajouter un tableau de bord personnalisé à votre projet

Il existe 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 à l'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 la définition du tableau de bord 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édez à Tableaux de bord.

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

2. Sur la page Tableaux de bord, cliquez sur 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 manière 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 Zone empilée. Vous pouvez également sélectionner le widget Zone empilée, puis sélectionner la métrique.

   3. Configurez le widget.

   4. Pour appliquer vos modifications au tableau de bord, cliquez sur Apply (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 votre 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, localisez le tableau de bord, puis cliquez sur check_box_outline_blank Sélectionner.
   2. Dans la barre d'outils, cliquez sur Libellés, puis effectuez l'une des opérations suivantes :

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

        Le libellé est créé et ajouté à 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 options d'agrégation, vous pouvez copier un tableau de bord, puis l'utiliser à 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édez à Tableaux de bord.

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

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: Mettez à jour 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 "É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édez à Tableaux de bord.

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

2. Copiez la définition du tableau de bord dans le presse-papiers:

   1. Dans la barre d'outils du tableau de bord, cliquez sur Paramètres settings, 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 le sélecteur de projet de la console Google Cloud pour choisir 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 Paramètres settings, puis sur JSON et Éditeur JSON.
   4. Collez le contenu de votre presse-papiers dans l'éditeur.
   5. Cliquez sur Appliquer les modifications.
   6. Pour enregistrer votre 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, par exemple, fournit un ensemble organisé de définitions de tableaux 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.

Après avoir importé une définition de tableau de bord, vous pouvez la modifier pour afficher les données que vous souhaitez consulter.

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 à un service créés par Cloud Monitoring lorsque vous ajoutez des ressources à votre projet Google Cloud.

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

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

   Accédez à Tableaux de bord.

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

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

2. Pour trouver un tableau de bord, effectuez l'une des opérations suivantes:

   • Utilisez la barre Filtre pour effectuer une recherche par nom complet ou partiel du tableau de bord, ou pour filtrer par type de tableau de bord.

   • Sélectionnez une catégorie. Pour affiner davantage la liste, utilisez la barre Filtre.

   • Sélectionnez le libellé pour afficher uniquement les tableaux de bord qui le contiennent. Pour affiner davantage la liste, utilisez la barre Filtre.

   Pour réduire le nombre de résultats affichés, utilisez la barre Filtre. Lorsque vous ajoutez plusieurs filtres et que vous n'incluez pas l'opérateur OR entre deux filtres, un opérateur logique AND joint les filtres.

3. Après avoir localisé le tableau de bord, sélectionnez-le.

Modifier un tableau de bord

Après avoir créé un tableau de bord, vous constaterez peut-être 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 modifier la façon dont un widget affiche les données. Vous pouvez également ajouter des libellés à un tableau de bord, soit pour le trouver plus facilement, soit pour indiquer le type de contenu qu'il contient.

Ajouter ou supprimer des libellés

Pour ajouter ou supprimer des libellés, procédez comme suit:

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

   Accédez à Tableaux de bord.

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

2. Dans la liste des tableaux de bord, localisez le tableau de bord, puis cliquez sur check_box_outline_blank Sélectionner.
3. Dans la barre d'outils, cliquez sur Libellés, puis effectuez l'une des opérations suivantes :

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

     Le libellé est créé et ajouté à 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

Après avoir créé un tableau de bord, vous pouvez ajouter des filtres à l'échelle du tableau de bord qui s'appliquent à tous les widgets du tableau de bord ou à certains d'entre eux. Ces filtres peuvent être utiles lors du dépannage. Par exemple, vous pouvez utiliser ces filtres pour n'afficher que les données d'une zone spécifique.

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

   Accédez à Tableaux de bord.

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

2. Recherchez et sélectionnez le tableau de bord.

   • Pour ajouter un filtre au niveau 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 au tableau de bord, accédez à Paramètres settings dans la barre d'outils du tableau de bord, puis sélectionnez Gérer les filtres. Pour en savoir plus, consultez la section Filtres permanents.

Modifier les widgets ou la mise en page

Pour modifier les widgets d'un tableau de bord ou sa mise en page, procédez de l'une des façons suivantes:

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

   Accédez à Tableaux de bord.

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

2. Recherchez et sélectionnez le tableau de bord.

3. Facultatif: Pour ajouter un widget à votre tableau de bord, cliquez sur add Ajouter un widget dans la barre d'outils du tableau de bord, puis sélectionnez et configurez le widget. Pour appliquer vos modifications au tableau de bord, cliquez sur Apply (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 des graphiques d'alerte et des incidents
   • Afficher les journaux
   • Afficher les SLO
   • Ajouter du texte et des groupes

4. Facultatif: Pour modifier un widget, effectuez l'une des opérations suivantes:

   • 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 Apply (Appliquer) dans la barre d'outils. Pour supprimer vos modifications, cliquez sur Annuler.

     Vous pouvez modifier la plupart des paramètres d'un widget, y compris son type. Par exemple, pour remplacer un graphique en courbes par un 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, puis sur JSON et enfin sur Éditeur JSON. Si vous modifiez le fichier JSON, vous devez cliquer sur Apply changes (Appliquer les modifications).

     Vous pouvez également accéder au JSON d'un widget en modifiant le widget, 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 pour activer la barre d'outils, puis effectuez l'une des opérations suivantes:

   • Si la barre d'outils du widget affiche un bouton Supprimer delete, 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 Apply (Appliquer) dans la barre d'outils. Pour supprimer vos modifications, cliquez sur Annuler.

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

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

7. Facultatif: Pour redimensionner un widget, utilisez votre pointeur pour repositionner le coin droit du widget. Pour appliquer vos modifications au tableau de bord, cliquez sur Apply (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 votre 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 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 à partir de 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édez à Tableaux de bord.

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

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 votre 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 ou copiez la définition vers 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 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édez à Tableaux de bord.

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

2. Dans la barre d'outils du tableau de bord, cliquez sur Paramètres settings, puis sur JSON et Éditeur JSON.

3. Pour enregistrer la définition du tableau de bord sur un système local, cliquez sur File Download (Téléchargement de fichier) :

   Le fichier créé, qui porte le même nom que le tableau de bord, contient une représentation JSON de celui-ci. Ce fichier ne stocke que la définition du tableau de bord, pas les données de séries temporelles.

Partager un tableau de bord

Lorsque vous examinez une anomalie dans vos données, vous pouvez souhaiter qu'un autre membre de votre équipe ou de votre organisation consulte les mêmes données que celles que vous consultez. Par exemple, vous pouvez constater une baisse ou un pic inattendu dans une métrique de performances et vous souhaitez consulter un collègue. Dans ce scénario, vous souhaitez que votre collègue consulte le tableau de bord et ses données.

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

Configurer l'actualisation des données

La barre d'outils du tableau de bord affiche un bouton qui indique si l'actualisation automatique est activée (autorenew) ou désactivée (). Pour modifier l'état, cliquez sur le bouton.

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 Enregistrement automatique jusqu'à ce que soit activé. Lorsque cloud_done Cloud Done s'affiche, vos modifications ont été enregistrées.

Étapes suivantes

• 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