Partilhar via


Gerenciar regras de deteção inteligente do Application Insights usando modelos do Azure Resource Manager

Nota

Você pode migrar seus recursos do Application Insight para a deteção inteligente baseada em alertas (visualização). A migração cria regras de alerta para os diferentes módulos da deteção inteligente. Depois de criar as regras, você pode gerenciá-las e configurá-las como qualquer outra regra de alerta do Azure Monitor. Você também pode configurar grupos de ações para essas regras para habilitar vários métodos de execução de ações ou disparo de notificação em novas deteções.

Para obter mais informações sobre o processo de migração e o comportamento da deteção inteligente após a migração, consulte Migração de alertas de deteção inteligente.

Você pode gerenciar e configurar regras de deteção inteligentes no Application Insights usando modelos do Azure Resource Manager.

Você pode usar esse método ao implantar novos recursos do Application Insights com automação do Resource Manager ou ao modificar as configurações de recursos existentes.

Configuração inteligente da regra de deteção

Pode configurar as seguintes definições para uma regra de deteção inteligente:

  • Se a regra estiver ativada. (O padrão é true.)
  • Se os e-mails devem ser enviados para usuários associados às funções de Leitor de Monitoramento e Colaborador de Monitoramento da assinatura quando uma deteção for encontrada. (O padrão é true.)
  • Quaisquer outros destinatários de e-mail que devem receber uma notificação quando uma deteção for encontrada.
    • A configuração de e-mail não está disponível para regras de deteção inteligentes marcadas como visualização.

Para permitir a configuração das configurações de regra por meio do Gerenciador de Recursos, a configuração da regra de deteção inteligente está disponível como um recurso interno dentro do recurso do Application Insights. Chama-se ProactiveDetectionConfigs.

Para máxima flexibilidade, você pode configurar cada regra de deteção inteligente com configurações de notificação exclusivas.

Exemplos

Os exemplos a seguir mostram como definir as configurações de regras de deteção inteligentes usando modelos do Gerenciador de Recursos.

Todos os exemplos referem-se a um recurso do Application Insights chamado "myApplication". Eles também se referem à "regra de deteção inteligente de longa duração de dependência". É chamado internamente de "longdependencyduration".

Certifique-se de substituir o nome do recurso do Application Insights e especificar o nome interno da regra de deteção inteligente relevante. Verifique na tabela a seguir uma lista dos nomes internos correspondentes do Gerenciador de Recursos para cada regra de deteção inteligente.

Desativar uma regra de deteção inteligente

{
      "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
          }
        }
      ]
    }

Desativar o envio de notificações por e-mail para uma regra de deteção inteligente

{
      "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
          }
        }
      ]
    }

Adicionar mais destinatários de e-mail para uma regra de deteção inteligente

{
      "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
          }
        }
      ]
    }

Nomes de regras de deteção inteligentes

A tabela a seguir mostra os nomes das regras de deteção inteligentes conforme aparecem no portal. A tabela também mostra seus nomes internos para usar no modelo do Gerenciador de Recursos.

Nota

As regras de deteção inteligentes marcadas como pré-visualização não suportam notificações por e-mail. Você só pode definir a propriedade enabled para essas regras.

Nome da regra do portal do Azure Nome interno
Tempo de carregamento lento da página SlowPageLoadTime
Tempo de resposta lento do servidor slowserverresponsetime
Longa duração da dependência Longa Duração da Dependência
Degradação no tempo de resposta do servidor degradationinserverresponsetime
Degradação da duração da dependência degradaçãoindependencyduration
Degradação na taxa de severidade do traço (visualização) extension_traceseveritydetector
Aumento anormal do volume de exceções (pré-visualização) extension_exceptionchangeextension
Potencial fuga de memória detetada (pré-visualização) extension_memoryleakextension
Possível problema de segurança detetado (visualização) extension_securityextensionspackage
Aumento anormal do volume diário de dados (pré-visualização) extension_billingdatavolumedailyspikeextension

Regra de alerta de anomalias de falha

Este modelo do Resource Manager demonstra como configurar uma regra de alerta de Anomalias de Falha com uma gravidade de 2.

Nota

Anomalias de falha é um serviço global, portanto, a localização da regra é criada no local 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/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"]
                  }
            }
        }
    ]
}

Nota

Este modelo do Resource Manager é exclusivo para a regra de alerta Anomalias de Falha e é diferente das outras regras clássicas de deteção inteligente descritas neste artigo. Se você quiser gerenciar Anomalias de Falha manualmente, use os alertas do Azure Monitor. Todas as outras regras de deteção inteligente são gerenciadas no painel Deteção inteligente da interface do usuário.

Próximos passos

Saiba mais sobre como detetar automaticamente: