Gérer les règles de détection intelligente d’Application Insights à l’aide de modèles Azure Resource Manager
Notes
Vous pouvez migrer vos ressources Application Insights vers la détection intelligente avec alertes (préversion). La migration crée des règles d’alerte pour les différents modules de détection intelligente. Après avoir créé les règles, vous pouvez les gérer, puis les configurer comme n’importe quelle autre règle d’alerte d’Azure Monitor. Vous pouvez également configurer des groupes d’actions pour ces règles pour offrir plusieurs moyens de prendre des mesures ou de déclencher une notification en cas de nouvelles détections.
Pour plus d’informations sur le processus de migration et le comportement de la détection intelligente après la migration, consultez l’article Migration des alertes de détection intelligente.
Vous pouvez gérer et configurer des règles de détection intelligente dans Application Insights à l’aide de modèles Azure Resource Manager.
Vous pouvez utiliser cette méthode au moment de déployer de nouvelles ressources Application Insights avec l’automatisation Resource Manager ou lorsque vous modifiez les paramètres des ressources existantes.
Configuration de règle de détection intelligente
Vous pouvez configurer les paramètres suivants pour une règle de détection intelligente :
- Si la règle est activée. (La valeur par défaut est true.)
- Si les e-mails doivent être envoyés aux utilisateurs associés aux rôles Lecteur de surveillance et Contributeur de surveillance de l’abonnement à la suite d’une détection. (La valeur par défaut est true.)
- Les destinataires d’e-mails supplémentaires qui doivent recevoir une notification lorsqu’une détection est trouvée.
- La configuration relative aux e-mails n’est pas disponible pour les règles de détection intelligente marquées de la mention préversion.
Pour autoriser la configuration des paramètres de règle via Resource Manager, la configuration de règle de détection intelligente est désormais disponible en tant que ressource interne au sein de la ressource Application Insights. Elle est nommée ProactiveDetectionConfigs.
Pour une flexibilité maximale, vous pouvez configurer chaque règle de détection intelligente avec les paramètres de notification unique.
Exemples
Les exemples suivants montrent comment configurer les paramètres des règles de détection intelligente à l’aide de modèles Resource Manager.
Tous les exemples font référence à une ressource Application Insights nommée « myApplication ». Ils font également référence à la « règle de détection intelligente de longue durée des dépendances. Elle est nommée en interne « longdependencyduration ».
Assurez-vous de remplacer le nom de la ressource Application Insights et de spécifier le nom interne de règle de détection intelligente pertinente. Consultez le tableau suivant pour obtenir la liste des noms Resource Manager internes correspondants à chaque règle de détection intelligente.
Gérer des règles de détection intelligente
{
"apiVersion": "2018-05-01-preview",
"name": "myApplication",
"type": "Microsoft.Insights/components",
"location": "[resourceGroup().location]",
"properties": {
"Application_Type": "web"
},
"resources": [
{
"apiVersion": "2018-05-01-preview",
"name": "longdependencyduration",
"type": "ProactiveDetectionConfigs",
"location": "[resourceGroup().location]",
"dependsOn": [
"[resourceId('Microsoft.Insights/components', 'myApplication')]"
],
"properties": {
"name": "longdependencyduration",
"sendEmailsToSubscriptionOwners": true,
"customEmails": [],
"enabled": false
}
}
]
}
Désactiver l’envoi de notifications par e-mail pour une règle de détection intelligente
{
"apiVersion": "2018-05-01-preview",
"name": "myApplication",
"type": "Microsoft.Insights/components",
"location": "[resourceGroup().location]",
"properties": {
"Application_Type": "web"
},
"resources": [
{
"apiVersion": "2018-05-01-preview",
"name": "longdependencyduration",
"type": "ProactiveDetectionConfigs",
"location": "[resourceGroup().location]",
"dependsOn": [
"[resourceId('Microsoft.Insights/components', 'myApplication')]"
],
"properties": {
"name": "longdependencyduration",
"sendEmailsToSubscriptionOwners": false,
"customEmails": [],
"enabled": true
}
}
]
}
Ajouter des destinataires d’e-mail pour une règle de détection intelligente
{
"apiVersion": "2018-05-01-preview",
"name": "myApplication",
"type": "Microsoft.Insights/components",
"location": "[resourceGroup().location]",
"properties": {
"Application_Type": "web"
},
"resources": [
{
"apiVersion": "2018-05-01-preview",
"name": "longdependencyduration",
"type": "ProactiveDetectionConfigs",
"location": "[resourceGroup().location]",
"dependsOn": [
"[resourceId('Microsoft.Insights/components', 'myApplication')]"
],
"properties": {
"name": "longdependencyduration",
"sendEmailsToSubscriptionOwners": true,
"customEmails": ["alice@contoso.com", "bob@contoso.com"],
"enabled": true
}
}
]
}
Règles de détection intelligente
Le tableau suivant présente les noms de règles de détection intelligente tels qu’ils apparaissent dans le portail. Le tableau affiche également leurs noms internes à utiliser dans le modèle Resource Manager.
Notes
Les règles de détection intelligente en préversion ne prennent pas en charge les notifications par e-mail. Vous pouvez uniquement définir la propriété activée pour ces règles.
| Nom de la règle du portail Azure | Nom interne |
|---|---|
| Durée de chargement de page lente | slowpageloadtime |
| Temps de réponse du serveur lent | slowserverresponsetime |
| Durée de dépendance longue | longdependencyduration |
| Dégradation du temps de réponse du serveur | degradationinserverresponsetime |
| Dégradation de la durée de dépendance | degradationindependencyduration |
| Dégradation du rapport entre les niveaux de gravité des suivis (préversion) | extension_traceseveritydetector |
| Élévation anormale du volume des exceptions (préversion) | extension_exceptionchangeextension |
| Fuite de mémoire potentielle détectée (préversion) | extension_memoryleakextension |
| Problème de sécurité potentiel détecté (préversion) | extension_securityextensionspackage |
| Élévation anormale du volume de données quotidien (préversion) | extension_billingdatavolumedailyspikeextension |
Règle d’alerte Anomalies des échecs
Ce modèle Resource Manager montre comment configurer une règle d’alerte pour les défaillances avec un niveau de gravité de 2.
Notes
Les Anomalies des échecs sont un service global. Par conséquent, l’emplacement de la règle est créé sur l’emplacement global.
{
"$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"resources": [
{
"type": "microsoft.alertsmanagement/smartdetectoralertrules",
"apiVersion": "2019-03-01",
"name": "Failure Anomalies - my-app",
"location": "global",
"properties": {
"description": "Failure Anomalies notifies you of an unusual rise in the rate of failed HTTP requests or dependency calls.",
"state": "Enabled",
"severity": "2",
"frequency": "PT1M",
"detector": {
"id": "FailureAnomaliesDetector"
},
"scope": ["/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/MyResourceGroup/providers/microsoft.insights/components/my-app"],
"actionGroups": {
"groupIds": ["/subscriptions/00000000-1111-2222-3333-444444444444/resourcegroups/MyResourceGroup/providers/microsoft.insights/actiongroups/MyActionGroup"]
}
}
}
]
}
Notes
Ce modèle Resource Manager est spécifique à la règle d’alerte Anomalies des échecs et il est différent des autres règles de détection intelligente classiques décrites dans cet article. Si vous souhaitez gérer manuellement les anomalies d’échec, utilisez les alertes Azure Monitor. Toutes les autres règles de détection intelligente sont gérées dans le volet Détection intelligente de l’interface utilisateur.
Étapes suivantes
En savoir plus sur la détection automatique :