Ajouter des filtres temporaires à un tableau de bord personnalisé

Ce document explique comment modifier les données affichées sur un tableau de bord personnalisé (sans avoir à modifier chaque widget) en ajoutant des regroupements temporaires et des filtres temporaires. Une fois que vous avez ajouté un regroupement ou un filtre au niveau du tableau de bord, la barre d'outils du tableau de bord affiche un élément de menu pour ce regroupement ou ce filtre.

Lors du dépannage, vous pouvez modifier les données affichées par un tableau de bord en ajoutant des regroupements ou des filtres temporaires. Par exemple, si vous enquêtez sur un incident et que vous souhaitez que le tableau de bord n'affiche que les données d'une machine virtuelle (VM) spécifique, ajoutez un filtre temporaire.

Les filtres et regroupements temporaires sont automatiquement supprimés lorsque vous actualisez la page. Toutefois, vous pouvez également les supprimer manuellement.

Pour en savoir plus sur la création de filtres permanents, consultez la section Ajouter des filtres permanents aux tableaux de bord personnalisés.

Fonctionnement des filtres des tableaux de bord

Un filtre de tableau de bord spécifie un libellé et une valeur. Les séries temporelles affichées par le tableau de bord déterminent les libellés disponibles pour le filtrage. La compatibilité d'un widget avec un filtre au niveau du tableau de bord dépend du type de données affichées par le widget et de sa configuration:

Pour les widgets qui affichent des données de séries temporelles, tels qu'un graphique en courbes, les règles suivantes s'appliquent:
- Si la série temporelle affichée par le widget n'est pas compatible avec le libellé d'un filtre, le filtre au niveau du tableau de bord ne modifie pas les données affichées.
  
  Par exemple, si vous ajoutez un filtre sur le libellé instance_id, mais qu'un graphique du tableau de bord n'affiche pas de données portant le libellé instance_id, le filtre ne modifie pas les données affichées.
- Si le widget spécifie une valeur pour un libellé, le filtre au niveau du tableau de bord ne modifie pas les données affichées.
  
  Par exemple, si vous ajoutez un filtre sur le libellé instance_id, mais qu'un graphique du tableau de bord inclut un filtre basé sur le libellé instance_id, le filtre au niveau du tableau de bord ne modifie pas les données affichées.
- Sinon, le graphique ne filtre les données affichées que pour les séries temporelles correspondant au filtre appliqué au tableau de bord.
Pour les widgets du panneau des journaux, les filtres à l'échelle du tableau de bord basés sur un libellé de ressource mettent à jour la requête. Par exemple, si vous ajoutez le filtre cluster_name: mycluster au niveau du tableau de bord, la requête est mise à jour pour inclure resource.labels."cluster_name"="mycluster".

Vous pouvez ajouter plusieurs filtres pour l'ensemble du tableau de bord. Ces filtres sont reliés par un opérateur logique ET.

Avant de commencer

Pour obtenir les autorisations dont vous avez besoin pour ajouter ou modifier des filtres temporaires à l'aide de la console Google Cloud, demandez à votre administrateur de vous attribuer le rôle IAM Lecteur Monitoring (roles/monitoring.viewer) 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.

Créer ou modifier des regroupements temporaires

Lorsque vous ajoutez des regroupements à l'échelle du tableau de bord, les widgets du tableau de bord affichent une série temporelle pour chaque ensemble de séries temporelles ayant les mêmes valeurs pour les libellés de regroupement. Par défaut, la moyenne de chaque ensemble est affichée. Toutefois, lorsque le widget définit une fonction de regroupement, celle-ci est utilisée.

Par exemple, supposons que votre tableau de bord contient un graphique qui affiche l'utilisation du processeur de vos instances de VM. Pour déterminer si vous devez déployer davantage de VM dans une zone particulière, vous pouvez modifier le tableau de bord et le graphique afin de changer ses options de regroupement. Vous pouvez également regrouper temporairement le tableau de bord par zone, puis afficher le graphique d'utilisation du processeur.

Pour créer ou modifier les regroupements temporaires, procédez comme suit:

Dans le panneau de navigation de la console Google Cloud, sélectionnez Surveillance, puis Tableaux de bord:
Accéder à la page Tableaux de bord
Développez le menu Grouper par , puis sélectionnez les libellés de regroupement.
Cliquez sur OK.

Lorsque vous quittez le tableau de bord, tous les regroupements que vous avez créés sont supprimés.

Créer un filtre temporaire

Lorsque vous enquêtez sur un incident, vous pouvez examiner les données de manière spécifique. Par exemple, vous pouvez n'afficher que les séries temporelles d'une machine virtuelle spécifique ou les ressources d'une région spécifique. Lorsque vous créez un filtre temporaire, tous les widgets du tableau de bord sont modifiés pour afficher les données correspondant à ce filtre. Par exemple, pour configurer tous les graphiques afin qu'ils n'affichent que les séries temporelles d'une instance de VM spécifique, créez un filtre basé sur le libellé instance_id. De même, pour configurer le tableau de bord afin qu'il n'affiche que les séries temporelles d'une zone spécifique, créez un filtre basé sur le libellé zone.

Pour créer un filtre temporaire, procédez comme suit:

Dans le panneau de navigation de la console Google Cloud, sélectionnez Surveillance, puis Tableaux de bord:
Accéder à la page Tableaux de bord
Dans la barre de filtre du tableau de bord, cliquez sur Ajouter un filtre, puis sélectionnez un libellé dans le menu.

Le menu liste les libellés de chaque série temporelle affichée sur le tableau de bord.

Une fois que vous avez sélectionné un libellé, un filtre est ajouté à la barre d'outils du tableau de bord. Le nom du filtre porte le même nom que votre sélection et sa valeur est définie sur *, ce qui correspond à toutes les valeurs. Par exemple, si vous sélectionnez zone, la barre d'outils affiche zone: *.
Pour sélectionner une valeur spécifique à faire correspondre, cliquez sur le filtre (par exemple, sur zone: *), puis sélectionnez une valeur dans le menu. Pour réduire le nombre d'options de menu, saisissez une partie de la valeur dans la zone Filtre .

Lorsque vous quittez le tableau de bord, tous les filtres que vous avez créés sont supprimés.

Ajouter des filtres temporaires correspondant à une série temporelle

Lorsque vous souhaitez obtenir plus d'informations sur une série temporelle spécifique affichée sur un graphique, vous pouvez appliquer des filtres temporaires à l'aide de la légende du graphique. Vous pouvez appliquer des filtres qui correspondent aux libellés spécifiques de la série temporelle, à la ressource de la série temporelle ou uniquement aux libellés de la métrique. Cette section décrit ces options.

Exemple de tableau de bord

Pour vous aider à décrire le comportement des différentes options, envisagez d'utiliser un tableau de bord affichant les métriques CPU utilization et Disk read bytes pour les instances de VM Compute Engine. La capture d'écran suivante montre ce tableau de bord pour un système:

Affichage de l'exemple de tableau de bord.

Filtrer en fonction de tous les libellés d'une série temporelle

Lorsque vous souhaitez appliquer l'ensemble de libellés le plus restrictif, filtrez tous les libellés. Avec cette option, les libellés identifient une ressource unique et un ensemble de valeurs unique pour les libellés de la métrique.

Pour appliquer des filtres temporaires qui identifient une série temporelle spécifique sur un graphique, procédez comme suit:

Dans le panneau de navigation de la console Google Cloud, sélectionnez Surveillance, puis Tableaux de bord:
Accéder à la page Tableaux de bord
Identifiez le graphique et développez la légende pour voir plus de détails en cliquant sur Développer la légende.
Faites défiler la légende jusqu'à ce que vous trouviez la série temporelle spécifique qui vous intéresse, cliquez sur Actions pour cette série temporelle, puis sélectionnez Filtrer le tableau de bord sur tous les libellés.

Par exemple, lorsque ces étapes sont appliquées au graphique qui affiche la métrique CPU utilization pour l'exemple de tableau de bord, les filtres suivants sont ajoutés :

Libellé de la métrique : instance_name.
Libellés de ressources pour les instances de VM Compute Engine :
- project_id
- instance_id
- zone

La capture d'écran suivante illustre le résultat :

Affichage de l'exemple de tableau de bord avec le filtrage en fonction de tous les libellés d'une série temporelle d'utilisation du processeur.

Dans la figure précédente, le graphique affichant la métrique CPU utilization montre une seule série temporelle. Ce comportement est dû au fait que vous avez ajouté des filtres correspondant aux libellés de séries temporelles. Cependant, le graphique affichant la métrique Disk read bytes affiche plusieurs séries temporelles. La métrique Disk read bytes contient trois libellés en plus du libellé instance_name. Il est donc possible que plusieurs séries temporelles de ce graphique fassent référence à la même instance.

À titre de comparaison, lorsque les étapes précédentes sont appliquées au graphique qui affiche la métrique Disk read bytes pour l'exemple de tableau de bord, les filtres suivants sont ajoutés :

Libellés de métriques :
- instance_name
- device_name
- storage_type
- device_type
Libellés de ressources pour les instances de VM Compute Engine :
- project_id
- instance_id
- zone

Affichage de l'exemple de tableau de bord avec le filtrage en fonction de tous les libellés d'une série temporelle d'octets lus sur le disque.

Comme le montre la capture d'écran précédente, les deux graphiques affichent désormais une seule série temporelle.

Filtrer en fonction des libellés de ressources d'une série temporelle

Lorsque vous filtrez selon tous les libellés de ressources, vous limitez le tableau de bord pour afficher les séries temporelles d'une ressource spécifique. Vous pouvez maintenant afficher les métriques de cette ressource uniquement, en éliminant temporairement de l'affichage les séries temporelles qui ne vous intéressent pas.

Pour appliquer des filtres temporaires qui identifient la ressource pour une série temporelle spécifique affichée par un graphique, procédez comme suit:

Dans le panneau de navigation de la console Google Cloud, sélectionnez Surveillance, puis Tableaux de bord:
Accéder à la page Tableaux de bord
Identifiez le graphique et développez la légende pour voir plus de détails en cliquant sur Développer la légende.
Faites défiler la légende jusqu'à ce que vous trouviez la série temporelle spécifique qui vous intéresse, cliquez sur Actions pour cette série temporelle, puis sélectionnez Filtrer le tableau de bord par libellé de ressource.

Par exemple, lorsque ces étapes sont effectuées sur le graphique qui affiche la métrique CPU utilization pour l'exemple de tableau de bord, trois filtres sont ajoutés. Ces filtres correspondent aux libellés de la ressource, à savoir une instance de VM :

Affichage de l'exemple de tableau de bord avec le filtrage en fonction des libellés de ressources d'une série temporelle d'utilisation du processeur.

Comme illustré dans la capture d'écran précédente, lorsque vous filtrez par ressource, un graphique peut afficher plusieurs séries temporelles.

Étant donné que l'option Filtrer le tableau de bord en fonction des libellés de ressources n'applique que les libellés de ressources à la barre de filtre temporaire, le résultat est le même lorsque vous sélectionnez cette option dans l'un ou l'autre des graphiques.

Filtrer en fonction des libellés de métriques d'une série temporelle

Cette option vous permet d'appliquer des filtres correspondant aux valeurs des libellés d'une métrique. Par exemple, lorsque vous consultez les métriques d'équilibrage de charge, vous pouvez afficher les séries temporelles qui concernent uniquement un protocole spécifique.

Pour appliquer des filtres temporaires qui identifient la métrique d'une série temporelle spécifique affichée par un graphique, procédez comme suit:

Dans le panneau de navigation de la console Google Cloud, sélectionnez Surveillance, puis Tableaux de bord:
Accéder à la page Tableaux de bord
Identifiez le graphique et développez la légende pour voir plus de détails en cliquant sur Développer la légende.
Faites défiler la légende jusqu'à ce que vous trouviez la série temporelle spécifique qui vous intéresse, cliquez sur Actions pour cette série temporelle, puis sélectionnez Filtrer le tableau de bord par libellé de métrique.

Par exemple, lorsque ces étapes sont effectuées sur le graphique qui affiche la métrique CPU utilization pour l'exemple de tableau de bord, un filtre basé sur le libellé instance_name est ajouté. Dans ce cas, il est possible que les deux graphiques affichent plusieurs séries temporelles, car la valeur du libellé instance_name est configurable. Autrement dit, vous pouvez définir plusieurs VM avec la même valeur pour le libellé instance_name.

À titre de comparaison, lorsque les étapes précédentes sont appliquées au graphique qui affiche la métrique Disk read bytes pour l'exemple de tableau de bord, quatre filtres sont ajoutés. Ces filtres correspondent aux libellés de la métrique Disk read bytes.

Lorsque vos filtres temporaires n'incluent que des filtres de métriques, des séries temporelles pour cette métrique s'affichent, quelle que soit la ressource sur laquelle la série a été écrite. Étant donné que vous ne limitez pas les séries temporelles à une ressource spécifique, plusieurs séries temporelles sont susceptibles de s'afficher sur un graphique. La capture d'écran précédente illustre ce comportement, car les deux graphiques affichent deux séries temporelles.

Modifier ou supprimer un filtre temporaire

Les filtres temporaires sont automatiquement supprimés lorsque vous quittez le tableau de bord. Pour supprimer manuellement un filtre temporaire, cliquez sur Supprimer.