Vytvoření upozornění na metriku v protokolech služby Azure Monitor
Přehled
Poznámka:
Při práci s Azure doporučujeme používat modul Azure Az PowerShellu. Začněte tím, že si projdete téma Instalace Azure PowerShellu. Informace o tom, jak migrovat na modul Az PowerShell, najdete v tématu Migrace Azure PowerShellu z AzureRM na Az.
Upozornění metrik pro protokoly umožňují využít možnosti upozornění metrik na předdefinovanou sadu protokolů v protokolech služby Azure Monitor. Monitorované protokoly, které je možné shromažďovat z Azure nebo místních počítačů, se převedou na metriky a pak se monitorují pomocí pravidel upozornění na metriky stejně jako jakákoli jiná metrika. Podporované protokoly Log Analytics jsou následující:
- Čítače výkonu pro počítače s Windows a Linuxem (odpovídající podporovaným metrikám pracovního prostoru služby Log Analytics)
- Záznamy prezenčních signálů pro službu Agent Health
- Záznamy správy aktualizací
- Protokoly dat událostí
Použití upozornění na metriky pro protokoly oproti upozorněním prohledávání protokolů na základě dotazů v Azure má řadu výhod. Některé z nich jsou uvedené níže:
- Upozornění na metriky nabízejí možnosti monitorování téměř v reálném čase a upozornění metrik pro forky protokolů ze zdroje protokolů, aby se zajistilo stejné.
- Upozornění na metriky jsou stavová – upozornění pouze jednou při vyvolání výstrahy a jednou při řešení výstrahy; na rozdíl od upozornění prohledávání protokolu, které jsou bezstavové a v případě splnění podmínky upozornění se neustále aktivují v každém intervalu.
- Upozornění na metriky pro protokol poskytují více dimenzí, což umožňuje filtrování podle konkrétních hodnot, jako jsou počítače, typ operačního systému atd. jednodušší; bez nutnosti definovat složitý dotaz v Log Analytics.
Poznámka:
Konkrétní metrika nebo dimenze se zobrazí pouze v případě, že data pro ni existují ve zvoleném období. Tyto metriky jsou k dispozici zákazníkům s pracovními prostory Azure Log Analytics.
Metriky a dimenze podporované pro protokoly
Upozornění metrik podporují upozorňování pro metriky, které používají dimenze. Pomocí dimenzí můžete metriku filtrovat na správnou úroveň. Úplný seznam metrik podporovaných pro protokoly odpovídá seznamu metrik pracovního prostoru služby Log Analytics.
Poznámka:
Pokud chcete zobrazit podporovanou metriku extrahovaná z pracovního prostoru služby Log Analytics prostřednictvím služby Azure Monitor – Metriky, musí se pro danou konkrétní metriku vytvořit upozornění na metriku pro protokol. Dimenze vybrané v upozornění metriky pro protokoly – zobrazí se pouze pro zkoumání prostřednictvím služby Azure Monitor – Metriky.
Vytvoření upozornění na metriku pro Log Analytics
Data metrik z oblíbených protokolů se před zpracováním v Log Analytics před jejich zpracováním do služby Azure Monitor – Metriky před kanálem před kanálem před kanály. To uživatelům umožňuje využívat možnosti platformy metrik a upozornění na metriky – včetně upozornění s frekvencí až 1 minutu. Níže jsou uvedeny prostředky pro vytvoření upozornění metriky pro protokoly.
Požadavky pro upozornění na metriky pro protokoly
Než metrika pro protokoly shromážděné v datech Log Analytics funguje, musí být nastavena a dostupná následující:
- Aktivní pracovní prostor služby Log Analytics: Musí existovat platný a aktivní pracovní prostor služby Log Analytics. Další informace najdete v tématu Vytvoření pracovního prostoru služby Log Analytics na webu Azure Portal.
- Agent je nakonfigurovaný pro pracovní prostor služby Log Analytics: Agent musí být nakonfigurovaný pro místní virtuální počítače Azure (nebo) pro odesílání dat do pracovního prostoru služby Log Analytics, který se používá v předchozím kroku. Další informace najdete v tématu Log Analytics – Přehled agenta.
- Nainstalované podporované řešení Log Analytics: Řešení Log Analytics by mělo být nakonfigurované a odesílající data do pracovního prostoru služby Log Analytics – podporovaná řešení jsou čítače výkonu pro Windows a Linux, záznamy prezenčních signálů pro službu Agent Health, Update Management a data událostí.
- Řešení Log Analytics nakonfigurovaná tak, aby odesílala protokoly: Řešení Log Analytics by mělo mít požadované protokoly a data odpovídající metrikám podporovaným pro pracovní prostory služby Log Analytics. Například pro % dostupný čítač paměti musí být nakonfigurován v řešení čítačů výkonu nejprve.
Konfigurace upozornění na metriky pro protokoly
Upozornění na metriky je možné vytvářet a spravovat pomocí webu Azure Portal, šablon Resource Manageru, rozhraní REST API, PowerShellu a Azure CLI. Vzhledem k tomu, že upozornění na metriky pro protokoly jsou variantou upozornění na metriky – po dokončení požadavků je možné pro zadaný pracovní prostor služby Log Analytics vytvořit upozornění metriky pro protokoly. Všechny charakteristiky a funkce upozornění na metriky budou platit i pro upozornění metrik pro protokoly, včetně schématu datové části, příslušných limitů kvót a fakturované ceny.
Podrobné podrobnosti a ukázky – viz vytváření a správa upozornění metrik. Konkrétně pro upozornění metrik pro protokoly – postupujte podle pokynů pro správu upozornění metrik a ujistěte se, že platí následující:
- Cíl upozornění na metriku je platný pracovní prostor služby Log Analytics.
- Signál vybraný pro upozornění na metriku pro vybraný pracovní prostor služby Log Analytics je typu Metrika
- Filtrování konkrétních podmínek nebo prostředků pomocí filtrů dimenzí; metriky pro protokoly jsou multidimenzionální
- Při konfiguraci logiky signálu je možné vytvořit jednu výstrahu, která bude obsahovat více hodnot dimenze (například Počítač).
- Pokud k vytváření upozornění na metriku pro vybraný pracovní prostor služby Log Analytics nepoužíváte Azure Portal. Uživatel musí nejprve ručně vytvořit explicitní pravidlo pro převod dat protokolu na metriku pomocí služby Azure Monitor – Pravidla naplánovaných dotazů.
Poznámka:
Při vytváření upozornění na metriku pro protokol prostřednictvím webu Azure Portal – odpovídající pravidlo pro převod dat protokolu na metriku prostřednictvím služby Azure Monitor – Pravidla naplánovaných dotazů se automaticky vytvoří na pozadí bez nutnosti zásahu uživatele nebo akce. Informace o upozornění na metriky pro protokoly vytvořené pomocí jiných prostředků než webu Azure Portal najdete v části Šablona prostředků pro upozornění metrik pro protokoly na ukázkových způsobech vytvoření protokolu založeného na ScheduledQueryRule na pravidlo převodu metrik před vytvořením upozornění na metriku . Jinak pro upozornění metriky vytvořené v protokolech nebudou k dispozici žádná data.
Šablona prostředků pro upozornění metrik pro protokoly
Jak jsme uvedli dříve, proces vytváření upozornění metrik pro protokoly je rozdělený do dvou oblastí:
- Vytvoření pravidla pro extrakci metrik z podporovaných protokolů pomocí rozhraní SCHEDULEDQueryRule API
- Vytvoření upozornění na metriku extrahované z protokolu (v kroku 1) a pracovního prostoru služby Log Analytics jako cílového prostředku
Upozornění metrik pro protokoly se statickou prahovou hodnotou
K dosažení stejného cíle můžete použít ukázkovou šablonu Azure Resource Manageru níže – kde vytvoření upozornění na metriku statické prahové hodnoty závisí na úspěšném vytvoření pravidla pro extrakci metrik z protokolů prostřednictvím scheduledQueryRule.
{
"$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"convertRuleName": {
"type": "string",
"minLength": 1,
"metadata": {
"description": "Name of the rule to convert log to metric"
}
},
"convertRuleDescription": {
"type": "string",
"minLength": 1,
"metadata": {
"description": "Description for log converted to metric"
}
},
"convertRuleRegion": {
"type": "string",
"minLength": 1,
"metadata": {
"description": "Name of the region used by workspace"
}
},
"convertRuleStatus": {
"type": "string",
"defaultValue": "true",
"metadata": {
"description": "Specifies whether the log conversion rule is enabled"
}
},
"convertRuleMetric": {
"type": "string",
"minLength": 1,
"metadata": {
"description": "Name of the metric once extraction done from logs."
}
},
"alertName": {
"type": "string",
"minLength": 1,
"metadata": {
"description": "Name of the alert"
}
},
"alertDescription": {
"type": "string",
"defaultValue": "This is a metric alert",
"metadata": {
"description": "Description of alert"
}
},
"alertSeverity": {
"type": "int",
"defaultValue": 3,
"allowedValues": [
0,
1,
2,
3,
4
],
"metadata": {
"description": "Severity of alert {0,1,2,3,4}"
}
},
"isEnabled": {
"type": "bool",
"defaultValue": true,
"metadata": {
"description": "Specifies whether the alert is enabled"
}
},
"resourceId": {
"type": "string",
"minLength": 1,
"metadata": {
"description": "Full Resource ID of the resource emitting the metric that will be used for the comparison. For example: /subscriptions/00000000-0000-0000-0000-0000-00000000/resourceGroups/ResourceGroupName/providers/Microsoft.OperationalInsights/workspaces/workspaceName"
}
},
"metricName": {
"type": "string",
"minLength": 1,
"metadata": {
"description": "Name of the metric used in the comparison to activate the alert."
}
},
"operator": {
"type": "string",
"defaultValue": "GreaterThan",
"allowedValues": [
"Equals",
"NotEquals",
"GreaterThan",
"GreaterThanOrEqual",
"LessThan",
"LessThanOrEqual"
],
"metadata": {
"description": "Operator comparing the current value with the threshold value."
}
},
"threshold": {
"type": "string",
"defaultValue": "0",
"metadata": {
"description": "The threshold value at which the alert is activated."
}
},
"timeAggregation": {
"type": "string",
"defaultValue": "Average",
"allowedValues": [
"Average",
"Minimum",
"Maximum",
"Total"
],
"metadata": {
"description": "How the data that is collected should be combined over time."
}
},
"windowSize": {
"type": "string",
"defaultValue": "PT5M",
"metadata": {
"description": "Period of time used to monitor alert activity based on the threshold. Must be between five minutes and one day. ISO 8601 duration format."
}
},
"evaluationFrequency": {
"type": "string",
"defaultValue": "PT1M",
"metadata": {
"description": "how often the metric alert is evaluated represented in ISO 8601 duration format"
}
},
"actionGroupId": {
"type": "string",
"defaultValue": "",
"metadata": {
"description": "The ID of the action group that is triggered when the alert is activated or deactivated"
}
}
},
"variables": {
"convertRuleSourceWorkspace": {
"SourceId": "/subscriptions/1234-56789-1234-567a/resourceGroups/resourceGroupName/providers/Microsoft.OperationalInsights/workspaces/workspaceName"
}
},
"resources": [
{
"name": "[parameters('convertRuleName')]",
"type": "Microsoft.Insights/scheduledQueryRules",
"apiVersion": "2018-04-16",
"location": "[parameters('convertRuleRegion')]",
"properties": {
"description": "[parameters('convertRuleDescription')]",
"enabled": "[parameters('convertRuleStatus')]",
"source": {
"dataSourceId": "[variables('convertRuleSourceWorkspace').SourceId]"
},
"action": {
"odata.type": "Microsoft.WindowsAzure.Management.Monitoring.Alerts.Models.Microsoft.AppInsights.Nexus.DataContracts.Resources.ScheduledQueryRules.LogToMetricAction",
"criteria": [{
"metricName": "[parameters('convertRuleMetric')]",
"dimensions": []
}
]
}
}
},
{
"name": "[parameters('alertName')]",
"type": "Microsoft.Insights/metricAlerts",
"location": "global",
"apiVersion": "2018-03-01",
"tags": {},
"dependsOn":["[resourceId('Microsoft.Insights/scheduledQueryRules',parameters('convertRuleName'))]"],
"properties": {
"description": "[parameters('alertDescription')]",
"severity": "[parameters('alertSeverity')]",
"enabled": "[parameters('isEnabled')]",
"scopes": ["[parameters('resourceId')]"],
"evaluationFrequency":"[parameters('evaluationFrequency')]",
"windowSize": "[parameters('windowSize')]",
"criteria": {
"odata.type": "Microsoft.Azure.Monitor.SingleResourceMultipleMetricCriteria",
"allOf": [
{
"name" : "1st criterion",
"metricName": "[parameters('metricName')]",
"dimensions":[],
"operator": "[parameters('operator')]",
"threshold" : "[parameters('threshold')]",
"timeAggregation": "[parameters('timeAggregation')]"
}
]
},
"actions": [
{
"actionGroupId": "[parameters('actionGroupId')]"
}
]
}
}
]
}
Řekněme, že výše uvedený kód JSON se uloží jako metricfromLogsAlertStatic.json – pak ho můžete spojit se souborem JSON parametru pro vytvoření založeného na šabloně prostředků. Soubor JSON s ukázkovým parametrem je uvedený níže:
{
"$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"convertRuleName": {
"value": "TestLogtoMetricRule"
},
"convertRuleDescription": {
"value": "Test rule to extract metrics from logs via template"
},
"convertRuleRegion": {
"value": "West Central US"
},
"convertRuleStatus": {
"value": "true"
},
"convertRuleMetric": {
"value": "Average_% Idle Time"
},
"alertName": {
"value": "TestMetricAlertonLog"
},
"alertDescription": {
"value": "New multi-dimensional metric alert created via template"
},
"alertSeverity": {
"value":3
},
"isEnabled": {
"value": true
},
"resourceId": {
"value": "/subscriptions/1234-56789-1234-567a/resourceGroups/myRG/providers/Microsoft.OperationalInsights/workspaces/workspaceName"
},
"metricName":{
"value": "Average_% Idle Time"
},
"operator": {
"value": "GreaterThan"
},
"threshold":{
"value": "1"
},
"timeAggregation":{
"value": "Average"
},
"actionGroupId": {
"value": "/subscriptions/1234-56789-1234-567a/resourceGroups/myRG/providers/microsoft.insights/actionGroups/actionGroupName"
}
}
}
Za předpokladu, že se výše uvedený soubor parametrů uloží jako metricfromLogsAlertStatic.parameters.json; Pak můžete vytvořit upozornění na metriku pro protokoly pomocí šablony prostředků pro vytvoření na webu Azure Portal.
Alternativně můžete použít následující příkaz Azure PowerShellu:
New-AzResourceGroupDeployment -ResourceGroupName "myRG" -TemplateFile metricfromLogsAlertStatic.json TemplateParameterFile metricfromLogsAlertStatic.parameters.json
Nebo použijte šablonu nasazení prostředku pomocí Azure CLI:
az deployment group create --resource-group myRG --template-file metricfromLogsAlertStatic.json --parameters @metricfromLogsAlertStatic.parameters.json
Upozornění metrik pro protokoly s dynamickými prahovými hodnotami
K dosažení stejného cíle můžete použít ukázkovou šablonu Azure Resource Manageru níže – kde vytvoření upozornění metrik dynamické prahové hodnoty závisí na úspěšném vytvoření pravidla pro extrakci metrik z protokolů prostřednictvím scheduledQueryRule.
{
"$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"convertRuleName": {
"type": "string",
"minLength": 1,
"metadata": {
"description": "Name of the rule to convert log to metric"
}
},
"convertRuleDescription": {
"type": "string",
"minLength": 1,
"metadata": {
"description": "Description for log converted to metric"
}
},
"convertRuleRegion": {
"type": "string",
"minLength": 1,
"metadata": {
"description": "Name of the region used by workspace"
}
},
"convertRuleStatus": {
"type": "string",
"defaultValue": "true",
"metadata": {
"description": "Specifies whether the log conversion rule is enabled"
}
},
"convertRuleMetric": {
"type": "string",
"minLength": 1,
"metadata": {
"description": "Name of the metric once extraction done from logs."
}
},
"alertName": {
"type": "string",
"minLength": 1,
"metadata": {
"description": "Name of the alert"
}
},
"alertDescription": {
"type": "string",
"defaultValue": "This is a metric alert",
"metadata": {
"description": "Description of alert"
}
},
"alertSeverity": {
"type": "int",
"defaultValue": 3,
"allowedValues": [
0,
1,
2,
3,
4
],
"metadata": {
"description": "Severity of alert {0,1,2,3,4}"
}
},
"isEnabled": {
"type": "bool",
"defaultValue": true,
"metadata": {
"description": "Specifies whether the alert is enabled"
}
},
"resourceId": {
"type": "string",
"minLength": 1,
"metadata": {
"description": "Full Resource ID of the resource emitting the metric that will be used for the comparison. For example: /subscriptions/00000000-0000-0000-0000-0000-00000000/resourceGroups/ResourceGroupName/providers/Microsoft.OperationalInsights/workspaces/workspaceName"
}
},
"metricName": {
"type": "string",
"minLength": 1,
"metadata": {
"description": "Name of the metric used in the comparison to activate the alert."
}
},
"operator": {
"type": "string",
"defaultValue": "GreaterOrLessThan",
"allowedValues": [
"GreaterThan",
"LessThan",
"GreaterOrLessThan"
],
"metadata": {
"description": "Operator comparing the current value with the threshold value."
}
},
"alertSensitivity": {
"type": "string",
"defaultValue": "Medium",
"allowedValues": [
"High",
"Medium",
"Low"
],
"metadata": {
"description": "Tunes how 'noisy' the Dynamic Thresholds alerts will be: 'High' will result in more alerts while 'Low' will result in fewer alerts."
}
},
"numberOfEvaluationPeriods": {
"type": "string",
"defaultValue": "4",
"metadata": {
"description": "The number of periods to check in the alert evaluation."
}
},
"minFailingPeriodsToAlert": {
"type": "string",
"defaultValue": "3",
"metadata": {
"description": "The number of unhealthy periods to alert on (must be lower or equal to numberOfEvaluationPeriods)."
}
},
"timeAggregation": {
"type": "string",
"defaultValue": "Average",
"allowedValues": [
"Average",
"Minimum",
"Maximum",
"Total"
],
"metadata": {
"description": "How the data that is collected should be combined over time."
}
},
"windowSize": {
"type": "string",
"defaultValue": "PT5M",
"metadata": {
"description": "Period of time used to monitor alert activity based on the threshold. Must be between five minutes and one day. ISO 8601 duration format."
}
},
"evaluationFrequency": {
"type": "string",
"defaultValue": "PT1M",
"metadata": {
"description": "how often the metric alert is evaluated represented in ISO 8601 duration format"
}
},
"actionGroupId": {
"type": "string",
"defaultValue": "",
"metadata": {
"description": "The ID of the action group that is triggered when the alert is activated or deactivated"
}
}
},
"variables": {
"convertRuleSourceWorkspace": {
"SourceId": "/subscriptions/1234-56789-1234-567a/resourceGroups/resourceGroupName/providers/Microsoft.OperationalInsights/workspaces/workspaceName"
}
},
"resources": [
{
"name": "[parameters('convertRuleName')]",
"type": "Microsoft.Insights/scheduledQueryRules",
"apiVersion": "2018-04-16",
"location": "[parameters('convertRuleRegion')]",
"properties": {
"description": "[parameters('convertRuleDescription')]",
"enabled": "[parameters('convertRuleStatus')]",
"source": {
"dataSourceId": "[variables('convertRuleSourceWorkspace').SourceId]"
},
"action": {
"odata.type": "Microsoft.WindowsAzure.Management.Monitoring.Alerts.Models.Microsoft.AppInsights.Nexus.DataContracts.Resources.ScheduledQueryRules.LogToMetricAction",
"criteria": [{
"metricName": "[parameters('convertRuleMetric')]",
"dimensions": []
}
]
}
}
},
{
"name": "[parameters('alertName')]",
"type": "Microsoft.Insights/metricAlerts",
"location": "global",
"apiVersion": "2018-03-01",
"tags": {},
"dependsOn":["[resourceId('Microsoft.Insights/scheduledQueryRules',parameters('convertRuleName'))]"],
"properties": {
"description": "[parameters('alertDescription')]",
"severity": "[parameters('alertSeverity')]",
"enabled": "[parameters('isEnabled')]",
"scopes": ["[parameters('resourceId')]"],
"evaluationFrequency":"[parameters('evaluationFrequency')]",
"windowSize": "[parameters('windowSize')]",
"criteria": {
"odata.type": "Microsoft.Azure.Monitor.MultipleResourceMultipleMetricCriteria",
"allOf": [
{
"criterionType": "DynamicThresholdCriterion",
"name" : "1st criterion",
"metricName": "[parameters('metricName')]",
"dimensions":[],
"operator": "[parameters('operator')]",
"alertSensitivity": "[parameters('alertSensitivity')]",
"failingPeriods": {
"numberOfEvaluationPeriods": "[parameters('numberOfEvaluationPeriods')]",
"minFailingPeriodsToAlert": "[parameters('minFailingPeriodsToAlert')]"
},
"timeAggregation": "[parameters('timeAggregation')]"
}
]
},
"actions": [
{
"actionGroupId": "[parameters('actionGroupId')]"
}
]
}
}
]
}
Řekněme, že výše uvedený kód JSON se uloží jako metricfromLogsAlertDynamic.json – pak ho můžete spojit se souborem JSON parametru pro vytvoření založeného na šabloně prostředků. Soubor JSON s ukázkovým parametrem je uvedený níže:
{
"$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"convertRuleName": {
"value": "TestLogtoMetricRule"
},
"convertRuleDescription": {
"value": "Test rule to extract metrics from logs via template"
},
"convertRuleRegion": {
"value": "West Central US"
},
"convertRuleStatus": {
"value": "true"
},
"convertRuleMetric": {
"value": "Average_% Idle Time"
},
"alertName": {
"value": "TestMetricAlertonLog"
},
"alertDescription": {
"value": "New multi-dimensional metric alert created via template"
},
"alertSeverity": {
"value":3
},
"isEnabled": {
"value": true
},
"resourceId": {
"value": "/subscriptions/1234-56789-1234-567a/resourceGroups/myRG/providers/Microsoft.OperationalInsights/workspaces/workspaceName"
},
"metricName":{
"value": "Average_% Idle Time"
},
"operator": {
"value": "GreaterOrLessThan"
},
"alertSensitivity": {
"value": "Medium"
},
"numberOfEvaluationPeriods": {
"value": "4"
},
"minFailingPeriodsToAlert": {
"value": "3"
},
"timeAggregation":{
"value": "Average"
},
"actionGroupId": {
"value": "/subscriptions/1234-56789-1234-567a/resourceGroups/myRG/providers/microsoft.insights/actionGroups/actionGroupName"
}
}
}
Za předpokladu, že výše uvedený soubor parametrů je uložen jako metricfromLogsAlertDynamic.parameters.json; Pak můžete vytvořit upozornění na metriku pro protokoly pomocí šablony prostředků pro vytvoření na webu Azure Portal.
Alternativně můžete použít následující příkaz Azure PowerShellu:
New-AzResourceGroupDeployment -ResourceGroupName "myRG" -TemplateFile metricfromLogsAlertDynamic.json TemplateParameterFile metricfromLogsAlertDynamic.parameters.json
Nebo použijte šablonu nasazení prostředku pomocí Azure CLI:
az deployment group create --resource-group myRG --template-file metricfromLogsAlertDynamic.json --parameters @metricfromLogsAlertDynamic.parameters.json
Další kroky
- Přečtěte si další informace o upozorněních metrik.
- Seznamte se s upozorněními prohledávání protokolů v Azure.
- Seznamte se s upozorněními v Azure.