Creare un avviso metriche per i log in Monitoraggio di Azure
Nota
È consigliabile usare il modulo Azure Az PowerShell per interagire con Azure. Per iniziare, vedere Installare Azure PowerShell. Per informazioni su come eseguire la migrazione al modulo AZ PowerShell, vedere Eseguire la migrazione di Azure PowerShell da AzureRM ad Az.
È possibile usare le funzionalità di avviso delle metriche in un set predefinito di log nei log di Monitoraggio di Azure. I log monitorati, che possono essere raccolti da computer Azure o locali, vengono convertiti in metriche e quindi monitorati con regole di avviso delle metriche, esattamente come qualsiasi altra metrica.
Un'area di lavoro Log Analytics supporta questi tipi di log:
- Contatori delle prestazioni per i computer Windows e Linux (corrispondenti alle metriche dell'area di lavoro Log Analytics supportate)
- Record di heartbeat per l'Integrità agente
- Record di Gestione aggiornamenti
- I log dei dati dell'evento
I vantaggi dell'uso degli avvisi delle metriche per i log sugli avvisi di ricerca log basati su query in Azure includono:
- Gli avvisi delle metriche offrono una funzionalità di monitoraggio near real-time. Creano una copia tramite fork dei dati dell'origine log per garantire questa funzionalità.
- Gli avvisi delle metriche sono avvisi con stato. Inviano una notifica una prima volta, quando viene generato un avviso, e una seconda volta quando l'avviso viene risolto. Gli avvisi di ricerca log sono senza stato e continuano a essere attivati a ogni intervallo se la condizione di avviso viene soddisfatta.
- Gli avvisi delle metriche forniscono più dimensioni. Consentono di filtrare in base a valori specifici, ad esempio computer e tipi di sistema operativo, senza la necessità di definire una query complessa in Log Analytics.
Nota
Una metrica o una dimensione specifica viene visualizzata solo se i dati sono presenti nel periodo scelto. Tali metriche sono disponibili per i clienti che hanno aree di lavoro di Azure Log Analytics.
Metriche e dimensioni supportate per i log
Con gli avvisi delle metriche, le dimensioni possono essere usate per filtrare le metriche al livello corretto. L'elenco completo delle metriche supportate per i log equivale all'elenco delle metriche dell'area di lavoro Log Analytics.
Nota
Per visualizzare una metrica supportata estratta da un'area di lavoro Log Analytics tramite le metriche di Monitoraggio di Azure, è necessario creare un avviso delle metriche per i log in tale metrica specifica. Le dimensioni scelte nell'avviso delle metriche per i log verranno visualizzate solo per l'esplorazione tramite le metriche di Monitoraggio di Azure.
Creazione di un avviso delle metriche per i log
Prima che i dati delle metriche derivanti dai log più comuni vengano elaborati in Log Analytics, vengono convogliati nelle metriche di Monitoraggio di Azure. È quindi possibile sfruttare le funzionalità della piattaforma delle metriche, oltre agli avvisi delle metriche, inclusa la presenza di avvisi con una frequenza inferiore a un minuto.
Il processo di creazione di avvisi delle metriche per i log si articola in due fasi:
- Creare una regola per estrarre le metriche dai log supportati tramite l'API Regole query pianificate (
scheduledQueryRules). - Creare un avviso per la metrica estratta dal log (nel passaggio 1) e un'area di lavoro Log Analytics come risorsa di destinazione.
Prerequisiti
Prima di creare un avviso delle metriche per i log, assicurarsi che siano configurati e disponibili gli elementi seguenti:
- Area di lavoro Log Analytics: è necessario disporre di un'area di lavoro Log Analytics valida e attiva. Per altre informazioni, vedere Creare un'area di lavoro Log Analytics.
- Agente configurato per l'area di lavoro Log Analytics: è necessario configurare un agente per le macchine virtuali di Azure o i computer locali per inviare dati all'area di lavoro Log Analytics. Per altre informazioni, vedere la panoramica dell'agente di Monitoraggio di Azure.
- Soluzione Log Analytics supportata: è necessario configurare una soluzione Log Analytics e inviare dati all'area di lavoro Log Analytics. Le soluzioni supportate sono contatori delle prestazioni per Windows e Linux, record heartbeat per Integrità agente, Gestione aggiornamenti di Automazione di Azure e dati degli eventi.
- Log configurati per la soluzione Log Analytics: la soluzione Log Analytics deve avere i log e i dati necessari che corrispondono alle metriche supportate per le aree di lavoro Log Analytics abilitate. Ad esempio, il contatore relativo alla percentuale di memoria disponibile deve essere prima configurato nella soluzione contatori delle prestazioni.
Metodi per la creazione di un avviso delle metriche per i log
È possibile creare e gestire gli avvisi delle metriche tramite il portale di Azure, i modelli di Azure Resource Manager, l'API REST, Azure PowerShell e l'interfaccia della riga di comando di Azure.
Dopo aver creato avvisi delle metriche per i log per un'area di lavoro Log Analytics specificata, questi hanno tutte le caratteristiche e le funzionalità degli avvisi delle metriche, inclusi lo schema del payload, i limiti di quota applicabili e il prezzo fatturato.
Per informazioni dettagliate ed esempi, vedere Creare o modificare una regola di avviso delle metriche. Seguire le istruzioni per la gestione degli avvisi delle metriche e prendere nota delle considerazioni seguenti:
Un avviso delle metriche deve essere destinato a un'area di lavoro Log Analytics valida.
Il segnale scelto per un avviso di metrica per un'area di lavoro Log Analytics selezionata deve essere di tipo Metrica.
È possibile filtrare le condizioni o le risorse specifiche usando filtri delle dimensioni, perché le metriche per i log sono multidimensionali.
Quando si configura la logica del segnale, è possibile creare un singolo avviso per includere più valori della dimensione (ad esempio computer).
Quando si crea un avviso delle metriche per i log tramite il portale di Azure, viene creata automaticamente in background una regola corrispondente per la conversione dei dati di log in una metrica tramite
scheduledQueryRules, senza la necessità di alcun intervento o azione da parte dell'utente.Se non si usa il portale di Azure per creare un avviso delle metriche per un'area di lavoro Log Analytics selezionata, è prima necessario creare manualmente una regola esplicita per convertire i dati di log in una metrica tramite
scheduledQueryRules.
Modelli di Resource Manager
Per creare un avviso delle metriche per i log, è possibile usare i modelli di Resource Manager di esempio seguenti.
Per gli avvisi delle metriche per i log creati con mezzi diversi dal portale di Azure, è possibile usare questi modelli di esempio per creare una regola di conversione da log a metrica basata su scheduledQueryRules prima di creare un avviso delle metriche. In caso contrario, nei log non saranno presenti dati per l'avviso delle metriche.
Avviso della metrica per i log con una soglia statica
Nel modello di esempio seguente la creazione di un avviso delle metriche per una soglia statica dipende dalla corretta creazione della regola per estrarre le metriche dai log tramite scheduledQueryRules.
{
"$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 a log to a metric"
}
},
"convertRuleDescription": {
"type": "string",
"minLength": 1,
"metadata": {
"description": "Description for the log converted to a metric."
}
},
"convertRuleRegion": {
"type": "string",
"minLength": 1,
"metadata": {
"description": "Name of the region used by the 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 after extraction is 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 the alert."
}
},
"alertSeverity": {
"type": "int",
"defaultValue": 3,
"allowedValues": [
0,
1,
2,
3,
4
],
"metadata": {
"description": "Severity of the 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's 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's 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')]"
}
]
}
}
]
}
Se si salva il codice JSON precedente come metricfromLogsAlertStatic.json, è possibile associarlo a un file JSON dei parametri per la creazione in base a un modello di Resource Manager. Ecco un file JSON dei parametri di esempio:
{
"$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 multidimensional 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"
}
}
}
Supponendo di aver salvato il file di parametri precedente come metricfromLogsAlertStatic.parameters.json, è possibile creare avvisi delle metriche per i log tramite il modello di ARM per la creazione nel portale di Azure.
In alternativa, è possibile usare il comando Azure PowerShell:
New-AzResourceGroupDeployment -ResourceGroupName "myRG" -TemplateFile metricfromLogsAlertStatic.json TemplateParameterFile metricfromLogsAlertStatic.parameters.json
In alternativa, è possibile distribuire il modello di Resource Manager usando l'interfaccia della riga di comando di Azure:
az deployment group create --resource-group myRG --template-file metricfromLogsAlertStatic.json --parameters @metricfromLogsAlertStatic.parameters.json
Avvisi delle metriche con soglie dinamiche
Nel modello di esempio seguente la creazione di un avviso delle metriche per soglie dinamiche dipende dalla corretta creazione della regola per estrarre le metriche dai log tramite scheduledQueryRules.
{
"$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 a log to a metric."
}
},
"convertRuleDescription": {
"type": "string",
"minLength": 1,
"metadata": {
"description": "Description for the log converted to a metric."
}
},
"convertRuleRegion": {
"type": "string",
"minLength": 1,
"metadata": {
"description": "Name of the region used by the 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 after extraction is 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 the alert."
}
},
"alertSeverity": {
"type": "int",
"defaultValue": 3,
"allowedValues": [
0,
1,
2,
3,
4
],
"metadata": {
"description": "Severity of the 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 alerts for dynamic thresholds will be. 'High' will result in more alerts. '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's 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's 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')]"
}
]
}
}
]
}
Se si salva il codice JSON precedente come metricfromLogsAlertDynamic.json, è possibile associarlo a un file JSON dei parametri per la creazione in base a un modello di Resource Manager. Ecco un file JSON dei parametri di esempio:
{
"$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 multidimensional 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"
}
}
}
Supponendo di aver salvato il file di parametri precedente come metricfromLogsAlertDynamic.parameters.json, è possibile creare avvisi delle metriche per i log tramite il modello di ARM per la creazione nel portale di Azure.
In alternativa, è possibile usare il comando Azure PowerShell:
New-AzResourceGroupDeployment -ResourceGroupName "myRG" -TemplateFile metricfromLogsAlertDynamic.json TemplateParameterFile metricfromLogsAlertDynamic.parameters.json
In alternativa, è possibile distribuire il modello di Resource Manager usando l'interfaccia della riga di comando di Azure:
az deployment group create --resource-group myRG --template-file metricfromLogsAlertDynamic.json --parameters @metricfromLogsAlertDynamic.parameters.json
Contenuto correlato
- Altre informazioni sugli avvisi delle metriche.
- Informazioni sugli avvisi per la ricerca log in Azure.
- Informazioni sugli avvisi in Azure.