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

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 regroupements et les filtres temporaires sont automatiquement supprimés lorsque vous rechargez la page. Toutefois, 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 pour sélectionner des widgets. Pour en savoir plus, consultez Créer et gérer des variables et des filtres épinglés.

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

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 manière dont un widget est compatible avec un filtre appliqué à l'ensemble 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, comme les graphiques linéaires, 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.

    • Dans le cas contraire, le graphique filtre les données qu'il affiche pour ne présenter que les séries temporelles qui répondent au filtre appliqué à l'ensemble du tableau de bord.

  • Pour les widgets du panneau des journaux, les filtres appliqués à l'ensemble du tableau de bord et basés sur un libellé de ressource mettent à jour la requête. Par exemple, si vous ajoutez le filtre appliqué à l'ensemble du tableau de bord cluster_name: mycluster, 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 joints par un opérateur logique AND.

Avant de commencer

Effectuez les opérations suivantes dans le Google Cloud projet dans lequel vous souhaitez afficher vos tableaux de bord :

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.

Supposons, par exemple, 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 pour 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, procédez comme suit :

  1. Dans la Google Cloud console, 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 Google Cloud console, sélectionnez votre Google Cloud projet. Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion.
  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 Google Cloud console, 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 Google Cloud console, sélectionnez votre Google Cloud projet. Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion.

  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, alors 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 du 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.

Modifier un filtre temporaire

Pour modifier la valeur d'un filtre temporaire, sur ce filtre, cliquez sur Menu, puis effectuez une sélection.

Une fois que vous avez effectué une sélection, les graphiques et les tableaux sont actualisés.

Supprimer un filtre temporaire

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

Étape suivante