Configurer des alertes

  • 6 minutes

Azure Cosmos DB utilise le Service Azure Monitor pour configurer et envoyer des alertes. Les alertes supervisent la disponibilité et la réactivité des ressources Azure Cosmos DB, et envoient une notification quand des métriques surveillées atteignent des seuils spécifiés. Les alertes peuvent prendre la forme d’e-mails ou même exécuter Azure Functions lorsqu’elles sont déclenchés. Les alertes surveillent également les événements du journal d’activité de votre compte Azure Cosmos DB.

Les alertes peuvent être configurées à partir de la page de votre compte Azure Cosmos DB ou à partir de Azure Monitor. À partir des deux emplacements, vous allez configurer les alertes de la même manière.

Configuration d’une alerte

Examinons un exemple de définition d’alertes lorsque plus de mille429 exceptions sont déclenchées dans un délai de 15 minutes. L’alerte doit vérifier toutes les 5 minutes pour la condition. Enfin, elle doit envoyer un e-mail à admins@contoso.com lorsque la condition est remplie.

  1. Dans la page de votre compte Azure Cosmos DB, sous la section Surveillance, choisissez Alertes.

  2. Sélectionnez + Créer, puis Règle d’alerte pour créer une alerte. Votre compte Azure Cosmos DB actuel, votre abonnement et votre groupe de ressources sont en principe déjà sélectionnés.

  3. Sélectionnez Ajouter une condition. Cette condition définit le déclencheur pour cette alerte.

    1. Durée de sélection du type de signal. Les signaux sont des métriques ou des journaux d’activité. Comme 429 exceptions peuvent se produire lorsque des requêtes sont effectuées, recherchez le nom du signal Nombre total d’unités de requête. Nous devrions voir un graphique qui nous indique le nombre total d’unités de requête au cours des 6 dernières heures.

    2. Actuellement, si vous ajoutez une logique d’alerte, elle est mesurée par rapport à toutes les unités de requête de ce compte. Ce dont vous avez besoin, c’est uniquement de créer une condition sur les demandes qui ont renvoyé le code d’État 429. Pour créer ce filtre, sous Fractionner par dimension , choisissez :

      1. Sélectionnez StatusCode sous le menu déroulant StatusCode .

      2. Sélectionnez = sous =.

      3. Si une exception 429 s’est produite au cours des 6 dernières heures, vous pouvez la voir sous les options Valeurs de dimension . Si 429 n’est pas une option sous Valeurs de dimension, sélectionnez Ajouter une valeur personnalisée et ajoutez la valeur 429. Vous pouvez ajouter des filtres supplémentaires tels que base de données, collection, région ou type d’opération si vous avez besoin d’un filtre encore plus précis.

    3. Définissez la valeur Logique d’alerteSeuil sur 1000.

    4. Sous Évaluée en fonction de, définissez la Granularité de l’agrégation (période) sur 15 minutes et la Fréquence de l’évaluation sur 5 minutes.

    5. Sélectionnez Terminé pour achever la configuration de la Condition .

  4. L’alerte doit savoir ce qu’il faut faire lorsque la condition est remplie. Nous allons envoyer l’e-mail. Sous Actions, sélectionnez Ajouter des groupes d’actions.

    1. Si vous avez déjà créé des actions, vous pouvez les réutiliser. Nous allons créer une Action, sélectionner + Créer un groupe d’actions.

    2. Sous l’onglet De base :

      1. Donnez un nom au groupe d’actions.

      2. Si nécessaire, modifiez le nom d’Affichage.

    3. Cliquez sur l'onglet Notification :

      1. Sous Type de notification, choisissez E-mail/SMS/Push/Voice.

      2. Donnez un Nomà la Notification.

      3. Sélectionnez l'icône crayon pour ajouter le destinataire de la notification.

        1. Sélectionnez la case E-mail.

        2. Définissez E-mail sur admins@contoso.com, puis sélectionnez OK.

    4. Sélectionnez le bouton Vérifier + créer, puis cliquez sur le bouton Créer

  5. Enfin, vous devez renseigner les informations générales de l’alerte dans les détails de la règle d’alerte. Vous pouvez modifier les options présélectionnées en fonction des besoins, mais vous devez au moins définir le Nom de la règle d’alerte, par conséquent, attribuez un nom à l’alerte.

  6. Sélectionnez Créer une règle d’alerte pour créer la règle d’alerte.

Une fois l’alerte créée, l’activation peut prendre jusqu’à 10 minutes.

Scénarios d’alerte courants

Voici quelques scénarios dans lesquels vous pouvez utiliser les alertes :

  • Lorsque les clés d’un compte Azure Cosmos sont mises à jour.
  • Quand l’utilisation des données ou des index par un conteneur, une base de données ou une région dépasse un certain nombre d’octets.
  • Quand la consommation de RU/s normalisée est supérieure à un certain pourcentage.
  • Quand une région est ajoutée, supprimée ou passe hors connexion.
  • Lorsqu’une base de données ou un conteneur est créé, supprimé ou mis à jour.
  • Quand le débit de votre base de données ou de votre conteneur est modifié.