Ce document explique comment utiliser la console Google Cloud pour créer une alerte qui envoie des notifications lorsqu'une règle de surveillance ne contient aucune donnée pour une période spécifique.
Les conditions d'absence de métrique nécessitent au moins une mesure réussie qui récupère les données, dans la période maximale suivant l'installation de la stratégie ou modifiées. Cette période est appelée temps d'absence du déclencheur. La le temps maximal d'absence du déclencheur configurable est de 23,5 heures.
Par exemple, supposons que vous définissiez le délai d'absence du déclencheur en tant que délai d'absence de métrique est définie sur 30 minutes. La condition ne sera pas remplie lorsque le sous-système qui écrit des données de métriques n'a jamais écrit de point de données. Pour qu'elle soit remplie, le sous-système doit générer au moins un point de données, puis ne générer aucun point de données supplémentaire pendant 30 minutes.
Ce contenu ne concerne pas les règles d'alerte basées sur les journaux. Pour plus d'informations sur les règles d'alerte basées sur les journaux, qui vous informent lorsqu'un s'affiche dans vos journaux, consultez Surveiller vos journaux
Ce document ne décrit pas les éléments suivants:
- Comment être averti lorsque les valeurs d'une métrique sont supérieures ou inférieures à un seuil. Pour plus d'informations, consultez la section Créer des règles d'alerte basées sur les métriques.
- Recevoir une notification en fonction de la valeur prédite d'une métrique Pour plus pour en savoir plus, consultez Créez des règles d'alerte basées sur les métriques prévues.
Créer une règle d'alerte à l'aide de l'API Cloud Monitoring Pour plus pour en savoir plus, consultez Créer des règles d'alerte à l'aide de l'API
Créer une règle d'alerte dont la condition inclut un une requête MQL (Monitoring Query Language). Ces règles peuvent utiliser un modèle statique ou dynamique de sortie. Pour en savoir plus, consultez les documents suivants :
Avant de commencer
-
Pour obtenir les autorisations nécessaires pour créer et modifier des règles d'alerte à l'aide de la console Google Cloud, demandez à votre administrateur de vous accorder le Éditeur Monitoring (
roles/monitoring.editor
) 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 Cloud Monitoring, consultez Contrôler les accès avec Identity and Access Management.
Assurez-vous de bien connaître les concepts généraux des règles d'alerte. Pour en savoir plus sur ces sujets, consultez Vue d'ensemble des alertes
Configurez les canaux de notification que vous souhaitez utiliser pour recevoir des notifications. À des fins de redondance, nous vous recommandons de créer plusieurs types de canaux de notification. Pour en savoir plus, consultez Créer et gérer des canaux de notification
Créer une règle d'alerte
Pour créer une règle d'alerte qui envoie des notifications Lorsqu'une série temporelle surveillée ne contient aucune donnée pour un temps d'absence du déclencheur spécifique, effectuer les opérations suivantes:
-
Dans la console Google Cloud, accédez à la page notificationsAlertes :
Accéder à l'interface des alertes
Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.
- Sélectionnez Créer une règle.
Sélectionnez la série temporelle à surveiller :
Cliquez sur Sélectionner une métrique, puis naviguez dans les menus pour sélectionner une le type de ressource et le type de métrique, puis cliquez sur Appliquer.
Le menu Sélectionner une métrique propose des fonctionnalités qui vous aident à identifier les types de métriques disponibles:
- Pour rechercher un type de métrique spécifique, utilisez le
filter_list Barre de filtres.
Par exemple, si vous saisissez
util
, vous limitez le menu aux afficher les entrées contenantutil
. Les entrées s'affichent lorsqu'elles réussissent un mot clé "contient" non sensible à la casse test.
Vous pouvez surveiller n'importe quelle métrique intégrée ou n'importe quelle la métrique.
- Pour rechercher un type de métrique spécifique, utilisez le
filter_list Barre de filtres.
Par exemple, si vous saisissez
Facultatif: Pour surveiller un sous-ensemble de la série temporelle correspondant aux les types de ressources et de métriques sélectionnés à l'étape précédente, cliquez sur Ajouter un filtre. Dans la boîte de dialogue "Filtrer", sélectionnez l'étiquette par un comparateur, puis la valeur du filtre. Par exemple, le filtre
zone =~ ^us.*.a$
utilise une expression régulière pour faire correspondre toutes les données de séries temporelles dont le nom de zone commence parus
et se termine par aveca
. Pour en savoir plus, consultez Filtrer la série temporelle sélectionnéeFacultatif : Pour modifier l'alignement des points d'une série temporelle, procédez comme suit : Dans la section Transformer les données, définissez la fenêtre glissante et Champs du fenêtrage glissant.
Ces champs spécifient comment les points enregistrés dans une fenêtre sont combinés. Par exemple, supposons que la fenêtre dure 15 minutes et que le fenêtrage est
max
. Le point aligné est la valeur maximale de toutes au cours des 15 dernières minutes. Pour en savoir plus, consultez Alignement: régularisation au sein de la série.Facultatif: combinez des séries temporelles si vous souhaitez réduire le nombre de de séries temporelles surveillées par une règle, ou lorsque vous souhaitez uniquement surveiller un ensemble de séries temporelles. Par exemple, au lieu de surveiller de l'utilisation du processeur de chaque instance de VM, vous pouvez calculer la moyenne de l'utilisation du processeur pour toutes les VM d'une zone, puis de surveiller cette moyenne. Par défaut, ne sont pas combinées. Pour obtenir des informations générales, consultez la page Réduction: combinaison de séries temporelles.
Pour combiner toutes les séries temporelles, procédez comme suit:
- Dans la section Sur plusieurs séries temporelles, cliquez sur expand_more Développer.
- Définissez le champ Agrégation de séries temporelles sur une valeur autre que
none
Par exemple, pour afficher la valeur moyenne série temporelle, sélectionnezmean
. - Vérifiez que le champ Grouper les séries temporelles par est vide.
Pour combiner ou regrouper des séries temporelles par valeurs de libellé, procédez comme suit:
- Dans la section Sur plusieurs séries temporelles, cliquez sur expand_more Développer.
- Définissez le champ Agrégation de séries temporelles sur une valeur autre que
none
- Dans le champ Time series group by (Regrouper par séries temporelles), sélectionnez les étiquettes. à regrouper.
Par exemple, si vous effectuez un regroupement par libellé
zone
, puis que vous définissez le d'agrégation sur une valeur demean
, le graphique affiche une série temporelle pour chaque zone pour laquelle des données sont disponibles. La La série temporelle affichée pour une zone spécifique correspond à la moyenne de toutes les séries temporelles avec cette zone.Cliquez sur Suivant.
Configurez le déclencheur de condition:
- Sélectionnez Absence de métrique pour le type de condition.
- Sélectionnez une valeur pour le menu Déclencheur d'alerte. Ce menu vous permet spécifier le sous-ensemble de séries temporelles qui ne doit pas contenir de données ; avant que la condition ne soit remplie.
- Spécifiez la durée pendant laquelle les données de métriques doivent être absentes avant d'envoyer une alerte vous avertit via le champ Délai d'absence du déclencheur.
- Cliquez sur Suivant.
Facultatif: Créez une règle d'alerte avec plusieurs conditions.
La plupart des règles surveillent un seul type de métrique. Par exemple, une règle peut et surveiller le nombre d'octets écrits dans une instance de VM. Quand vous voulez pour surveiller plusieurs types de métriques, créez une règle avec plusieurs conditions. Chaque condition surveille un type de métrique. Après avoir créé les conditions, vous spécifiez comment les conditions sont combinées. Pour en savoir plus, consultez Règles avec plusieurs conditions :
Pour créer une règle d'alerte avec plusieurs conditions, procédez comme suit:
- Pour chaque condition supplémentaire, cliquez sur Ajouter une condition d'alerte, puis configurer cette condition.
- Cliquez sur Suivant et configurez le mode de combinaison des conditions.
- Cliquez sur Suivant pour accéder aux notifications et à la documentation. configuration.
Configurez les notifications:
Développez le menu Notifications et nom et sélectionnez votre notification. canaux de distribution. À des fins de redondance, nous vous recommandons d'ajouter plusieurs types de canaux de notification. Pour en savoir plus, consultez Gérer les canaux de notification.
Facultatif: Pour recevoir une notification lorsqu'un incident est clôturé, sélectionnez Envoyer une notification lors de la clôture de l'incident Par défaut, lorsque vous créez une règle d'alerte avec le paramètre console Google Cloud, une notification n'est envoyée que lorsqu'un incident créé.
Facultatif: Pour modifier le délai d'attente de Monitoring un incident lorsque les données cessent d'arriver, sélectionnez une option dans Menu Durée de la fermeture automatique de l'incident Par défaut, lorsque les données n'arrivent plus, Monitoring attend sept jours avant de fermer un incident ouvert.
Sélectionnez une option dans le menu Niveau de gravité de la règle. Incidents et les notifications affichent le niveau de gravité.
Facultatif: Pour ajouter des étiquettes personnalisées à la règle d'alerte, dans la section Libellés utilisateur des règles, procédez comme suit:
- Cliquez sur Ajouter une étiquette, puis dans le champ Clé, saisissez un nom pour la
libellé. Les noms des étiquettes doivent commencer par une lettre minuscule et peuvent
contenir des lettres minuscules, des chiffres, des traits de soulignement et des tirets.
Par exemple, saisissez
severity
. - Cliquez sur Valeur, puis saisissez la valeur de votre libellé. Les valeurs d'étiquette
contenir des lettres minuscules, des chiffres, des traits de soulignement et des tirets.
Par exemple, saisissez
critical
.
Découvrez comment utiliser les libellés de stratégie pour gérer plus facilement vos notifications, consultez Annotez les incidents à l'aide de libellés.
- Cliquez sur Ajouter une étiquette, puis dans le champ Clé, saisissez un nom pour la
libellé. Les noms des étiquettes doivent commencer par une lettre minuscule et peuvent
contenir des lettres minuscules, des chiffres, des traits de soulignement et des tirets.
Par exemple, saisissez
Facultatif: Dans la section Documentation, saisissez le contenu de votre choix. inclus dans la notification.
Pour mettre en forme votre documentation, vous pouvez utiliser du texte brut, Markdown et les variables. Vous pouvez également inclure des liens pour aider les utilisateurs à déboguer l'incident, tels que sous forme de liens vers des playbooks internes, des tableaux de bord Google Cloud . Par exemple, le modèle de documentation suivant décrit un CPU d'un incident d'utilisation d'une ressource
gce_instance
et inclut plusieurs variables pour référencer la règle d'alerte et la condition REST ressources. Modèle de documentation puis redirige les lecteurs vers des pages externes pour faciliter le débogage.Lorsque des notifications sont créées, Monitoring remplace les variables de documentation et leurs valeurs. Les valeurs remplacent les variables uniquement dans les notifications. La Volet d'aperçu et autres emplacements dans la console Google Cloud afficher uniquement le formatage Markdown.
Aperçu
## CPU utilization exceeded ### Summary The ${metric.display_name} of the ${resource.type} ${resource.label.instance_id} in the project ${resource.project} has exceeded 90% for over 15 minutes. ### Additional resource information Condition resource name: ${condition.name} Alerting policy resource name: ${policy.name} ### Troubleshooting and Debug References Repository with debug scripts: example.com Internal troubleshooting guide: example.com ${resource.type} dashboard: example.com
Mettre en forme dans la notification
Pour en savoir plus, consultez Annoter les notifications avec de la documentation définie par l'utilisateur et Utiliser les commandes de canal.
Cliquez sur Nom de l'alerte et saisissez un nom pour la règle d'alerte.
Cliquez sur Créer une règle.
Filtrer la série temporelle sélectionnée
Les filtres permettent de s'assurer que seules les séries temporelles répondant à certains critères sont de surveillance. Lorsque vous appliquez des filtres, vous pouvez réduire le nombre de lignes du graphique, ce qui peut améliorer les performances du graphique. Vous pouvez également réduire quantité de données surveillée en appliquant une agrégation. Les filtres permettent de s'assurer que seules les séries temporelles répondant à un ensemble de critères sont utilisées. Lorsque vous appliquez des filtres, vous avez moins de séries temporelles à évaluer, ce qui peut d'améliorer les performances de l'alerte.
Un filtre est composé d'une étiquette, d'un comparateur et d'une valeur. Par exemple :
pour faire correspondre toutes les séries temporelles dont le libellé zone
commence par "us-central1"
, vous
peut utiliser le filtre zone=~"us-central1.*"
, qui utilise une expression régulière ;
pour effectuer la comparaison.
Lorsque vous filtrez par ID de projet ou par conteneur de ressources,
vous devez utiliser l'opérateur "égal", (=)
. Lorsque vous filtrez par
autres étiquettes, vous pouvez utiliser n'importe quel comparateur compatible.
En règle générale, vous pouvez filtrer les étiquettes de métrique et de ressource, et
groupe de ressources.
Lorsque vous fournissez plusieurs critères de filtrage, seules les séries temporelles répondant à tous les critères sont surveillées.
Pour ajouter un filtre, cliquez sur Ajouter un filtre, renseignez les champs de la boîte de dialogue, puis cliquez sur OK. Dans la boîte de dialogue, utilisez le champ Filtrer pour sélectionner critère de filtrage, sélectionnez l'opérateur de comparaison, puis sélectionnez la valeur. Chaque ligne du tableau suivant répertorie un opérateur de comparaison, sa signification et un Exemple:
Opérateur | Signification | Exemple |
---|---|---|
= |
Égalité | resource.labels.zone = "us-central1-a" |
!= |
Inégalité | resource.labels.zone != "us-central1-a" |
=~ |
Égalité Expression régulière 2 | monitoring.regex.full_match("^us.*") |
!=~ |
Inégalité Expression régulière2 | monitoring.regex.full_match("^us.*") |
starts_with |
La valeur commence par | resource.labels.zone = starts_with("us") |
ends_with |
La valeur se termine par | resource.labels.zone = ends_with("b") |
has_substring |
La valeur contient | resource.labels.zone = has_substring("east") |
one_of |
Une | resource.labels.zone = one_of("asia-east1-b", "europe-north1-a") |
!starts_with |
La valeur ne commence pas par | resource.labels.zone != starts_with("us") |
!ends_with |
La valeur ne se termine pas par | resource.labels.zone != ends_with("b") |
!has_substring |
La valeur ne contient pas | resource.labels.zone != has_substring("east") |
!one_of |
La valeur n'est pas l'une des suivantes | resource.labels.zone != one_of("asia-east1-b", "europe-north1-a") |