Les filtres et les regroupements temporaires dans Cloud Monitoring vous permettent de limiter ou d'agréger dynamiquement les données affichées dans un tableau de bord personnalisé sans modifier les widgets individuels. Par exemple, lorsque vous examinez une alerte, vous pouvez appliquer un filtre temporaire à partir de la barre d'outils du tableau de bord pour afficher les métriques et les journaux d'une machine virtuelle (VM) ou d'une région spécifique.
L'actualisation de la page efface automatiquement ces paramètres, mais vous pouvez également les supprimer manuellement. Pour enregistrer des filtres pour des sessions ultérieures ou les appliquer à des widgets spécifiques, consultez 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 manière dont un widget prend en charge un filtre à l'échelle 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 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 filtre, le 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 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 à 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 le libelléinstance_id, le filtre à l'échelle 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 conserver que les séries temporelles qui correspondent au filtre à l'échelle du tableau de bord.
Pour les widgets de panneau de 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 à 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 à l'échelle du tableau de bord. Ces filtres sont combinés avec un AND logique.
Avant de commencer
Effectuez les opérations suivantes dans le Google Cloud projet dans lequel vous souhaitez afficher vos tableaux de bord :
-
Pour obtenir les autorisations nécessaires pour ajouter ou modifier des filtres temporaires à l'aide de la Google Cloud console, 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 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 Contrôler l'accès avec la gestion de l'authentification et des accès.
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 qui ont 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 d'autres 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 :
-
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.
- 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.
- Développez le menu arrow_drop_down Critère de regroupement , puis sélectionnez les libellés pour le 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 examinez une alerte, vous pouvez afficher les données de différentes manières. Par exemple, vous pouvez n'afficher que les séries temporelles d'une machine virtuelle spécifique ou de ressources dans 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 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 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.
- 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.
Dans la barre de filtre filter_list du tableau de bord, cliquez sur Ajouter un filtre, puis sélectionnez un libellé dans le menu.
Le menu répertorie les libellés de chaque série temporelle affichée dans 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électionnezzone, alors la barre d'outils affichezone: *.Pour sélectionner une valeur spécifique à faire correspondre, 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 filter_list 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 arrow_drop_down 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 supprimés automatiquement lorsque vous quittez le tableau de bord. Pour supprimer manuellement un filtre temporaire, sur ce filtre, cliquez sur cancel Supprimer.
Étape suivante
- Explorer les données représentées graphiquement
- Accéder aux tableaux de bord spécifiques aux ressources
- Créer et gérer des variables et des filtres épinglés