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, en les organisant comme bon vous semble. 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 des machines virtuelles (VM) de 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, 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 plus d'informations sur l'API et la Google Cloud CLI, consultez la page Créer et gérer des tableaux de bord à l'aide de l'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. Vous pouvez donc 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 journal 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 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 qui est 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 ou à certains widgets du tableau de bord. 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 des données provenant 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'ils affichent. Par exemple, vous pouvez ajouter l'étiquette
prod
aux tableaux de bord qui affichent des informations sur les systèmes de production. De même, vous pouvez ajouter l'étiquettestaging
pour indiquer que le tableau de bord affiche des informations sur les systèmes de préproduction.Lorsque vous affichez vos tableaux de bord, vous pouvez sélectionner un libellé pour filtrer la liste en fonction des 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 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 à 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 cette situation, 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 l'installer 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
.
Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Surveillance.
- Sur la page Tableaux de bord, cliquez sur Créer un tableau de bord personnalisé.
Pour ajouter des widgets à votre tableau de bord, procédez comme suit:
- Dans la barre d'outils du tableau de bord, cliquez sur add Ajouter un widget.
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.
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.
Une fois le widget ajouté à votre tableau de bord, vous pouvez modifier sa configuration.
Pour enregistrer votre tableau de bord modifié, cliquez sur Enregistrer dans la barre d'outils.
Facultatif: Ajoutez des étiquettes à votre tableau de bord:
- Dans la liste des tableaux de bord, localisez le tableau de bord, puis cliquez sur check_box_outline_blank 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 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 étiquettes à ajouter à votre tableau de bord, cliquez sur arrow_drop_down Sélectionner les étiquettes à appliquer, sélectionnez les étiquettes, puis cliquez sur OK.
- 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:
-
Dans la console Google Cloud, accédez à 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 Surveillance.
- 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.
- Facultatif: Mettez à jour 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 en savoir plus sur les rôles, consultez la page 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:
-
Dans la console Google Cloud, accédez à 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 Surveillance.
Copiez la définition du tableau de bord dans votre presse-papiers:
- Dans la barre d'outils du tableau de bord, cliquez sur Paramètres settings, sur JSON, puis sur Éditeur JSON.
- Dans la barre d'outils de l'éditeur, cliquez sur content_copy Copier.
Collez la définition dans un tableau de bord créé dans un projet différent:
- 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.
- Cliquez sur Créer un tableau de bord personnalisé.
- Dans la barre d'outils du tableau de bord, cliquez sur Paramètres settings, sur JSON, puis sur Éditeur JSON.
- Collez le contenu de votre presse-papiers dans l'éditeur.
- Cliquez sur Appliquer les modifications.
- 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 afficher.
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 que Cloud Monitoring crée lorsque vous ajoutez des ressources à votre projet Google Cloud.
Pour afficher un tableau de bord, procédez comme suit:
-
Dans la console Google Cloud, accédez à 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 Surveillance.
La page Mes tableaux de bord répertorie tous les tableaux de bord de votre projet Google Cloud.
Pour trouver un tableau de bord, effectuez l'une des opérations suivantes:
Utilisez la barre Filtrer pour effectuer une recherche par nom complet ou partiel du tableau de bord, ou pour filtrer par type.
Sélectionnez une catégorie. Pour affiner davantage la liste, utilisez la barre Filtre.
Sélectionnez le libellé pour répertorier 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
les joint.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 pouvez déterminer qu'il doit être modifié pour qu'il vous soit 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. En outre, vous pouvez ajouter des libellés à un tableau de bord, soit pour faciliter la recherche, soit pour indiquer le type de contenu du tableau de bord.
Ajouter ou supprimer des libellés
Pour ajouter ou supprimer des libellés, procédez comme suit:
-
Dans la console Google Cloud, accédez à 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 Surveillance.
- Dans la liste des tableaux de bord, localisez le tableau de bord, puis cliquez sur check_box_outline_blank 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 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 étiquettes à ajouter à votre tableau de bord, cliquez sur arrow_drop_down Sélectionner les étiquettes à appliquer, sélectionnez les étiquettes, puis cliquez sur OK.
- Pour enregistrer vos modifications, cliquez sur Confirmer.
Ajouter ou supprimer des filtres
Après avoir créé un tableau de bord, vous pouvez y ajouter des filtres à l'échelle du tableau de bord qui s'appliquent à tous les widgets 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.
-
Dans la console Google Cloud, accédez à 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 Surveillance.
Localisez et sélectionnez le tableau de bord.
Pour ajouter un filtre à l'échelle du tableau de bord qui ne s'applique qu'à votre session actuelle, 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, 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, effectuez l'une des opérations suivantes:
-
Dans la console Google Cloud, accédez à 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 Surveillance.
- Localisez et sélectionnez le tableau de bord.
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 Appliquer dans la barre d'outils. Pour supprimer vos modifications, cliquez sur Annuler.
Pour en savoir plus, consultez les pages suivantes :
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 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 convertir 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 Paramètres settings, puis sur JSON, puis sur Éditeur JSON. Si vous modifiez le fichier JSON, vous devez cliquer sur Apply changes (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.
Facultatif: Pour supprimer un widget, placez votre pointeur dessus 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 , cliquez dessus.
- Sinon, cliquez sur Plus d'options more_vert, 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.
Facultatif: Pour repositionner un widget, faites-le glisser vers un nouvel emplacement à l'aide de votre pointeur à l'aide de son en-tête. 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 afin de repositionner le coin droit du 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 ne pouvez pas redimensionner les widgets lorsqu'un tableau de bord est en mode Grille.
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 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 plus d'informations sur la gestion des règles à partir de la page Alertes de la console Google Cloud, consultez la section 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
.
Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Surveillance.
- 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é 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:
-
Dans la console Google Cloud, accédez à 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 Surveillance.
- Dans la barre d'outils du tableau de bord, cliquez sur Paramètres settings, sur JSON, puis sur Éditeur JSON.
Pour enregistrer la définition du tableau de bord sur un système local, cliquez sur
File Download (Télécharger un fichier) :
Le fichier créé, portant 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. Il ne stocke pas de données de séries temporelles.
Partager un tableau de bord
Lorsque vous examinez une anomalie dans les données, vous souhaitez peut-être qu'un autre membre de votre équipe ou de votre organisation consulte les mêmes données que vous. Par exemple, vous pouvez constater une baisse ou un pic inattendu d'une métrique de performances et vous souhaitez consulter un coéquipier. Dans ce scénario, vous souhaitez que votre collègue puisse consulter 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é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, vos modifications ne sont pas enregistrées dans les tableaux de bord. Pour activer l'enregistrement automatique, cliquez sur le bouton Enregistrement automatique jusqu'à ce que la position soit activée. 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