Ajouter des filtres temporaires à un tableau de bord personnalisé

Ce document explique comment modifier les données affichées sur un graphique personnalisé (sans avoir à modifier chaque widget) en ajoutant des regroupements temporaires et des filtres temporaires. Une fois que vous avez ajouté un filtre ou un regroupement à l'échelle 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 filtres temporaires. Par exemple, si vous étudiez une et que vous souhaitez que le tableau de bord n'affiche que les données (VM), puis ajoutez un filtre temporaire.

Les regroupements et filtres temporaires sont automatiquement supprimés lorsque vous actualisez la page ; mais vous pouvez aussi les supprimer manuellement.

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

Fonctionnement des filtres des tableaux de bord

Un filtre de tableau de bord spécifie une étiquette et une valeur. La série temporelle les affichages du tableau de bord déterminent les étiquettes disponibles pour le filtrage. La prise en charge d'un filtre à l'échelle du tableau de bord par widget dépend du type de données le widget s'affiche, ainsi que 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 ne prend pas en charge le libellé dans un , le filtre pour 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 n'affiche pas de données avec le libellé instance_id sur le tableau de bord, puis le filtre ne modifie pas les données affichées.

    • Si le widget spécifie une valeur pour une étiquette, alors le un filtre à l'échelle 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 l'étiquette instance_id, puis le filtre d'ensemble du tableau de bord ne modifie pas les données affichées.

    • Dans le cas contraire, le graphique filtre les données affichées des séries temporelles qui satisfont au filtre applicable à l'ensemble du tableau de bord.

  • Pour les widgets des panneaux de journaux, les filtres de l'ensemble du tableau de bord sont basés sur un l'étiquette de ressource pour mettre à jour la requête. Par exemple, si vous ajoutez le paramètre filtre d'ensemble du tableau de bord cluster_name: mycluster, la requête est mis à jour pour inclure resource.labels."cluster_name"="mycluster".

Vous pouvez ajouter plusieurs filtres à l'ensemble du tableau de bord. Ces filtres sont associés avec l'opérateur logique AND.

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 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 Contrôlez 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 s'affichent une série temporelle pour chaque ensemble de séries temporelles ayant les mêmes valeurs pour étiquettes de regroupement. Par défaut, la moyenne de chaque ensemble est affichée. Toutefois, lorsque le widget définit une fonction de regroupement, qui est alors utilisée.

Par exemple, supposons que votre tableau de bord contient qui affiche l'utilisation du processeur par vos instances de VM. Pour déterminer Si vous devez déployer davantage de VM dans une zone donnée, vous pouvez modifier le paramètre le tableau de bord et le graphique pour modifier ses options de regroupement. Autre solution regrouper temporairement le tableau de bord par zone, puis afficher Graphique de l'utilisation du processeur.

Pour créer ou modifier les regroupements temporaires, 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. Développez le menu Grouper par , puis sélectionnez les étiquettes pour le regroupement.
  3. 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 voudrez peut-être examiner les données dans de manières spécifiques. Par exemple, vous pouvez n'afficher que les séries temporelles pour une machine virtuelle spécifique ou pour les ressources d'une région spécifique. Quand ? 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, créez un filtre basé sur l'étiquette instance_id. De même, pour configurer le tableau de bord pour n'afficher que les séries temporelles d'une zone spécifique, créer une 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 de filtre du tableau de bord, cliquez sur Ajouter un filtre, puis sélectionnez un libellé dans le menu.

    Le menu répertorie les étiquettes 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. Sa valeur est définie. à *, qui correspond à toutes les valeurs. Par exemple, si vous sélectionnez zone, la barre d'outils affiche zone: *.

  3. Pour sélectionner une valeur spécifique à mettre en correspondance, cliquez sur le filtre (par exemple, cliquez 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 de 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

Pour obtenir plus d'informations sur une série temporelle spécifique affichée sur un graphique, vous pouvez utiliser la légende du graphique pour appliquer des filtres temporaires. 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 décrire le comportement des différentes options, envisagez un tableau de bord qui affiche les éléments CPU utilization et Métriques Disk read bytes pour aux 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:

  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. Identifiez le graphique et développez la légende pour afficher plus de détails en cliquant sur  Développer la légende
  3. Faites défiler la légende jusqu'à trouver la série temporelle précise qui vous intéresse, cliquez sur Actions for this timeseries (Actions pour cette série temporelle) puis sélectionnez Filtrer le tableau de bord sur toutes les étiquettes.

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 désormais voir pour cette ressource, et les supprimer temporairement de l'affichage pour les séries temporelles qui ne vous intéressent pas.

Pour appliquer des filtres temporaires qui identifient la ressource d'un élément série temporelle affichée par un graphique, 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. Identifiez le graphique et développez la légende pour afficher plus de détails en cliquant sur  Développer la légende
  3. Faites défiler la légende jusqu'à trouver la série temporelle précise qui vous intéresse, cliquez sur Actions for this timeseries (Actions pour cette série temporelle) puis sélectionnez Filtrer le tableau de bord en fonction des étiquettes de ressources.

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 sur les étiquettes de ressources applique uniquement à la barre de filtre temporaire, le résultat est le même lorsque vous sélectionnez cette option à partir de 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 affichée par un graphique, 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. Identifiez le graphique et développez la légende pour afficher plus de détails en cliquant sur  Développer la légende
  3. Faites défiler la légende jusqu'à trouver la série temporelle précise qui vous intéresse, cliquez sur Actions for this timeseries (Actions pour cette série temporelle) puis sélectionnez Filtrer le tableau de bord sur les étiquettes de métriques.

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, puis un filtre basé sur le libellé instance_name est ajouté. Dans ce cas, il s'agit 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 plusieurs VM avec la même valeur pour l'étiquette 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 étiquettes de la métrique Disk read bytes.

Si vos filtres temporaires n'incluent que des filtres de métriques, vous consulter les séries temporelles pour cette métrique, quelle que soit la ressource sur laquelle la série temporelle 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 la page tableau de bord. Pour supprimer manuellement un filtre temporaire, sur ce filtre, cliquez sur Supprimer.

Étape suivante