Migrowanie wykrywania inteligentnego usługi Application Insights w usłudze Azure Monitor do alertów (wersja zapoznawcza)

Artykuł
11/05/2024

W tym artykule opisano proces migrowania wykrywania inteligentnego usługi Application Insights do alertów. Migracja tworzy reguły alertów w przypadku różnych modułów wykrywania inteligentnego. Możesz zarządzać tymi regułami i konfigurować je tak jak wszystkie inne reguły alertów usługi Azure Monitor. Można również skonfigurować grupy akcji dla tych reguł, aby uzyskać wiele metod akcji lub powiadomień dotyczących nowych wykryć.

Korzyści z migracji do alertów

Dzięki migracji funkcja wykrywania inteligentnego umożliwia teraz korzystanie z pełnych możliwości alertów usługi Azure Monitor, w tym:

Zaawansowane opcje powiadomień dla wszystkich detektorów: użyj grup akcji, aby skonfigurować wiele typów powiadomień i akcji wyzwalanych po wyzwoleniu alertu. Powiadomienia można skonfigurować za pomocą poczty e-mail, wiadomości SMS, połączeń głosowych lub powiadomień wypychanych. Możesz skonfigurować akcje, takie jak wywoływanie bezpiecznego elementu webhook, aplikacji logiki i elementu Runbook automatyzacji. Grupy akcji umożliwiają dalsze zarządzanie na dużą skalę, umożliwiając skonfigurowanie akcji raz i użycie ich w wielu regułach alertów.
Zarządzanie na dużą skalę: alerty wykrywania inteligentnego używają środowiska i interfejsu API alertów usługi Azure Monitor.
Pomijanie powiadomień opartych na regułach: użyj reguł akcji, aby zdefiniować lub pominąć akcje w dowolnym zakresie usługi Azure Resource Manager, takim jak subskrypcja platformy Azure, grupa zasobów lub zasób docelowy. Filtry ułatwiają zawężenie określonego podzestawu wystąpień alertów, nad którymi chcesz działać.

Migrowane funkcje wykrywania inteligentnego

Podczas migracji zasobu usługi Application Insights jest tworzony nowy zestaw reguł alertów. Jedna reguła jest tworzona dla każdej z migrowanych funkcji wykrywania inteligentnego. W poniższej tabeli przedstawiono mapowanie możliwości wykrywania inteligentnego przed migracją na reguły alertów po migracji.

Nazwa ^{reguły wykrywania inteligentnego (1)}	Nazwa ^{reguły alertu (2)}
Obniżenie czasu odpowiedzi serwera	Obniżenie opóźnienia odpowiedzi — <nazwa zasobu usługi Application Insights>
Obniżenie czasu trwania zależności	Obniżenie opóźnienia zależności — <nazwa zasobu usługi Application Insights>
Obniżenie współczynnika ważności śledzenia (wersja zapoznawcza)	Obniżenie ważności śledzenia — <nazwa zasobu usługi Application Insights>
Nietypowy wzrost woluminu wyjątków (wersja zapoznawcza)	Anomalie wyjątków — <nazwa zasobu usługi Application Insights>
Wykryto potencjalny wyciek pamięci (wersja zapoznawcza)	Potencjalny wyciek pamięci — <nazwa zasobu usługi Application Insights>
Wolny czas ładowania strony	Nieobsługiwane ⁽³⁾
Wolny czas odpowiedzi serwera	Nieobsługiwane ⁽³⁾
Długi czas trwania zależności	Nieobsługiwane ⁽³⁾
Wykryto potencjalny problem z zabezpieczeniami (wersja zapoznawcza)	Nieobsługiwane ⁽³⁾
Nietypowy wzrost dziennego woluminu danych (wersja zapoznawcza)	Nieobsługiwane ⁽³⁾

⁽¹⁾ Nazwa reguły wyświetlana w okienku Ustawienia wykrywania inteligentnego.
⁽²⁾ Nazwa nowej reguły alertu po migracji.
⁽³⁾ Te funkcje wykrywania inteligentnego nie są konwertowane na alerty z powodu niskiego użycia i ponownej oceny skuteczności wykrywania. Te detektory nie będą już obsługiwane dla tego zasobu po zakończeniu migracji.

Uwaga

Inteligentne narzędzie do wykrywania anomalii błędów zostało już utworzone jako reguła alertu i nie wymaga migracji. Nie omówiono go w tym artykule.

Migracja nie zmienia algorytmicznego projektowania i zachowania wykrywania inteligentnego. Ta sama wydajność wykrywania jest oczekiwana przed i po zmianie.

Migrację należy zastosować do każdego zasobu usługi Application Insights oddzielnie. W przypadku zasobów, które nie są jawnie migrowane, wykrywanie inteligentne będzie nadal działać tak jak wcześniej.

Konfiguracja grupy akcji dla nowych reguł alertów wykrywania inteligentnego

W ramach migracji każda nowa reguła alertu jest automatycznie konfigurowana za pomocą grupy akcji. Migracja może przypisać domyślną grupę akcji dla każdej reguły. Domyślna grupa akcji jest skonfigurowana zgodnie z powiadomieniem reguły przed migracją:

Jeśli reguła wykrywania inteligentnego ma skonfigurowaną domyślną wiadomość e-mail lub żadne powiadomienia, nowa reguła alertu jest skonfigurowana z grupą akcji o nazwie Wykrywanie inteligentne usługi Application Insights.
- Jeśli narzędzie migracji znajdzie istniejącą grupę akcji o tej nazwie, łączy nową regułę alertu z tą grupą akcji.
- W przeciwnym razie tworzy nową grupę akcji o tej nazwie. Nowa grupa jest skonfigurowana dla akcji roli usługi Azure Resource Manager w wiadomości e-mail i wysyła powiadomienia do użytkowników współautora monitorowania i czytelnika monitorowania usługi Azure Resource Manager.
Jeśli domyślne powiadomienie e-mail zostało zmienione przed migracją, zostanie utworzona grupa akcji o nazwie Application Insights Smart Detection <n> z akcją poczty e-mail wysyłającą powiadomienia do wcześniej skonfigurowanych adresów e-mail.

Zamiast używać domyślnej grupy akcji, należy wybrać istniejącą grupę akcji, która zostanie skonfigurowana dla wszystkich nowych reguł alertów.

Wykonywanie procesu migracji wykrywania inteligentnego

Aby przeprowadzić migrację, użyj witryny Azure Portal, interfejsu wiersza polecenia platformy Azure lub szablonów usługi Azure Resource Manager (szablonów usługi ARM).

Migrowanie wykrywania inteligentnego przy użyciu witryny Azure Portal

Aby przeprowadzić migrację wykrywania inteligentnego w zasobie:

Wybierz pozycję Wykrywanie inteligentne w obszarze nagłówka Zbadaj w zasobie usługi Application Insights.
Wybierz baner z napisem Migrowanie wykrywania inteligentnego do alertów (wersja zapoznawcza). Zostanie wyświetlone okno dialogowe migracji.
Wybierz opcję Migruj wszystkie zasoby usługi Application Insights w tej subskrypcji . Możesz też pozostawić opcję wyczyszczone, jeśli chcesz zmigrować tylko bieżący zasób, w którym się znajdujesz.

Uwaga

Wybranie tej opcji wpływa na wszystkie istniejące zasoby usługi Application Insights, które nie zostały jeszcze zmigrowane. Jeśli migracja do alertów jest dostępna w wersji zapoznawczej, nowe zasoby usługi Application Insights będą nadal tworzone z funkcją wykrywania inteligentnego innych niż alerty.
Wybierz grupę akcji, która ma zostać skonfigurowana dla nowych reguł alertów. Możesz użyć domyślnej grupy akcji zgodnie z opisem lub użyć jednej z istniejących grup akcji.
Wybierz pozycję Migruj , aby rozpocząć proces migracji.

Po migracji zostaną utworzone nowe reguły alertów dla zasobu usługi Application Insights, zgodnie z wyjaśnieniem.

Migrowanie wykrywania inteligentnego przy użyciu interfejsu wiersza polecenia platformy Azure

Uruchom migrację wykrywania inteligentnego przy użyciu następującego polecenia interfejsu wiersza polecenia platformy Azure. Polecenie wyzwala wstępnie skonfigurowany proces migracji zgodnie z wcześniejszym opisem.

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

Aby przeprowadzić migrację pojedynczego zasobu usługi Application Insights, body.txt powinny obejmować:

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

Aby przeprowadzić migrację wszystkich zasobów usługi Application Insights w subskrypcji, body.txt powinny obejmować:

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

Parametr ActionGroupCreationPolicy wybiera zasady migracji ustawień poczty e-mail w regułach wykrywania inteligentnego do grup akcji. Dozwolone wartości to:

Automatycznie: używa domyślnych grup akcji zgodnie z opisem w tym dokumencie.
Niestandardowy: tworzy wszystkie reguły alertów z grupą akcji określoną w pliku customActionGroupName.
<puste>: jeśli ActionGroupCreationPolicy nie zostanie określony, Auto zostaną użyte zasady.

Migrowanie wykrywania inteligentnego przy użyciu szablonów usługi ARM

Migrację wykrywania inteligentnego można wyzwolić do alertów dla określonego zasobu usługi Application Insights przy użyciu szablonów usługi ARM. Aby użyć tej metody, należy wykonać następujące kroki:

Utwórz regułę alertu wykrywania inteligentnego dla każdego z obsługiwanych detektorów.
Zmodyfikuj właściwości usługi Application Insight, aby wskazać, że migracja została ukończona.

Za pomocą tej metody możesz kontrolować, które reguły alertów mają zostać utworzone, zdefiniować własną nazwę i opis reguły alertu oraz wybrać dowolną grupę akcji dla każdej reguły.

W tym celu użyj następujących szablonów. Edytuj je zgodnie z potrzebami, aby podać identyfikator subskrypcji i nazwę zasobu usługi 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'))]"
			]
		}
	]
}

Wyświetlanie alertów po migracji

Po migracji możesz wyświetlić alerty wykrywania inteligentnego, wybierając wpis Alerty w zasobie usługi Application Insights. W polu Typ sygnału wybierz pozycję Inteligentny detektor , aby filtrować i prezentować tylko alerty wykrywania inteligentnego. Możesz wybrać alert, aby wyświetlić jego szczegóły wykrywania.

Nadal można zobaczyć dostępne wykrycia w kanale informacyjnym wykrywania inteligentnego zasobu usługi Application Insights.

Zarządzanie ustawieniami reguł alertów wykrywania inteligentnego po migracji

Użyj witryny Azure Portal lub szablonów usługi ARM, aby zarządzać ustawieniami reguł alertów wykrywania inteligentnego po migracji.

Zarządzanie ustawieniami reguł alertów przy użyciu witryny Azure Portal

Po zakończeniu migracji uzyskujesz dostęp do nowych reguł alertów wykrywania inteligentnego w podobny sposób do innych reguł alertów zdefiniowanych dla zasobu.

Wybierz pozycję Alerty w obszarze nagłówka Monitorowanie w zasobie usługi Application Insights.
Wybierz pozycję Zarządzaj regułami alertów.
W polu Typ sygnału wybierz pozycję Inteligentny detektor , aby filtrować i prezentować reguły alertów wykrywania inteligentnego.

Włączanie lub wyłączanie reguł alertów wykrywania inteligentnego

Reguły alertów wykrywania inteligentnego można włączać lub wyłączać za pośrednictwem interfejsu użytkownika portalu lub programowo, podobnie jak każda inna reguła alertu.

Jeśli określona reguła wykrywania inteligentnego została wyłączona przed migracją, nowa reguła alertu również zostanie wyłączona.

Konfigurowanie grup akcji dla reguł alertów

Możesz tworzyć grupy akcji dla nowych reguł alertów wykrywania inteligentnego i zarządzać nimi, tak jak w przypadku każdej innej reguły alertu usługi Azure Monitor.

Zarządzanie ustawieniami reguły alertu przy użyciu szablonów usługi ARM

Po zakończeniu migracji można użyć szablonów usługi ARM do skonfigurowania ustawień reguł alertu wykrywania inteligentnego.