Gérer les règles de détection intelligente d’Application Insights à l’aide de modèles Azure Resource Manager

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.

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.

{
    "$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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/MyResourceGroup/providers/microsoft.insights/components/my-app"],
                  "actionGroups": {
                        "groupIds": ["/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/MyResourceGroup/providers/microsoft.insights/actiongroups/MyActionGroup"]
                  }
            }
        }
    ]
}

Étapes suivantes

En savoir plus sur la détection automatique :

• Défaillances
• Fuites de mémoire
• Anomalies de performance