Procédure : Configurer des alertes et obtenir des notifications à l’aide d’un hook

Une fois qu’une anomalie a été détectée par Metrics Advisor, une notification d’alerte est déclenchée à l’aide d’un hook en fonction des paramètres d’alerte. Un paramètre d’alerte peut être utilisé avec plusieurs configurations de détection, différents paramètres étant disponibles pour personnaliser votre règle d’alerte.

Créer un hook

Metrics Advisor prend en charge quatre types de hooks différents : e-mail, Teams, webhook et Azure DevOps. Vous pouvez choisir celui qui fonctionne pour votre scénario spécifique.

Hook par e-mail

Un hook d’e-mail est le canal des alertes d’anomalies à envoyer aux adresses e-mail spécifiées dans la section E-mail à. Deux types d’e-mails d’alerte sont envoyés : Des alertes Le flux de données n’est pas disponible et des Rapports d’incidents qui contiennent une ou plusieurs anomalies.

Pour créer un hook d’e-mail, les paramètres suivants sont disponibles :

Une fois que vous avez sélectionné OK, un hook d’e-mail est créé. Vous pouvez l’utiliser dans n’importe quel paramètre d’alerte pour recevoir des alertes d’anomalie. Pour obtenir des instructions détaillées, consultez le tutoriel relatif à l’activation des notifications d’anomalies dans Metrics Advisor.

Raccordement Teams

Un hook Teams est le canal d’envoi des alertes d’anomalies à un canal dans Microsoft Teams. Un hook Teams est implémenté par le biais d’un connecteur « Webhook entrant ». Vous devrez peut-être créer un connecteur « Webhook entrant » à l’avance dans votre canal Teams cible et obtenir son URL. Ensuite, revenez à l’espace de travail Metrics Advisor.

Sélectionnez l’onglet « Hooks » dans la barre de navigation de gauche, puis sélectionnez le bouton « Créer un hook » en haut à droite de la page. Choisissez le type de hook « Teams ». Les paramètres suivants sont fournis :

Une fois que vous avez sélectionné OK, un hook Teams est créé. Vous pouvez l’utiliser dans n’importe quel paramètre d’alerte pour notifier le canal Teams cible des alertes d’anomalies. Pour obtenir des instructions détaillées, consultez le tutoriel relatif à l’activation des notifications d’anomalies dans Metrics Advisor.

Webhook

Un webhook est un autre canal de notification utilisant un point de terminaison fourni par le client. Toute anomalie détectée sur la série chronologique est notifiée par le biais d’un webhook. Plusieurs étapes sont nécessaires pour activer un webhook en tant que canal de notification d’alerte dans Metrics Advisor.

Étape 1. Activer l’identité managée dans votre ressource Metrics Advisor

Une identité managée affectée par le système est limitée à une par ressource et liée au cycle de vie de celle-ci. Pour accorder des autorisations à l’identité managée, vous pouvez utiliser le contrôle d’accès en fonction du rôle (RBAC) Azure. L’identité managée est authentifiée avec Microsoft Entra ID. Vous n’avez donc pas besoin de stocker des informations d’identification dans le code.

Accédez à la ressource Metrics Advisor dans le portail Azure, sélectionnez « Identité », activez cette option. L’identité managée est alors activée.

Étape 2. Créer un webhook dans l’espace de travail Metrics Advisor

Connectez-vous à votre espace de travail et sélectionnez l’onglet « Hooks », puis le bouton « Créer un hook ».

Pour créer un webhook, vous devrez ajouter les informations suivantes :

• La méthode de demande est POST
• Délai d’attente 30 s
• Réessayer en cas d’erreur 5xx, ignorer les autres erreurs. Ne suivra pas la demande de redirection 301/302.
• Corps de la demande :

{
"value": [{
	"hookId": "b0f27e91-28cf-4aa2-aa66-ac0275df14dd",
	"alertType": "Anomaly",
	"alertInfo": {
		"anomalyAlertingConfigurationId": "1bc6052e-9a2a-430b-9cbd-80cd07a78c64",
		"alertId": "172536dbc00",
		"timestamp": "2020-05-27T00:00:00Z",
		"createdTime": "2020-05-29T10:04:45.590Z",
		"modifiedTime": "2020-05-29T10:04:45.590Z"
	},
	"callBackUrl": "https://kensho2-api.azurewebsites.net/alert/anomaly/configurations/1bc6052e-9a2a-430b-9cbd-80cd07a78c64/alerts/172536dbc00/incidents"
}]
}

Étape 3. (facultatif) Stocker votre certificat dans les coffres de clés Azure et obtenir l’identificateur. Comme indiqué, si l’accès au point de terminaison doit être authentifié par un certificat, celui-ci doit être stocké dans les coffres de clés Azure.

• Consultez Définir et récupérer un certificat dans Azure Key Vault à l’aide du portail Azure
• Sélectionnez le certificat que vous avez ajouté pour copier « l’identificateur de certificat ».
• Sélectionnez ensuite « Stratégies d’accès » et « Ajouter une stratégie d’accès », accordez l’autorisation « get » pour « Autorisations de clé », « Autorisations de secret » et « Autorisations de certificat ». Sélectionnez principal comme nom de votre ressource Metrics Advisor. Sélectionnez « Ajouter » et le bouton « Enregistrer » dans la page « Stratégies d’accès ».

Étape 4. Recevoir une notification d’anomalie. Quand une notification est envoyée via un webhook, vous pouvez récupérer les données des incidents en appelant la requête de webhook « callBackUrl ». Détails pour cette API :

• /alert/anomaly/configurations/{configurationId}/alerts/{alertId}/incidents

En utilisant un webhook et Azure Logic Apps, il est possible d’envoyer une notification par e-mail sans qu’un serveur SMTP soit configuré. Pour obtenir des instructions détaillées, consultez le tutoriel relatif à l’activation des notifications d’anomalies dans Metrics Advisor.

Azure DevOps

Metrics Advisor prend également en charge la création automatique d’un élément de travail dans Azure DevOps pour suivre les problèmes/bogues quand une anomalie est détectée. Toutes les alertes peuvent être envoyées via des hooks DevOps.

Pour créer un hook Azure DevOps, vous devrez ajouter les informations suivantes

Ajouter ou modifier des paramètres d’alerte

Accédez à la page de détails des métriques pour y rechercher la section Paramètres d’alerte en bas à gauche. Elle répertorie tous les paramètres d’alerte qui s’appliquent à la configuration de détection sélectionnée. Lorsqu’une nouvelle configuration de détection est créée, il n’existe aucun paramètre d’alerte et aucune alerte n’est envoyée.
Vous pouvez utiliser les icônes Ajouter, Modifier et Supprimer pour modifier les paramètres d’alerte.

Sélectionnez le bouton ajouter ou modifier pour obtenir une fenêtre permettant d’ajouter ou de modifier vos paramètres d’alerte.

Nom du paramètre d’alerte : nom du paramètre d’alerte. Il s’affichera dans le titre de l’e-mail d’alerte.

Hooks : liste des hooks auxquels envoyer des alertes.

La section marquée dans la capture d’écran ci-dessus est celle des paramètres pour une configuration de détection. Vous pouvez définir différents paramètres d’alerte pour différentes configurations de détection. Choisissez la configuration cible à l’aide de la troisième liste déroulante dans cette fenêtre.

Paramètres du filtre

Voici les paramètres de filtre pour une configuration de détection.

Alerte pour a quatre options pour filtrer les anomalies :

• Anomalies dans toutes les séries : toutes les anomalies seront incluses dans l’alerte.
• Anomalies dans le groupe de séries : filtrer les séries par valeurs de dimension. Définir des valeurs spécifiques pour certaines dimensions. Les anomalies ne seront incluses dans l’alerte que si la série correspond à la valeur spécifiée.
• Anomalies dans les séries de favoris : seule la série marquée comme favori sera incluse dans l’alerte. |
• Anomalies dans les N premières séries : ce filtre doit être utilisé si vous vous intéressez uniquement à la série dont la valeur se trouve parmi les N premières. Metrics Advisor va examiner certains horodatages précédents et vérifier si la valeur de la série sur ces horodatages est dans les N premières. Si le nombre de « dans les n premières » est supérieur au nombre spécifié, l’anomalie sera incluse dans une alerte. |

Les options de filtre d’anomalie constituent un filtre supplémentaire qui offre les options suivantes :

• Gravité : l’anomalie sera incluse uniquement si la gravité de l’anomalie est comprise dans la plage spécifiée.
• Répéter : arrête temporairement les alertes pour les anomalies aux N points suivants (période) lorsqu’elles sont déclenchées dans une alerte.
  • Type de répétition : lorsqu’elle est définie sur Série, une anomalie déclenchée se répétera uniquement dans sa série. Pour Métrique, une anomalie déclenchée se répétera dans toutes les séries de cette mesure.
  • Nombre de répétitions : nombre de points (périodes) à répéter.
  • Réinitialiser pour une anomalie non consécutive : lorsque cette option est sélectionnée, une anomalie déclenchée ne répétera que les n anomalies successives suivantes. Si l’un des points de données suivants n’est pas une anomalie, la répétition sera réinitialisée à partir de ce point. Lorsqu’elle est désélectionnée, une anomalie déclenchée se répétera pour les n points suivants (période), même si les points de données successifs ne sont pas des anomalies.
• Valeur (facultatif) : filtrer par valeur. Uniquement les valeurs de points qui remplissent la condition, l’anomalie sera incluse. Si vous utilisez la valeur correspondante d’une autre mesure, les noms des dimensions des deux métriques doivent être cohérents.

Les anomalies non éliminées par le filtrage sont envoyées dans une alerte.

Ajouter des paramètres de métriques croisées

Sélectionnez + Ajouter des paramètres de métriques dans la page Paramètres d’alerte pour ajouter une autre section.

Le sélecteur d’Opérateur est la relation logique de chaque section pour déterminer si une alerte doit être envoyée.

Étapes suivantes

• Ajustement de la détection d’anomalie selon les commentaires
• Diagnostiquer un incident.
• Configurer des métriques et affiner la configuration de la détection