Condividi tramite

az monitor alert-processing-rule

  • Anteprima
  • Riferimento

Nota

Questo riferimento fa parte dell'estensione alertsmanagement per l'interfaccia della riga di comando di Azure (versione 2.45.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az monitor alert-processing-rule . Altre informazioni sulle estensioni.

Questo gruppo di comandi è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Gestire la regola di elaborazione degli avvisi con alertsmanagement.

Comandi

Nome Descrizione Tipo Status
az monitor alert-processing-rule create

Creare una regola di elaborazione avvisi.

 Estensione Anteprima
az monitor alert-processing-rule delete

Eliminare una regola di elaborazione degli avvisi.

 Estensione Anteprima
az monitor alert-processing-rule list

Elencare tutte le regole di elaborazione degli avvisi in una sottoscrizione o in un gruppo di risorse.

 Estensione Anteprima
az monitor alert-processing-rule show

Ottenere una regola di elaborazione degli avvisi.

 Estensione Anteprima
az monitor alert-processing-rule update

Abilitare, disabilitare o aggiornare i tag per una regola di elaborazione degli avvisi.

 Estensione Anteprima

az monitor alert-processing-rule create

Anteprima

Il gruppo di comandi 'monitor alert-processing-rule' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Creare una regola di elaborazione avvisi.

az monitor alert-processing-rule create --name
                                        --resource-group
                                        --rule-type {AddActionGroups, RemoveAllActionGroups}
                                        --scopes
                                        [--action-groups]
                                        [--description]
                                        [--enabled {false, true}]
                                        [--filter-alert-context]
                                        [--filter-alert-rule-description]
                                        [--filter-alert-rule-id]
                                        [--filter-alert-rule-name]
                                        [--filter-monitor-condition]
                                        [--filter-monitor-service]
                                        [--filter-resource-group]
                                        [--filter-resource-type]
                                        [--filter-severity]
                                        [--filter-signal-type]
                                        [--filter-target-resource]
                                        [--schedule-end-datetime]
                                        [--schedule-recurrence]
                                        [--schedule-recurrence-2]
                                        [--schedule-recurrence-2-end-time]
                                        [--schedule-recurrence-2-start-time]
                                        [--schedule-recurrence-2-type {Daily, Monthly, Weekly}]
                                        [--schedule-recurrence-end-time]
                                        [--schedule-recurrence-start-time]
                                        [--schedule-recurrence-type {Daily, Monthly, Weekly}]
                                        [--schedule-start-datetime]
                                        [--schedule-time-zone]
                                        [--tags]

Esempio

Creare o aggiornare una regola che aggiunge un gruppo di azioni a tutti gli avvisi in una sottoscrizione

az monitor alert-processing-rule create \
--name 'AddActionGroupToSubscription' \
--rule-type AddActionGroups \
--scopes "/subscriptions/MySubscriptionId" \
--action-groups "/subscriptions/MySubscriptionId/resourcegroups/MyResourceGroup1/providers/microsoft.insights/actiongroups/ActionGroup1" \
--enabled true \
--resource-group alertscorrelationrg \
--description "Add ActionGroup1 to all alerts in the subscription"

Creare o aggiornare una regola che aggiunge due gruppi di azioni a tutti gli avvisi Sev0 e Sev1 in due gruppi di risorse

az monitor alert-processing-rule create \
--name 'AddActionGroupsBySeverity' \
--rule-type AddActionGroups \
--action-groups "/subscriptions/MySubscriptionId/resourcegroups/MyResourceGroup1/providers/microsoft.insights/actiongroups/MyActionGroupId1" "/subscriptions/MySubscriptionId/resourceGroups/MyResourceGroup2/providers/microsoft.insights/actionGroups/MyActionGroup2" \
--scopes "/subscriptions/MySubscriptionId" \
--resource-group alertscorrelationrg \
--filter-severity Equals Sev0 Sev1 \
--description "Add AGId1 and AGId2 to all Sev0 and Sev1 alerts in these resourceGroups"

Creare o aggiornare una regola che rimuove tutti i gruppi di azioni dagli avvisi in una macchina virtuale specifica durante una finestra di manutenzione occasionale (1800-2000 a una data specifica, Ora solare pacifico)

az monitor alert-processing-rule create \
--name 'RemoveActionGroupsMaintenanceWindow' \
--rule-type RemoveAllActionGroups \
--scopes "/subscriptions/MySubscriptionId/resourceGroups/MyResourceGroup1/providers/Microsoft.Compute/virtualMachines/VMName" \
--resource-group alertscorrelationrg \
--schedule-start-datetime '2022-01-02 18:00:00' \
--schedule-end-datetime '2022-01-02 20:00:00' \
--schedule-time-zone 'Pacific Standard Time' \
--description "Removes all ActionGroups from all Alerts on VMName during the maintenance window"

Creare o aggiornare una regola che rimuove tutti i gruppi di azioni da tutti gli avvisi di una sottoscrizione proveniente da una regola di avviso specifica

az monitor alert-processing-rule create \
--name 'RemoveActionGroupsSpecificAlertRule' \
--rule-type RemoveAllActionGroups \
--scopes "/subscriptions/MySubscriptionId" \
--resource-group alertscorrelationrg \
--filter-alert-rule-id Equals "/subscriptions/MySubscriptionId/resourceGroups/MyResourceGroup1/providers/microsoft.insights/activityLogAlerts/RuleName" \
--description "Removes all ActionGroups from all Alerts that fire on above AlertRule"

Creare o aggiornare una regola che rimuove tutti i gruppi di azioni da tutti gli avvisi in qualsiasi macchina virtuale in due gruppi di risorse durante una finestra di manutenzione ricorrente (2200-0400 ogni sat e Sun, India Standard Time)

az monitor alert-processing-rule create \
--name 'RemoveActionGroupsRecurringMaintenance' \
--rule-type RemoveAllActionGroups \
--scopes "/subscriptions/MySubscriptionId/resourceGroups/MyResourceGroup1" "/subscriptions/MySubscriptionId/resourceGroups/MyResourceGroup2" \
--resource-group alertscorrelationrg \
--filter-resource-type Equals "microsoft.compute/virtualmachines" \
--schedule-time-zone "India Standard Time" \
--schedule-recurrence-type Weekly \
--schedule-recurrence-start-time "22:00:00" \
--schedule-recurrence-end-time "04:00:00" \
--schedule-recurrence Sunday Saturday \
--description "Remove all ActionGroups from all Virtual machine Alerts during the recurring maintenance"

Creare o aggiornare una regola che rimuove tutti i gruppi di azioni all'esterno dell'orario lavorativo (lun-fri 09:00-17:00, ora solare orientale)

az monitor alert-processing-rule create \
--name 'RemoveActionGroupsOutsideBusinessHours' \
--rule-type RemoveAllActionGroups \
--scopes "/subscriptions/MySubscriptionId" \
--resource-group alertscorrelationrg \
--schedule-time-zone "Eastern Standard Time" \
--schedule-recurrence-type Daily \
--schedule-recurrence-start-time "17:00:00" \
--schedule-recurrence-end-time "09:00:00" \
--schedule-recurrence-2-type Weekly \
--schedule-recurrence-2 Saturday Sunday \
--description "Remove all ActionGroups outside business hours"

Parametri necessari

--name -n

Nome della regola di elaborazione degli avvisi.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--rule-type

Indicare il tipo della regola di elaborazione degli avvisi.

Valori accettati: AddActionGroups, RemoveAllActionGroups
--scopes

Elenco di ID risorsa (delimitati da spazi) per l'ambito. La regola verrà applicata agli avvisi generati sulle risorse all'interno di tale ambito.

Parametri facoltativi

--action-groups

Elenco di ID risorsa (delimitati da spazi) di gruppi di azioni da aggiungere. Un uso di questo argomento richiede che il tipo di regola sia AddActionGroups.

--description

Descrizione della regola di elaborazione degli avvisi.

--enabled

Indicare se la regola di elaborazione degli avvisi specificata è abilitata o disabilitata (impostazione predefinita è abilitata).

Valori accettati: false, true
--filter-alert-context

Filtrare gli avvisi in base al contesto di avviso (payload).

Il formato filtro è dove Operator: uno di Equals, NotEquals, Contains, DoesNotContain Values: List of values to match for a given condition.Filter format is where Operator: one of <Equals, NotEquals, Contains, DoesNotContain> Values: List of values to match for a given condition.

--filter-alert-rule-description

Filtrare gli avvisi in base alla descrizione della regola di avviso.

--filter-alert-rule-id

Filtrare gli avvisi in base all'ID avviso.

--filter-alert-rule-name

Filtrare gli avvisi in base al nome della regola di avviso.

--filter-monitor-condition

Filtrare gli avvisi in base alla condizione di monitoraggio.

--filter-monitor-service

Filtrare gli avvisi in base al servizio di monitoraggio.

--filter-resource-group

Filtrare gli avvisi in base al gruppo di risorse.

--filter-resource-type

Filtrare gli avvisi in base al tipo di risorsa.

--filter-severity

Filtrare gli avvisi in base alla <gravità Sev0, Sev1, Sev2, Sev3, Sev4>.

--filter-signal-type

Filtrare gli avvisi in base al tipo di segnale.

--filter-target-resource

Filtrare gli avvisi in base alla risorsa.

--schedule-end-datetime

Data di fine per la regola. Formato: 'AAAA-MM-GG hh:mm:ss'.

--schedule-recurrence

Elenco dei valori dei criteri di ricorrenza.

--schedule-recurrence: elenco dei valori dei criteri di ricorrenza (delimitati da spazi). Per un tipo di ricorrenza settimanale, i valori consentiti sono da domenica a sabato. Per un tipo di ricorrenza mensile, i valori consentiti sono compresi tra 1 e 31 (giorni del mese).

--schedule-recurrence-2

Elenco dei valori dei criteri di ricorrenza per il secondo criterio di ricorrenza.

--schedule-recurrence-2 : elenco dei valori dei criteri di ricorrenza (delimitati da spazi). Per un tipo di ricorrenza settimanale, i valori consentiti sono da domenica a sabato. Per un tipo di ricorrenza mensile, i valori consentiti sono compresi tra 1 e 31 (giorni del mese).

--schedule-recurrence-2-end-time

Ora di fine per ogni ricorrenza. Formato: hh:mm:ss.

--schedule-recurrence-2-start-time

Ora di inizio per ogni ricorrenza. Formato: hh:mm:ss.

--schedule-recurrence-2-type

Specifica quando deve essere applicata la regola di elaborazione. Il valore predefinito è Always.

Valori accettati: Daily, Monthly, Weekly
--schedule-recurrence-end-time

Ora di fine per ogni ricorrenza. Formato: 'hh:mm:ss'.

--schedule-recurrence-start-time

Ora di inizio per ogni ricorrenza. Formato: 'hh:mm:ss'.

--schedule-recurrence-type

Specifica quando deve essere applicata la regola di elaborazione.

Valori accettati: Daily, Monthly, Weekly
--schedule-start-datetime

Data di inizio per la regola. Formato: 'AAAA-MM-GG hh:mm:ss'.

--schedule-time-zone

Pianificare il fuso orario.

Valore predefinito: UTC
--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az monitor alert-processing-rule delete

Anteprima

Il gruppo di comandi 'monitor alert-processing-rule' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Eliminare una regola di elaborazione degli avvisi.

az monitor alert-processing-rule delete [--ids]
                                        [--name]
                                        [--resource-group]
                                        [--subscription]
                                        [--yes]

Esempio

Eliminare una regola di elaborazione degli avvisi.

az monitor alert-processing-rule delete \
--resource-group myResourceGroup \
--name myRuleName

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--name -n

Nome della regola di elaborazione degli avvisi.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--yes -y

Indica che non è richiesta la conferma.

Valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az monitor alert-processing-rule list

Anteprima

Il gruppo di comandi 'monitor alert-processing-rule' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Elencare tutte le regole di elaborazione degli avvisi in una sottoscrizione o in un gruppo di risorse.

az monitor alert-processing-rule list [--resource-group]

Esempio

Elencare tutte le regole di elaborazione degli avvisi nella sottoscrizione corrente

az monitor alert-processing-rule list

Elencare tutte le regole di elaborazione degli avvisi in un gruppo di risorse

az monitor alert-processing-rule list \
--resource-group myResourceGroup

Parametri facoltativi

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az monitor alert-processing-rule show

Anteprima

Il gruppo di comandi 'monitor alert-processing-rule' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Ottenere una regola di elaborazione degli avvisi.

az monitor alert-processing-rule show [--ids]
                                      [--name]
                                      [--resource-group]
                                      [--subscription]

Esempio

Ottenere una regola di elaborazione degli avvisi in base al nome

az monitor alert-processing-rule show \
--name myRuleName \
--resource-group myRuleNameResourceGroup

Ottenere la regola di elaborazione degli avvisi in base agli ID

az monitor alert-processing-rule show \
--ids ruleId1 ruleId2

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--name -n

Nome della regola di elaborazione degli avvisi.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az monitor alert-processing-rule update

Anteprima

Il gruppo di comandi 'monitor alert-processing-rule' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Abilitare, disabilitare o aggiornare i tag per una regola di elaborazione degli avvisi.

az monitor alert-processing-rule update [--add]
                                        [--enabled {false, true}]
                                        [--force-string]
                                        [--ids]
                                        [--name]
                                        [--remove]
                                        [--resource-group]
                                        [--set]
                                        [--subscription]
                                        [--tags]

Esempio

PatchAlertProcessingRule

az monitor alert-processing-rule update \
--name "WeeklySuppression" \
--enabled false \
--tags key1="value1" key2="value2" --resource-group "alertscorrelationrg"

Parametri facoltativi

--add

Aggiungere un oggetto a un elenco di oggetti specificando un percorso e coppie chiave-valore. Esempio: --add property.listProperty <key=value, string or JSON string>.

Valore predefinito: []
--enabled

Indicare se la regola di elaborazione specificata è abilitata o disabilitata (i valori sono True e False).

Valori accettati: false, true
--force-string

Quando si usa 'set' o 'add', mantenere i valori letterali stringa anziché tentare di eseguire la conversione in JSON.

Valore predefinito: False
--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--name -n

Nome della regola di elaborazione degli avvisi.

--remove

Rimuovere una proprietà o un elemento da un elenco. Esempio: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Valore predefinito: []
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--set

Aggiornare un oggetto specificando un percorso di proprietà e un valore da impostare. Esempio: --set property1.property2=<value>.

Valore predefinito: []
--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.