Cette page a été traduite par l'API Cloud Translation.

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. Pour Par exemple, vous pouvez créer un tableau de bord pour afficher les journaux, les métriques de performances, et des 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 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 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 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 configurer un champ d'application des métriques, votre tableau de bord pour afficher les données de métriques de plusieurs projets Google Cloud.

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

Vous pouvez améliorer le temps de chargement ou la convivialité d'un tableau de bord en regrouper 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 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 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 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'elles 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 pourriez Ajoutez l'étiquette 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 aux tableaux de bord contenant l'étiquette sélectionnée.

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 définir le même tableau de bord personnalisé. Pour cette situation, vous pouvez créer le tableau de bord dans un projet, puis le copier à d'autres projets. Vous pouvez également Téléchargez la définition du tableau de bord sur votre système local. puis installez 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 :

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.
Sur la page Dashboards (Tableaux de bord), cliquez sur Create custom dashboard (Créer un tableau de bord personnalisé).
Pour ajouter des widgets à votre tableau de bord, procédez comme suit:
1. Dans la barre d'outils du tableau de bord, cliquez sur 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 et puis définissez la visualisation sur Aire empilée. Vous pouvez également sélectionner Zone empilée, puis sélectionnez la métrique.
3. Configurez le widget.
4. Pour appliquer vos modifications au tableau de bord, dans la barre d'outils, cliquez sur Appliquer. Pour supprimer vos modifications, cliquez sur Annuler.
  
  Une fois le widget ajouté à votre tableau de bord, vous pouvez modifier sa configuration.
Pour enregistrer le tableau de bord modifié, cliquez sur Enregistrer dans la barre d'outils.
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 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 son nom 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 étiquettes à ajouter à votre tableau de bord, cliquez sur Sélectionner les libellés à appliquer, sélectionnez les libellés souhaités, puis cliquez sur OK.
3. Pour enregistrer vos modifications, cliquez sur Confirmer.

Copier un tableau de bord

Pour tester différentes métriques ou agrégations vous pouvez copier un tableau de bord, puis utiliser le nouveau tableau de bord à des fins d'expérimentation.

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

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.
Sur la page Aperçu des tableaux de bord, identifiez le tableau de bord à copier, puis cliquez sur Copier le tableau de bord.
Facultatif : Modifiez le nom du tableau de bord.
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 plus d'informations 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 : suivantes:

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.
Copiez la définition du tableau de bord dans votre presse-papiers :
1. Dans la barre d'outils du tableau de bord, cliquez sur Paramètres. puis sur JSON et enfin sur Éditeur JSON.
2. Dans la barre d'outils de l'éditeur, cliquez sur Copier.
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 Paramètres. Cliquez 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 tableaux de bord spécifiques à chaque service créés par Cloud Monitoring lorsque vous ajoutez des ressources à votre projet Google Cloud.

Pour afficher un tableau de bord :

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.
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 GCP. 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 en fonction des champs de tableau de bord suivants: nom, la description, le type et l'étiquette définie par l'utilisateur.
    2. Saisissez une valeur pour le filtre ou effectuez une sélection dans le menu.
  - Pour répertorier les tableaux de bord sans graphiques, procédez comme suit : sélectionnez Filtrer les tableaux de bord, Libellés, puis sélectionnez (Empty) (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.
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 :

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.
Dans la liste des tableaux de bord, recherchez le tableau de bord, puis cliquez sur Sélectionner.
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 son nom 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 étiquettes à ajouter à votre tableau de bord, cliquez sur Sélectionner les libellés à appliquer, sélectionnez les libellés souhaités, puis cliquez sur OK.
Pour enregistrer vos modifications, cliquez sur Confirmer.

Ajouter ou supprimer des filtres

Une fois que vous avez créé un tableau de bord, vous pouvez ajouter des filtres à l'ensemble du tableau de bord qui s'appliquent à tous les widgets 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.

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.
Localisez et sélectionnez le tableau de bord.
- Pour ajouter un filtre à l'ensemble du tableau de bord qui s'applique uniquement à votre utilisez la barre de filtre 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 à Paramètres, 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 la disposition des vous pouvez effectuer l'une des opérations suivantes:

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.
Recherchez et sélectionnez le tableau de bord.
(Facultatif) Pour ajouter un widget à votre tableau de bord, dans la barre d'outils du tableau de bord, cliquez sur Ajouter un widget, puis sélectionnez et configurez le widget. Pour appliquer vos modifications au tableau de bord, dans la barre d'outils, cliquez sur Appliquer. Pour supprimer vos modifications, cliquez sur Annuler.

Pour en savoir plus, consultez les pages suivantes :
Facultatif : Pour modifier un widget, procédez comme suit :
- Placez le pointeur sur le widget pour activer dans la barre d'outils, cliquez sur 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 remplacer un graphique linéaire par un graphique en aires empilées, cliquez sur Graphique en courbes , 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 Paramètres , puis sur JSON. puis cliquez 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 modifier le widget, dans la barre d'outils des widgets, puis en cliquant sur Afficher le code
Facultatif : Pour supprimer un widget, placez votre pointeur dessus afin d'activer la barre d'outils, puis effectuez l'une des opérations suivantes :
- Si la barre d'outils du widget affiche un Supprimer, puis cliquez dessus.
- Sinon, cliquez sur Plus d'options, puis sur sélectionnez Supprimer le widget.
Pour appliquer vos modifications au tableau de bord, dans la barre d'outils, cliquez sur Appliquer. Pour supprimer vos modifications, cliquez sur Annuler.
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.
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.
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 n'entraîne pas la suppression 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 :

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.
Pour lancer la suppression, recherchez le tableau de bord que vous souhaitez supprimer, puis cliquez sur Supprimer.
Dans la boîte de dialogue de confirmation, cliquez sur Supprimer.
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é d'autres membres de votre équipe ou de votre organisation veulent 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 leurs 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:

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.
Dans la barre d'outils du tableau de bord, cliquez sur Paramètres, sur JSON, puis sur Éditeur JSON.
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.

Lorsque vous enquêtez sur une anomalie de données, vous voudrez peut-être qu'une autre personne de votre équipe ou de votre organisation pour consulter les mêmes données que celles que vous consultez. 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 voulez que votre collègue puisse voir 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 indiquant si l'actualisation automatique est activé () ou désactivé (). Pour modifier l'état, cliquez sur le bouton.

Activer l'enregistrement automatique des modifications de configuration

Par défaut, vos modifications ne sont pas enregistrées dans les tableaux de bord. Pour activer l'enregistrement automatique, cliquez sur le bouton Enregistrer automatiquement jusqu'à ce qu'il soit Activé. Lorsque Cloud Terminé s'affiche, vos modifications ont été enregistrées.