Gerenciar regras de detecção inteligente do Application Insights usando modelos do Azure Resource Manager
Observação
É possível migrar seus recursos do Application Insights para a detecção inteligente com base em alertas (versão prévia). A migração cria regras de alerta para os diferentes módulos de detecçã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ção para essas regras para habilitar vários métodos para executar ações ou disparar notificações sobre novas detecções.
Para obter mais informações sobre o processo de migração e o comportamento da detecção inteligente após a migração, confira Migração de alertas da detecção inteligente.
Você pode gerenciar e configurar as regras de detecção inteligente no Application Insights usando modelos do Azure Resource Manager.
Você pode usar esse método ao implantar novos recursos do Application Insights com a automação do Resource Manager ou ao modificar as configurações dos recursos existentes.
Configuração da regra de detecção inteligente
É possível definir as seguintes configurações para uma regra de detecção inteligente:
- Se a regra estiver habilitada. (O padrão é true.)
- Se emails devem ser enviados aos usuários associados a funções de Leitor de monitoramento e Colaborador de monitoramento da assinatura quando uma detecção é encontrada. (O padrão é true.)
- Quaisquer outros destinatários de email que devem receber uma notificação quando uma detecção for encontrada.
- A configuração de email não está disponível para regras de Detecção Inteligente marcadas como versão prévia.
Para permitir a definição das configurações da regra por meio do Resource Manager, a configuração da regra de detecção inteligente está disponível como um recurso interno dentro do recurso do Application Insights. Ele se chama ProactiveDetectionConfigs.
Para máxima flexibilidade, você pode configurar cada regra de detecção inteligente com configurações de notificação exclusivas.
Exemplos
Os exemplos a seguir mostram como definir as configurações das regras de detecção inteligente usando modelos do Resource Manager.
Todos os exemplos referem-se a um recurso do Application Insights chamado "myApplication". Eles também se referem à "regra de detecção inteligente de duração de dependência longa". Ela é chamada internamente de "longdependencyduration".
Certifique-se de substituir o nome de recurso do Application Insights e especificar o nome interno da regra de detecção inteligente relevante. Verifique a tabela a seguir para obter uma lista dos nomes internos correspondentes do Resource Manager para cada regra de detecção inteligente.
Desabilitar uma regra de detecçã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
}
}
]
}
Desabilitar o envio de notificações de email para uma regra de detecçã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 email para uma regra de detecçã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 das regras de detecção inteligente
A tabela a seguir mostra os nomes de regras de detecção inteligente conforme eles aparecem no portal. A tabela também mostra seus nomes internos a serem usados no modelo do Resource Manager.
Observação
As regras de detecção inteligente marcadas como versão preliminar não dão suporte a notificações por email. Somente é possível definir a propriedade habilitado para essas regras.
| Nome da regra do portal do Azure | Nome interno |
|---|---|
| Tempo de carregamento de página lento | slowpageloadtime |
| Tempo de resposta do servidor lento | slowserverresponsetime |
| Duração da dependência longa | longdependencyduration |
| Degradação no tempo de resposta do servidor | degradationinserverresponsetime |
| Degradação na duração da dependência | Degradação na duração da dependência |
| Degradação na taxa de gravidade de rastreamento (visualização) | extension_traceseveritydetector |
| Aumento anormal no volume de exceção (visualização) | extension_exceptionchangeextension |
| Potencial perda de memória detectada (visualização) | extension_memoryleakextension |
| Potencial problema de segurança detectado (visualização) | extension_securityextensionspackage |
| Aumento anormal no volume de dados diários (versão preliminar) | 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.
Observação
As anomalias de falha são um serviço global, portanto, o local da regra é criado 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/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"]
}
}
}
]
}
Observação
Esse modelo do Resource Manager é exclusivo para a regra de alerta de anomalias de falha e é diferente das outras regras de detecção inteligente clássicas descritas neste artigo. Se você quiser gerenciar anomalias de falha manualmente, use alertas do Azure Monitor. Todas as outras regras de detecção inteligente são gerenciadas no painel Detecção Inteligente da interface do usuário.
Próximas etapas
Saiba mais sobre como detectar automaticamente: