Migrar a deteção inteligente do Azure Monitor Application Insights para alertas (visualização)

Artigo
11/05/2024

Este artigo descreve o processo de migração da deteção inteligente do Application Insights para alertas. A migração cria regras de alerta para os diferentes módulos da deteção inteligente. Você pode gerenciar e configurar essas regras como qualquer outra regra de alerta do Azure Monitor. Você também pode configurar grupos de ações para essas regras para obter vários métodos de ações ou notificações sobre novas deteções.

Benefícios da migração para alertas

Com a migração, a deteção inteligente agora permite que você aproveite todos os recursos dos alertas do Azure Monitor, incluindo:

Opções avançadas de notificação para todos os detetores: use grupos de ação para configurar vários tipos de notificações e ações que são acionadas quando um alerta é disparado. Você pode configurar notificações por e-mail, SMS, chamada de voz ou notificações push. Você pode configurar ações como chamar um webhook seguro, aplicativo lógico e runbook de automação. Os grupos de ação promovem o gerenciamento em escala, permitindo que você configure as ações uma vez e use-as em várias regras de alerta.
Gerenciamento em escala: os alertas de deteção inteligentes usam a experiência e a API de alertas do Azure Monitor.
Supressão de notificações baseada em regras: use regras de ação para definir ou suprimir ações em qualquer escopo do Azure Resource Manager, como assinatura do Azure, grupo de recursos ou recurso de destino. Os filtros ajudam a restringir o subconjunto específico de instâncias de alerta nas quais você deseja agir.

Recursos de deteção inteligente migrados

Um novo conjunto de regras de alerta é criado quando você migra um recurso do Application Insights. Uma regra é criada para cada um dos recursos de deteção inteligente migrados. A tabela a seguir mapeia os recursos de deteção inteligente pré-migração para regras de alerta pós-migração.

Nome ^{da regra de deteção inteligente (1)}	Nome da regra ^{de alerta (2)}
Degradação no tempo de resposta do servidor	Degradação da latência de resposta - <Nome do recurso do Application Insights>
Degradação da duração da dependência	Degradação da latência de dependência - <Nome do recurso do Application Insights>
Degradação na taxa de severidade do traço (visualização)	Degradação da gravidade do rastreamento - <Nome do recurso do Application Insights>
Aumento anormal do volume de exceções (pré-visualização)	Anomalias de exceção - <Nome do recurso do Application Insights>
Potencial fuga de memória detetada (pré-visualização)	Possível fuga de memória - <Nome do recurso do Application Insights>
Tempo de carregamento lento da página	Não é mais suportado ⁽³⁾
Tempo de resposta lento do servidor	Não é mais suportado ⁽³⁾
Longa duração da dependência	Não é mais suportado ⁽³⁾
Possível problema de segurança detetado (visualização)	Não é mais suportado ⁽³⁾
Aumento anormal do volume diário de dados (pré-visualização)	Não é mais suportado ⁽³⁾

⁽¹⁾ O nome da regra tal como aparece no painel Definições de deteção inteligente.
⁽²⁾ O nome da nova regra de alerta após a migração.
⁽³⁾ Esses recursos de deteção inteligente não são convertidos em alertas devido ao baixo uso e à reavaliação da eficácia da deteção. Esses detetores não serão mais suportados para este recurso depois que sua migração for concluída.

Nota

O detetor inteligente de anomalias de falha já foi criado como uma regra de alerta e não requer migração. Não é discutido neste artigo.

A migração não altera o design algorítmico e o comportamento da deteção inteligente. O mesmo desempenho de deteção é esperado antes e depois da alteração.

Você precisa aplicar a migração a cada recurso do Application Insights separadamente. Para recursos que não são migrados explicitamente, a deteção inteligente continuará a funcionar como antes.

Configuração do grupo de ação para as novas regras de alerta de deteção inteligente

Como parte da migração, cada nova regra de alerta é configurada automaticamente com um grupo de ações. A migração pode atribuir um grupo de ações padrão para cada regra. O grupo de ações padrão é configurado de acordo com a notificação de regra antes da migração:

Se a regra de deteção inteligente tiver o email padrão ou nenhuma notificação configurada, a nova regra de alerta será configurada com um grupo de ações chamado Deteção inteligente do Application Insights.
- Se a ferramenta de migração encontrar um grupo de ações existente com esse nome, ela vinculará a nova regra de alerta a esse grupo de ações.
- Caso contrário, ele criará um novo grupo de ações com esse nome. O novo grupo está configurado para ações de Função do Azure Resource Manager de Email e envia notificação aos usuários do Azure Resource Manager Monitoring Contributor e Monitoring Reader.
Se a notificação por e-mail padrão tiver sido alterada antes da migração, um grupo de ações chamado Application Insights Smart Detection <n> será criado, com uma ação de email enviando notificações para os endereços de e-mail configurados anteriormente.

Em vez de usar o grupo de ações padrão, selecione um grupo de ações existente que será configurado para todas as novas regras de alerta.

Execute o processo de migração de deteção inteligente

Use o portal do Azure, a CLI do Azure ou os modelos do Azure Resource Manager (modelos ARM) para executar a migração.

Migrar sua deteção inteligente usando o portal do Azure

Para migrar a deteção inteligente em seu recurso:

Selecione Deteção inteligente sob o título Investigar no recurso do Application Insights.
Selecione o banner que lê Migrar deteção inteligente para alertas (Visualização). A caixa de diálogo de migração é exibida.
Selecione a opção Migrar todos os recursos do Application Insights nesta assinatura . Ou você pode deixar a opção desmarcada se quiser migrar apenas o recurso atual em que está.

Nota

Selecionar essa opção afeta todos os recursos existentes do Application Insights que ainda não foram migrados. Enquanto a migração para alertas estiver em visualização, novos recursos do Application Insights ainda serão criados com deteção inteligente sem alertas.
Selecione um grupo de ações a ser configurado para as novas regras de alerta. Você pode usar o grupo de ações padrão conforme explicado ou usar um dos grupos de ação existentes.
Selecione Migrar para iniciar o processo de migração.

Após a migração, novas regras de alerta são criadas para seu recurso do Application Insight, conforme explicado.

Migrar sua deteção inteligente usando a CLI do Azure

Inicie a migração de deteção inteligente usando o seguinte comando da CLI do Azure. O comando aciona o processo de migração pré-configurado conforme descrito anteriormente.

az rest --method POST --uri /subscriptions/{subscriptionId}/providers/Microsoft.AlertsManagement/migrateFromSmartDetection?api-version=2021-01-01-preview --body @body.txt

Para migrar um único recurso do Application Insights, body.txt deve incluir:

{
      "scope": [
"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/components/{resourceName}"
      ],
      "actionGroupCreationPolicy" : "{Auto/Custom}",
      "customActionGroupName" : "{actionGroupName}"           
}

Para migrar todos os recursos do Application Insights em uma assinatura, body.txt deve incluir:

{
      "scope": [
	"/subscriptions/{subscriptionId} "
      ],
      "actionGroupCreationPolicy" : "{Auto/Custom}",
      "customActionGroupName" : "{actionGroupName}"           
}

O ActionGroupCreationPolicy parâmetro seleciona a política para migrar as configurações de e-mail nas regras de deteção inteligente para grupos de ação. Os valores permitidos são:

Automático: usa os grupos de ações padrão conforme descrito neste documento.
Personalizado: cria todas as regras de alerta com o grupo de ações especificado em customActionGroupName.
<blank>: Se ActionGroupCreationPolicy não for especificado, a Auto política será usada.

Migre sua deteção inteligente usando modelos ARM

Você pode acionar a migração de deteção inteligente para alertas para um recurso específico do Application Insights usando modelos ARM. Para usar esse método, você precisa:

Crie uma regra de alerta de deteção inteligente para cada um dos detetores suportados.
Modifique as propriedades do Application Insight para indicar que a migração foi concluída.

Com esse método, você pode controlar quais regras de alerta criar, definir seu próprio nome e descrição da regra de alerta e selecionar qualquer grupo de ações desejado para cada regra.

Use os seguintes modelos para essa finalidade. Edite-os conforme necessário para fornecer sua ID de assinatura e o nome do recurso do Application Insights.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
	"parameters": {
		"applicationInsightsResourceName": {
			"type": "string"
		},
		"actionGroupName": {
			"type": "string",
			"defaultValue": "Application Insights Smart Detection"
		},
		"actionGroupResourceGroup": {
			"type": "string",
			"defaultValue": "[resourceGroup().Name]"
		}
	},
	"variables": {
		"applicationInsightsResourceId": "[concat('/subscriptions/',subscription().subscriptionId,'/resourceGroups/',resourceGroup().Name,'/providers/microsoft.insights/components/',parameters('applicationInsightsResourceName'))]",
		"actionGroupId": "[concat('/subscriptions/',subscription().subscriptionId,'/resourceGroups/',parameters('actionGroupResourceGroup'),'/providers/microsoft.insights/ActionGroups/',parameters('actionGroupName'))]",
		"requestPerformanceDegradationDetectorRuleName": "[concat('Response Latency Degradation - ', parameters('applicationInsightsResourceName'))]",
		"dependencyPerformanceDegradationDetectorRuleName": "[concat('Dependency Latency Degradation - ', parameters('applicationInsightsResourceName'))]",
		"traceSeverityDetectorRuleName": "[concat('Trace Severity Degradation - ', parameters('applicationInsightsResourceName'))]",
		"exceptionVolumeChangedDetectorRuleName": "[concat('Exception Anomalies - ', parameters('applicationInsightsResourceName'))]",
		"memoryLeakRuleName": "[concat('Potential Memory Leak - ', parameters('applicationInsightsResourceName'))]"
	},
	"resources": [
		{
			"name": "[variables('requestPerformanceDegradationDetectorRuleName')]",
			"type": "Microsoft.AlertsManagement/smartdetectoralertrules",
			"location": "global",
			"apiVersion": "2019-03-01",
			"properties": {
				"description": "Response Latency Degradation notifies you of an unusual increase in latency in your app response to requests.",
				"state": "Enabled",
				"severity": "Sev3",
				"frequency": "PT24H",
				"detector": {
					"id": "RequestPerformanceDegradationDetector"
				},
				"scope": [
					"[variables('applicationInsightsResourceId')]"
				],
				"actionGroups": {	
					"groupIds": [
						"[variables('actionGroupId')]"
					]
				}
			}
		},
		{
			"name": "[variables('dependencyPerformanceDegradationDetectorRuleName')]",
			"type": "Microsoft.AlertsManagement/smartdetectoralertrules",
			"location": "global",
			"apiVersion": "2019-03-01",
			"properties": {
				"description": "Dependency Latency Degradation notifies you of an unusual increase in response by a dependency your app is calling (e.g. REST API or database)",
				"state": "Enabled",
				"severity": "Sev3",
				"frequency": "PT24H",
				"detector": {
					"id": "DependencyPerformanceDegradationDetector"
				},
				"scope": [
					"[variables('applicationInsightsResourceId')]"
				],
				"actionGroups": {
					"groupIds": [
						"[variables('actionGroupId')]"
					]
				}
			}
		},
		{
			"name": "[variables('traceSeverityDetectorRuleName')]",
			"type": "Microsoft.AlertsManagement/smartdetectoralertrules",
			"location": "global",
			"apiVersion": "2019-03-01",
			"properties": {
				"description": "Trace Severity Degradation notifies you of an unusual increase in the severity of the traces generated by your app.",
				"state": "Enabled",
				"severity": "Sev3",
				"frequency": "PT24H",
				"detector": {
					"id": "TraceSeverityDetector"
				},
				"scope": [
					"[variables('applicationInsightsResourceId')]"
				],
				"actionGroups": {
					"groupIds": [
						"[variables('actionGroupId')]"
					]
				}
			}
		},
		{
			"name": "[variables('exceptionVolumeChangedDetectorRuleName')]",
			"type": "Microsoft.AlertsManagement/smartdetectoralertrules",
			"location": "global",
			"apiVersion": "2019-03-01",
			"properties": {
				"description": "Exception Anomalies notifies you of an unusual rise in the rate of exceptions thrown by your app.",
				"state": "Enabled",
				"severity": "Sev3",
				"frequency": "PT24H",
				"detector": {
					"id": "ExceptionVolumeChangedDetector"
				},
				"scope": [
					"[variables('applicationInsightsResourceId')]"
				],
				"actionGroups": {
					"groupIds": [
						"[variables('actionGroupId')]"
					]
				}
			}
		},
		{
			"name": "[variables('memoryLeakRuleName')]",
			"type": "Microsoft.AlertsManagement/smartdetectoralertrules",
			"location": "global",
			"apiVersion": "2019-03-01",
			"properties": {
				"description": "Potential Memory Leak notifies you of increased memory consumption pattern by your app which may indicate a potential memory leak.",
				"state": "Enabled",
				"severity": "Sev3",
				"frequency": "PT24H",
				"detector": {
					"id": "MemoryLeakDetector"
				},
				"scope": [
					"[variables('applicationInsightsResourceId')]"
				],
				"actionGroups": {
					"groupIds": [
						"[variables('actionGroupId')]"
					]
				}
			}
		},
		{
			"name": "[concat(parameters('applicationInsightsResourceName'),'/migrationToAlertRulesCompleted')]",
			"type": "Microsoft.Insights/components/ProactiveDetectionConfigs",
			"location": "[resourceGroup().location]",
			"apiVersion": "2018-05-01-preview",
			"properties": {
				"name": "migrationToAlertRulesCompleted",
				"sendEmailsToSubscriptionOwners": false,
				"customEmails": [],
				"enabled": true
			},
			"dependsOn": [
				"[resourceId('Microsoft.AlertsManagement/smartdetectoralertrules', variables('requestPerformanceDegradationDetectorRuleName'))]",
				"[resourceId('Microsoft.AlertsManagement/smartdetectoralertrules', variables('dependencyPerformanceDegradationDetectorRuleName'))]",
				"[resourceId('Microsoft.AlertsManagement/smartdetectoralertrules', variables('traceSeverityDetectorRuleName'))]",
				"[resourceId('Microsoft.AlertsManagement/smartdetectoralertrules', variables('exceptionVolumeChangedDetectorRuleName'))]",
				"[resourceId('Microsoft.AlertsManagement/smartdetectoralertrules', variables('memoryLeakRuleName'))]"
			]
		}
	]
}

Ver os seus alertas após a migração

Após a migração, você pode exibir seus alertas de deteção inteligente selecionando a entrada Alertas no recurso do Application Insights. Para Tipo de sinal, selecione Detetor inteligente para filtrar e apresentar apenas alertas de deteção inteligente. Você pode selecionar um alerta para ver seus detalhes de deteção.

Você também ainda pode ver as deteções disponíveis no feed de deteção inteligente do recurso do Application Insights.

Gerenciar configurações de regras de alerta de deteção inteligente após a migração

Use o portal do Azure ou modelos ARM para gerenciar as configurações de regras de alerta de deteção inteligente após a migração.

Gerenciar configurações de regras de alerta usando o portal do Azure

Após a conclusão da migração, você acessa as novas regras de alerta de deteção inteligente de maneira semelhante a outras regras de alerta definidas para o recurso.

Selecione Alertas sob o título Monitoramento no recurso do Application Insights.
Selecione Gerenciar regras de alerta.
Para Tipo de sinal, selecione Detetor inteligente para filtrar e apresentar as regras de alerta de deteção inteligente.

Ativar ou desativar regras de alerta de deteção inteligente

As regras de alerta de deteção inteligente podem ser ativadas ou desativadas através da interface do usuário do portal ou programaticamente, como qualquer outra regra de alerta.

Se uma regra de deteção inteligente específica tiver sido desativada antes da migração, a nova regra de alerta também será desativada.

Configurar grupos de ação para suas regras de alerta

Você pode criar e gerenciar grupos de ação para as novas regras de alerta de deteção inteligente como para qualquer outra regra de alerta do Azure Monitor.

Gerenciar configurações de regra de alerta usando modelos ARM

Após a conclusão da migração, você pode usar modelos ARM para definir as configurações da regra de alerta de deteção inteligente.