Surveiller la consommation des réservations

Ce document explique comment surveiller la consommation de réservations de ressources zonales Compute Engine à l'aide de Cloud Monitoring.

Monitoring collecte et stocke les informations sur les performances des services Google Cloud, tels que Compute Engine. Les informations sur les performances sont appelées métriques et séries temporelles. Vous pouvez accéder aux métriques et aux séries temporelles de vos réservations Compute Engine pour effectuer les opérations suivantes :

Afficher la consommation de vos réservations à l'aide des tableaux de bord Monitoring.
Recevoir des notifications en temps opportun lorsque la consommation de vos réservations est dans un état spécifique à l'aide des règles d'alerte Monitoring.

Ces méthodes peuvent, par exemple, vous aider à vérifier que vos réservations sont utilisées comme prévu ou dans le délai imparti pour éviter des coûts inutiles liés à des ressources gaspillées ou inutilisées.

Avant de commencer

Consultez les exigences et restrictions applicables aux réservations.

Activez l'API Monitoring
Activer l'API

Si ce n'est pas déjà fait, configurez l'authentification. L'authentification est le processus permettant de valider votre identité pour accéder aux services et aux API Google Cloud. Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine comme suit :

Sélectionnez l'onglet correspondant à la façon dont vous prévoyez d'utiliser les exemples de cette page :
Console

Lorsque vous utilisez la console Google Cloud pour accéder aux services et aux API Google Cloud, vous n'avez pas besoin de configurer l'authentification.
REST

Pour utiliser les exemples d'API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à gcloud CLI.

Rôles requis

Pour obtenir les autorisations nécessaires pour créer des tableaux de bord ou des règles d'alerte Monitoring afin de surveiller la consommation des réservations, demandez à votre administrateur de vous accorder le rôle IAM Administrateur Monitoring (roles/monitoring.admin) sur le projet. Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

Ce rôle prédéfini contient les autorisations requises pour créer des tableaux de bord Monitoring ou des règles d'alerte afin de surveiller la consommation des réservations. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour créer des tableaux de bord ou des règles d'alerte Monitoring afin de surveiller la consommation des réservations :

Pour créer des tableaux de bord : monitoring.dashboards.create sur le projet
Pour créer des règles d'alerte : monitoring.alertPolicies.create sur le projet

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Restrictions

Lorsque vous utilisez Monitoring pour accéder à la série temporelle d'une réservation et l'afficher, les restrictions suivantes s'appliquent :

Une fois que vous avez créé une réservation, sa série temporelle devient disponible sous 30 minutes.
Une fois qu'une série temporelle devient disponible, Monitoring la met à jour au moins une fois toutes les 30 minutes.
Si vous supprimez une réservation, sa série temporelle est également supprimée et ne peut plus être récupérée.
Vous ne pouvez accéder à et afficher que la série temporelle d'une réservation créée dans le projet actuel.

Pour en savoir plus sur les restrictions Monitoring, consultez la page Quotas et limites de Cloud Monitoring.

Métriques de réservation

Lorsque vous créez des tableaux de bord ou des règles d'alerte Monitoring, vous devez d'abord sélectionner la métrique Google Cloud pour mesurer les performances du service Google Cloud. Pour les réservations, vous pouvez sélectionner les métriques Compute Engine suivantes :

Réservées : nombre d'instances de machine virtuelle (VM) réservées dans chaque réservation du projet en cours.
Utilisées : nombre de VM utilisées dans chaque réservation du projet en cours.

Après avoir sélectionné une métrique, vous pouvez filtrer ou regrouper les mesures de la métrique de réservations. Pour en savoir plus sur les filtres disponibles pour les réservations, consultez la section Filtres de réservation du présent document.

Filtres de réservation

Vous pouvez utiliser des filtres Monitoring pour regrouper ou filtrer les données de séries temporelles associées à une ou plusieurs réservations. Plus précisément, lors de la création de tableaux de bord ou de règles d'alerte Monitoring, vous pouvez limiter les données de séries temporelles qu'ils utilisent en spécifiant un ou plusieurs des libellés suivants :

Sélecteur	Nom du libellé	Description
`metadata.system`	`machine_type`	Type de machine spécifié dans les VM réservées pour une réservation.
`metadata.system`	`name`	Nom d'une réservation.
`metadata.system`	`state`	État d'une réservation. Vous ne pouvez surveiller que les réservations à l'état `ACTIVE`, c'est-à-dire lorsqu'une réservation existe.
`metric`	`reserved_resource_type`	Type de ressources zonales réservées par une réservation. Vous ne pouvez surveiller que le type `instance`, qui est une instance de VM.
`resource`	`location`	Zone où se trouve la réservation.
`resource`	`reservation_id`	Identifiant (ID) d'une réservation.
`resource`	`resource_container`	Numéro du projet dans lequel une réservation existe. Vous ne pouvez surveiller que les réservations créées dans le projet actuel.

Lors de la création d'un filtre, vous devez spécifier le sélecteur et le nom du libellé, suivis d'un opérateur de comparaison, puis de la valeur à filtrer. Par exemple, si vous souhaitez que votre requête filtre vos réservations par zone us-central1-a, utilisez le filtre suivant :

resource.location = "us-central1-a"

Pour vous assurer que la valeur que vous spécifiez dans un filtre correspond à la valeur du champ d'une réservation, affichez les détails de la réservation.

Surveiller la consommation des réservations

Pour surveiller la consommation de vos réservations, sélectionnez l'une des méthodes suivantes spécifiées dans le présent document :

Créer un tableau de bord : créez des tableaux de bord Monitoring et ajoutez des widgets aux zones du graphique pour afficher les données de séries temporelles liées à la consommation de vos réservations.

Cette méthode est utile, par exemple, lorsque vous souhaitez vérifier qu'une VM consomme correctement une réservation ou comparer la tendance de consommation de plusieurs réservations.
Créer des règles d'alerte : créez des règles d'alerte pour envoyer des alertes lorsque les données de séries temporelles liées à la consommation de vos réservations atteignent un seuil défini.

Cette méthode est utile, par exemple, lorsque vous souhaitez être averti lorsque le nombre de VM utilisées dans le projet actuel est inférieur à un ratio spécifique ou lorsqu'une réservation reste inutilisée pendant une durée spécifique.

Créer un tableau de bord

Vous pouvez créer des tableaux de bord Monitoring et afficher la série temporelle liée à la consommation de vos réservations à l'aide de la console Google Cloud (recommandé) et de l'API Monitoring.

Lorsque vous définissez l'affichage des données de séries temporelles d'un filtre Monitoring, vous devez utiliser l'une des méthodes suivantes :

Requête de base : cette méthode est utile pour configurer rapidement les données de séries temporelles pour un widget de tableau de bord.

Par exemple, vous pouvez utiliser la requête de base pour afficher rapidement quelle réservation n'est pas encore entièrement utilisée dans une zone spécifique.
MQL : cette méthode est utile pour récupérer, filtrer et manipuler des données de séries temporelles afin de créer des configurations plus complexes pour un widget de tableau de bord.

Par exemple, vous pouvez utiliser le langage MQL (Monitoring Query Language) pour afficher le ratio entre les VM consommées et les VM réservées dans vos réservations.

Conseil : Pour découvrir d'autres méthodes permettant de configurer la série temporelle de vos réservations dans un tableau de bord Monitoring, consultez la page PromQL dans Cloud Monitoring.

Requête de base

L'exemple suivant explique comment créer un tableau de bord Monitoring avec un widget de graphique en courbes pour afficher vos réservations utilisées dans la zone us-central1-a.

Console

Pour créer un tableau de bord Monitoring à l'aide de la requête de base, procédez comme suit :

Dans la console Google Cloud, accédez à Tableaux de bord.

Accéder à la page Tableaux de bord
Cliquez sur Créer un tableau de bord.

La page Nouveau tableau de bord s'affiche.
Cliquez sur Ajouter un widget.

Le volet Ajouter un widget s'affiche.
Cliquez sur l'un des widgets disponibles. Par exemple, cliquez sur le widget Ligne.

Le volet Configurer le widget s'affiche.
Cliquez sur Sélectionner une métrique.
Dans la fenêtre Sélectionner une métrique, procédez comme suit :
1. Saisissez Reservation, puis sélectionnez Réservation.
  
  Important : Si vous ne voyez pas la métrique Réservation, consultez la section Métrique non répertoriée dans le menu.
2. Dans la liste Catégories de métriques actives, sélectionnez à nouveau Réservation.
3. Dans la liste Métriques actives, sélectionnez l'une des métriques disponibles. Par exemple, sélectionnez Utilisé.
4. Cliquez sur Appliquer.
Pour filtrer vos réservations en fonction d'une zone spécifique, procédez comme suit :
1. Dans la liste Ajouter un filtre, sélectionnez l'un des filtres disponibles pour les réservations. Pour cet exemple, sélectionnez emplacement.
2. Dans la liste Comparateur, sélectionnez l'un des opérateurs disponibles. Pour cet exemple, sélectionnez = (égal) (par défaut).
3. Dans la liste Valeur, sélectionnez la zone à utiliser pour filtrer vos réservations. Pour cet exemple, sélectionnez us-central1-a.
Cliquez sur Appliquer.

Pour découvrir d'autres options permettant de personnaliser les tableaux de bord Monitoring à l'aide de la console Google Cloud, consultez la page Créer et gérer des tableaux de bord personnalisés.

REST

Pour créer un tableau de bord Monitoring à l'aide de la requête de base, envoyez une requête POST à la méthode dashboards.create.

POST https://monitoring.googleapis.com/v1/projects/PROJECT_ID/dashboards

{
  "displayName": "Consumed reservations in zone us-central1-a",
  "mosaicLayout": {
    "columns": 12,
    "tiles": [
      {
        "height": 4,
        "widget": {
          "title": "Reservation - Used for us-central1-a [MEAN]",
          "xyChart": {
            "chartOptions": {
              "mode": "COLOR"
            },
            "dataSets": [
              {
                "minAlignmentPeriod": "60s",
                "plotType": "LINE",
                "targetAxis": "Y1",
                "timeSeriesQuery": {
                  "timeSeriesFilter": {
                    "aggregation": {
                      "alignmentPeriod": "60s",
                      "perSeriesAligner": "ALIGN_MEAN"
                    },
                    "filter": "FILTER",
                    "secondaryAggregation": {
                      "alignmentPeriod": "60s",
                      "perSeriesAligner": "ALIGN_NONE"
                    }
                  }
                }
              }
            ],
            "timeshiftDuration": "0s",
            "yAxis": {
              "scale": "LINEAR"
            }
          }
        },
        "width": 6
      }
    ]
  }
}

Remplacez les éléments suivants :

PROJECT_ID : ID du projet actuel.
FILTER : filtre Monitoring à utiliser pour votre tableau de bord. Par exemple, pour surveiller les réservations utilisées dans la zone us-central1-a, spécifiez les éléments suivants :
```
resource.type = 'compute.googleapis.com/Reservation' AND metric.type = 'compute.googleapis.com/reservation/used' AND resource.location = 'us-central1-a'
```

Pour en savoir plus sur la personnalisation des tableaux de bord Monitoring à l'aide de l'API Monitoring, consultez la page Créer et gérer des tableaux de bord à l'aide de l'API.

MQL

L'exemple suivant explique comment créer un tableau de bord Monitoring avec un widget de graphique en courbes pour afficher le ratio entre les VM utilisées et les VM réservées dans vos réservations.

Console

Pour créer un tableau de bord Monitoring à l'aide de MQL, procédez comme suit :

Dans la console Google Cloud, accédez à Tableaux de bord.

Accéder à la page Tableaux de bord
Cliquez sur Créer un tableau de bord.

La page Nouveau tableau de bord s'affiche.
Cliquez sur Ajouter un widget.

Le volet Ajouter un widget s'affiche.
Cliquez sur l'un des widgets disponibles. Par exemple, cliquez sur le widget Ligne.

Le volet Configurer le widget s'affiche.
Cliquez sur MQL.

Dans l'éditeur de requête, saisissez une requête MQL. Par exemple, pour afficher le ratio entre les VM utilisées et les VM réservées dans vos réservations, spécifiez les éléments suivants :

fetch compute.googleapis.com/Reservation
| { metric compute.googleapis.com/reservation/used
    | group_by [metadata.system.name], sliding(1m), max(value.used)
  ; metric compute.googleapis.com/reservation/reserved
    | group_by [metadata.system.name], sliding(1m), max(value.reserved) }
| ratio

Cliquez sur Exécuter la requête.
Cliquez sur Appliquer.

REST

Pour créer un tableau de bord Monitoring à l'aide de MQL, envoyez une requête POST à la méthode dashboards.create.

POST https://monitoring.googleapis.com/v1/projects/PROJECT_ID/dashboards

{
  "displayName": "Consumed reservations in zone us-central1-a",
  "mosaicLayout": {
    "columns": 12,
    "tiles": [
      {
        "height": 4,
        "widget": {
          "title": "Reservation - Used for us-central1-a [MEAN]",
          "xyChart": {
            "chartOptions": {
              "mode": "COLOR"
            },
            "dataSets": [
              {
                "plotType": "LINE",
                "targetAxis": "Y1",
                "timeSeriesQuery": {
                  "timeSeriesQueryLanguage": "MQL_QUERY"
                }
              }
            ],
            "timeshiftDuration": "0s",
            "yAxis": {
              "scale": "LINEAR"
            }
          }
        },
        "width": 6,
        "xPos": 6
      }
    ]
  }
}

Remplacez les éléments suivants :

PROJECT_ID : ID du projet actuel.
MQL_QUERY : requête MQL à utiliser pour le widget de graphique en courbes. Par exemple, pour afficher le ratio entre les VM utilisées et les VM réservées dans vos réservations, spécifiez les éléments suivants :
```
fetch compute.googleapis.com/Reservation
| { metric compute.googleapis.com/reservation/used
 | group_by [metadata.system.name], sliding(1m), max(value.used)
; metric compute.googleapis.com/reservation/reserved
 | group_by [metadata.system.name], sliding(1m), max(value.reserved) }
| ratio
```
Important : Pour spécifier une requête MQL couvrant plusieurs lignes dans le champ timeSeriesQueryLanguage, veillez à inclure le caractère \n à la fin. de chaque ligne.

Pour en savoir plus sur la personnalisation des tableaux de bord Monitoring à l'aide de l'API Monitoring, consultez la page Créer et gérer des tableaux de bord à l'aide de l'API.

Créer des règles d'alerte

Vous pouvez créer des règles d'alerte Monitoring pour recevoir des notifications sur la consommation des réservations dans le projet actuel à l'aide de la console Google Cloud et l'API Monitoring.

Lorsque vous définissez une condition d'alerte pour une règle d'alerte, vous devez utiliser l'une des méthodes suivantes :

Requête de base : cette méthode est utile pour créer des conditions d'alerte simples.

Par exemple, vous pouvez utiliser la requête de base pour créer une condition d'alerte qui se déclenche chaque fois qu'une réservation est utilisée pour la première fois.
MQL : cette méthode est utile pour récupérer, filtrer et manipuler des données de séries temporelles afin de créer des conditions d'alerte plus complexes.

Par exemple, vous pouvez utiliser le langage MQL (Monitoring Query Language) pour créer une condition d'alerte qui se déclenche lorsque le ratio des VM réservées sur les VM consommées atteint un seuil spécifique.

Requête de base

L'exemple suivant crée une règle d'alerte qui envoie une notification d'alerte lorsqu'une réservation est utilisée pour la première fois. Plus précisément, l'alerte se déclenche lorsque le nombre de VM utilisées dans une réservation est supérieur à 0.

Console

Pour créer une règle d'alerte Monitoring à l'aide de la requête de base, procédez comme suit :

Dans la console Google Cloud, accédez à Alertes.

Accéder à l'interface des alertes
Cliquez sur Créer une règle.

La page Créer une règle d'alerte s'ouvre.
Cliquez sur Sélectionner une métrique.

La fenêtre Sélectionner une métrique s'affiche.
Dans la fenêtre Sélectionner une métrique, procédez comme suit :
1. Dans le champ Filtrer par nom de ressource ou de métrique, saisissez Reservation.
2. Si la métrique Réservation s'affiche dans la liste Ressources actives, sélectionnez-la. Sinon, procédez comme suit :
  1. Décochez la case Afficher seulement les ressources et les métriques actives.
    
    La liste Ressources inactives s'affiche.
  2. Dans la liste Ressources inactives, sélectionnez Réservation.
    
    Important : Si vous ne voyez toujours pas la métrique Réservation, consultez la section Métrique non répertoriée dans le menu.
3. Dans la liste Catégories de métriques actives, sélectionnez à nouveau Réservation.
  
  La liste Métriques actives s'affiche.
4. Dans la liste Métriques actives, sélectionnez l'une des métriques disponibles.
  
  Par exemple, sélectionnez Utilisé.
5. Cliquez sur Appliquer.
Cliquez sur Ajouter un filtre.

La section Ajouter un filtre s'affiche.
Dans la section Ajouter un filtre, procédez comme suit :
1. Dans la liste Libellé, sélectionnez l'un des filtres de réservation disponibles spécifiés dans ce document.
  
  Par exemple, pour filtrer vos réservations par nom, sélectionnez nom.
2. Dans la liste Comparaison, sélectionnez l'un des opérateurs disponibles.
  
  Par exemple, sélectionnez = (est égal à) (par défaut).
3. Dans la liste Valeur, sélectionnez le nom de la réservation que vous souhaitez surveiller.
4. Cliquez sur OK.
Cliquez sur Suivant.

Le volet Configurer le déclencheur d'alerte s'affiche.
Dans la section Types de conditions, sélectionnez l'une des options suivantes :
1. Pour déclencher la condition si une série temporelle est supérieure ou inférieure à une valeur spécifique, sélectionnez Seuil.
2. Pour déclencher la condition si une série temporelle ne contient pas de données pour une heure spécifique, sélectionnez Absence de métrique.
3. Pour déclencher la condition si une série temporelle est censée dépasser le seuil dans un avenir proche, sélectionnez Prévision.
Par exemple, sélectionnez Seuil (valeur par défaut).
Dans la liste Déclencheur d'alerte, sélectionnez la condition qui déclenche l'alerte.

Par exemple, sélectionnez Toute violation de série temporelle (par défaut).
Dans la liste Position de seuil, sélectionnez le moment où la condition se déclenche.

Par exemple, sélectionnez Au-dessus du seuil.
Dans le champ Valeur de seuil, saisissez une valeur pour la condition.

Par exemple, saisissez 0.
Dans le champ Nom de la condition, saisissez un nom pour la condition.

Par exemple, saisissez Reservation RESERVATION_NAME consumed..

Où RESERVATION_NAME est le nom de la réservation que vous avez spécifiée aux étapes précédentes.
Cliquez sur Suivant.

Le volet Configurer les notifications et l'alerte de finalisation s'affiche.
Cliquez sur Utiliser les canaux de notification.
Dans le champ Canaux de notification, sélectionnez les canaux sur lesquels vous souhaitez recevoir une notification concernant l'incident.

Si vous n'avez pas de canaux de notification disponibles, cliquez sur Gérer les canaux de notification, puis suivez la procédure pour créer des canaux de notification. Pour en savoir plus, consultez la page Créer et gérer des canaux de notification.
Dans le champ Durée de fermeture automatique des incidents, sélectionnez une durée après laquelle un incident est automatiquement fermé.

Par exemple, sélectionnez 3 jours.
Dans le champ Nom de la règle d'alerte, saisissez un nom pour la règle d'alerte.

Par exemple, saisissez Alert: you started consuming reservation RESERVATION_NAME!.

Où RESERVATION_NAME est le nom de la réservation que vous avez spécifiée aux étapes précédentes.
Cliquez sur Suivant.

La page de vérification de la condition d'alerte s'affiche.
Cliquez sur Create policy (Créer une règle).

La création de la règle d'alerte peut prendre quelques secondes. Cette action vous renvoie à la page Créer une règle d'alerte.

Pour en savoir plus sur les options disponibles lors de la création de règles d'alerte à l'aide de la console Google Cloud et d'une requête de base, consultez la section Créer des règles d'alerte basées sur les métriques.

REST

Pour créer une règle d'alerte Monitoring utilisant une requête de base, envoyez une requête POST à la méthode projects.alertPolicies.create.

POST https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alertPolicies

{
  "displayName": "Alert: you started consuming reservation RESERVATION_NAME!",
  "conditions": [
    {
      "displayName": "Reservation RESERVATION_NAME consumed.",
      "conditionThreshold": {
        "filter": "FILTER",
        "aggregations": [
          {
            "alignmentPeriod": "300s",
            "crossSeriesReducer": "REDUCE_NONE",
            "perSeriesAligner": "ALIGN_MEAN"
          }
        ],
        "comparison": "COMPARISON_GT",
        "duration": "0s",
        "trigger": {
          "count": 1
        },
        "thresholdValue": 0
      }
    }
  ],
  "alertStrategy": {
    "autoClose": "AUTO_CLOSE_TIME"
  },
  "combiner": "OR",
  "enabled": true,
  "notificationChannels": [
    "projects/PROJECT_ID/notificationChannels/NOTIFICATION_CHANNEL"
  ]
}

Remplacez les éléments suivants :

PROJECT_ID : ID du projet actuel.
RESERVATION_NAME : nom d'une réservation existante située dans le projet actuel.
FILTER : filtre Monitoring à utiliser pour votre règle d'alerte. Par exemple, pour surveiller la métrique used de la réservation RESERVATION_NAME, spécifiez les éléments suivants :
```
resource.type = 'compute.googleapis.com/Reservation' AND metric.type = 'compute.googleapis.com/reservation/used' AND metadata.system.name = 'RESERVATION_NAME'
```
AUTO_CLOSE_TIME : délai avant la fermeture automatique d'un incident (en secondes). La valeur doit être comprise entre 0s et 604800s (7 jours). Par exemple, saisissez 259200s (3 jours).
NOTIFICATION_CHANNEL : nom d'un canal de notification existant. Pour configurer un canal de notification, consultez la page Créer et gérer des canaux de notification.

Pour plus d'informations sur les options disponibles lors de la création de règles d'alerte à l'aide de l'API Monitoring et d'une requête de base, consultez la page Créer des règles d'alerte à l'aide de l'API.

MQL

L'exemple suivant crée une règle d'alerte qui envoie une notification d'alerte lorsque le pourcentage de VM utilisées parmi les VM réservées dans votre réservation est supérieur à 90 %.

Console

Pour créer une règle d'alerte Monitoring à l'aide du langage MQL, procédez comme suit :

Dans la console Google Cloud, accédez à Alertes.

Accéder à l'interface des alertes
Cliquez sur Créer une règle.

La page Créer une règle d'alerte s'ouvre.
Dans la barre d'outils, cliquez sur MQL.

Le volet Modifier la requête s'affiche.
Dans le volet Modifier la requête, saisissez une requête MQL.

Par exemple, pour créer une requête qui regroupe vos réservations par nom et déclenche une condition d'alerte lorsque plus de 90 % de vos réservations sont utilisées, saisissez la requête suivante :
```
fetch compute.googleapis.com/Reservation
| { metric compute.googleapis.com/reservation/used
    | group_by [metadata.system.name], sliding(1m), max(value.used)
  ; metric compute.googleapis.com/reservation/reserved
    | group_by [metadata.system.name], sliding(1m), max(value.reserved) }
| ratio
| every 1m
| condition gt(val(), 0.9)
```
Important : Pour créer une condition d'alerte basée sur MQL, vous devez utiliser l'un des opérateurs suivants à la fin de votre requête :
- Pour les alertes de seuil, spécifiez condition.
- Pour les alertes d'absence, spécifiez absent_for.
La tentative d'exécution d'une requête sans l'un de ces opérateurs entraîne des erreurs. Pour en savoir plus, consultez la section sur les Opérations d'alerte MQL.
Pour exécuter la requête que vous venez de saisir, cliquez sur Exécuter la requête.
Cliquez sur Suivant.

Le volet Configurer le déclencheur d'alerte s'affiche.
Dans le champ Nom de la condition, saisissez un nom pour la condition.

Par exemple, saisissez Over 90% of your reservations are consumed..
Cliquez à nouveau sur Suivant.

Le volet Configurer les notifications et l'alerte de finalisation s'affiche.
Cliquez sur Utiliser les canaux de notification.
Dans le champ Canaux de notification, sélectionnez les canaux sur lesquels vous souhaitez recevoir une notification concernant l'incident.

Si vous n'avez pas de canaux de notification disponibles, cliquez sur Gérer les canaux de notification, puis suivez la procédure pour créer des canaux de notification. Pour en savoir plus, consultez la page Créer et gérer des canaux de notification.
Dans le champ Durée de fermeture automatique des incidents, sélectionnez une durée après laquelle un incident est automatiquement fermé.

Par exemple, sélectionnez 3 jours.
Dans le champ Nom de la règle d'alerte, saisissez un nom pour la règle d'alerte.

Par exemple, saisissez Alert: over 90% of your reservations are consumed..
Cliquez sur Suivant.

La page de vérification de la condition d'alerte s'affiche.
Cliquez sur Create policy (Créer une règle).

La création de la règle d'alerte peut prendre quelques secondes. Cette action vous renvoie à la page Créer une règle d'alerte.

Pour en savoir plus sur la création de règles d'alerte à l'aide de la console Google Cloud et du langage MQL, consultez la page Créer des règles d'alerte MQL (console).

REST

Pour créer une règle d'alerte Monitoring à l'aide du langage MQL, envoyez une requête POST à la méthode projects.alertPolicies.create.

POST https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alertPolicies

{
  "displayName": "Alert: over 90% of your reservations are consumed.",
  "conditions": [
    {
      "displayName": "Over 90% of your reservations are consumed.",
      "conditionMonitoringQueryLanguage": {
        "duration": "0s",
        "trigger": {
          "count": 1
        },
        "query": "MQL_QUERY"
      }
    }
  ],
  "alertStrategy": {
    "autoClose": "AUTO_CLOSE_TIME"
  },
  "combiner": "OR",
  "enabled": true,
  "notificationChannels": [
    "projects/PROJECT_ID/notificationChannels/NOTIFICATION_CHANNEL"
  ]
}

Remplacez les éléments suivants :

PROJECT_ID : ID du projet actuel.
MQL_QUERY : requête MQL à utiliser pour la règle d'alerte. Par exemple, pour créer une requête qui suit lorsque le pourcentage de VM utilisées est supérieur à 90 % dans les réservations du projet actuel, spécifiez les éléments suivants :
```
fetch compute.googleapis.com/Reservation
| { metric compute.googleapis.com/reservation/used
 | group_by [metadata.system.name], sliding(1m), max(value.used)
; metric compute.googleapis.com/reservation/reserved
 | group_by [metadata.system.name], sliding(1m), max(value.reserved) }
| ratio
| every 1m
| condition gt(val(), 0.9)
```
Important : Assurez-vous que :
- Pour spécifier une requête MQL couvrant plusieurs lignes dans le champ query, incluez le caractère \n à la fin de chaque ligne.
- Pour créer une condition d'alerte à l'aide d'une requête MQL, vous devez utiliser l'un des opérateurs suivants à la fin de votre requête :
  - Pour les alertes de seuil, spécifiez condition.
  - Pour les alertes d'absence, spécifiez absent_for.
  La tentative d'exécution d'une requête sans l'un de ces opérateurs entraîne des erreurs. Pour en savoir plus, consultez la section sur les Opérations d'alerte MQL.
AUTO_CLOSE_TIME : délai avant la fermeture automatique d'un incident (en secondes). La valeur doit être comprise entre 0s et 604800s (7 jours). Par exemple, saisissez 259200s (3 jours).
NOTIFICATION_CHANNEL : nom d'un canal de notification existant. Pour configurer un canal de notification, consultez la page Créer et gérer des canaux de notification.

Pour en savoir plus sur la création de règles d'alerte à l'aide de l'API Monitoring et du langage MQL, consultez la page Créer des règles d'alerte MQL (API).

Résoudre les problèmes

Découvrez comment résoudre les problèmes liés à la surveillance des réservations.

Étapes suivantes

Découvrez comment consommer des réservations.
Découvrez comment associer des réservations à des engagements.
Découvrez comment modifier des réservations.
Découvrez comment supprimer des réservations.