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

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) en ajoutant des regroupements temporaires et des filtres temporaires. Une fois que vous avez ajouté un regroupement ou un filtre appliqué à 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.

Pour résoudre un problème, 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 actualisez la page. Vous pouvez toutefois é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 la section Créer et gérer des variables et des filtres épinglés.

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 compatibilité d'un widget avec 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 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 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 au 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'afficher 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 basés sur un libellé de ressource mettent à jour la requête. Par exemple, si vous ajoutez le filtre à l'échelle 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 AND logique.

Avant de commencer

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

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 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 des regroupements temporaires, 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.
Développez le menu Grouper par, puis sélectionnez les libellés à regrouper.
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 choisir de n'afficher que 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:

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 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 *, 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, 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.

Modifier un filtre temporaire

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

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.