Ajouter des filtres temporaires à un tableau de bord personnalisé

Ce document explique comment modifier les données affichées dans un tableau de bord personnalisé sans avoir à modifier chaque widget. Pour ce faire, ajoutez des groupements temporaires et des filtres temporaires. Une fois que vous avez ajouté un regroupement ou un filtre à l'ensemble du tableau de bord, la barre d'outils du tableau de bord affiche un élément de menu pour ce regroupement ou ce filtre.

Lorsque vous résolvez des problèmes, vous pouvez modifier les données affichées dans un tableau de bord en ajoutant des regroupements ou des filtres temporaires. Par exemple, si vous examinez 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 regroupements et filtres temporaires sont automatiquement supprimés lorsque vous rechargez la page. Vous pouvez également les supprimer manuellement.

Vous pouvez également créer des filtres permanents. Par exemple, si vous épinglez un filtre, il se comporte comme un filtre temporaire, sauf qu'il est toujours disponible. Vous pouvez également créer des variables qui vous permettent d'appliquer un filtre à certains widgets. Pour en savoir plus, consultez Créer et gérer des variables et des filtres épinglés.

Cette fonctionnalité n'est disponible que pour les projets Google Cloud . Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion du dossier compatible avec les applications.

Fonctionnement des filtres de tableau 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 façon dont un widget accepte un filtre à l'échelle du tableau de bord dépend du type de données qu'il affiche et de sa configuration :

  • Pour les widgets qui affichent des données de séries temporelles, comme les graphiques 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 appliqué à l'ensemble 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 avec un 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 appliqué à l'ensemble 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 appliqué à l'ensemble du tableau de bord ne modifie pas les données affichées.

    • Sinon, le graphique filtre les données qu'il affiche pour n'inclure que les séries temporelles qui répondent au filtre appliqué à l'ensemble du tableau de bord.

  • Pour les widgets du panneau "Journaux", les filtres appliqués à l'ensemble du tableau de bord qui sont basés sur un libellé de ressource mettent à jour la requête. Par exemple, si vous ajoutez le filtre cluster_name: mycluster à l'ensemble du tableau de bord, la requête est mise à jour pour inclure resource.labels."cluster_name"="mycluster".

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

Avant de commencer

Dans le projet Google Cloud où vous souhaitez afficher vos tableaux de bord, procédez comme suit :

Créer ou modifier des regroupements temporaires

Lorsque vous ajoutez des regroupements à l'ensemble 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, cette fonction est utilisée.

Par exemple, supposons que votre tableau de bord contienne 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 ce graphique afin de modifier 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 :

  1. 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.

  2. Dans la barre d'outils de la console Google Cloud , sélectionnez votre projet Google Cloud . Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion du dossier compatible avec les applications.
  3. Développez le menu Grouper par, puis sélectionnez les libellés à regrouper.
  4. 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 différentes manières. Par exemple, vous pouvez afficher uniquement les séries temporelles d'une machine virtuelle spécifique ou de 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 qui correspondent à ce filtre. Par exemple, pour configurer tous les graphiques afin d'afficher uniquement 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 de manière à n'afficher 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 :

  1. 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.

  2. Dans la barre d'outils de la console Google Cloud , sélectionnez votre projet Google Cloud . Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion du dossier compatible avec les applications.

  3. 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 est identique à celui de 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: *.

  4. Pour sélectionner une valeur spécifique à faire correspondre, cliquez sur le filtre (par exemple, 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 Filtrer .

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

Modifier un filtre temporaire

Pour modifier la valeur d'un filtre temporaire, cliquez sur Menu, puis faites votre choix.

Une fois votre sélection effectuée, les graphiques et les tableaux sont actualisés.

Supprimer un filtre temporaire

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

Étapes suivantes