Delen via

az monitor metrics alert

  • Referentie

Regels voor waarschuwingen voor bijna realtime metrische gegevens beheren.

Opdracht

Name Description Type Status
az monitor metrics alert condition

Voorwaarden voor waarschuwingsregels voor bijna realtime metrische gegevens beheren.

 Basis GA
az monitor metrics alert condition create

Een regelvoorwaarde voor metrische waarschuwingen maken.

 Basis Preview
az monitor metrics alert create

Maak een waarschuwingsregel op basis van metrische gegevens.

 Basis GA
az monitor metrics alert delete

Verwijder een waarschuwingsregel op basis van metrische gegevens.

 Basis GA
az monitor metrics alert dimension

Dimensies van waarschuwingsregel voor bijna realtime metrische gegevens beheren.

 Basis GA
az monitor metrics alert dimension create

Een metrische waarschuwingsregeldimensie bouwen.

 Basis Preview
az monitor metrics alert list

Lijst met waarschuwingsregels op basis van metrische gegevens.

 Basis GA
az monitor metrics alert show

Een waarschuwingsregel op basis van metrische gegevens weergeven.

 Basis GA
az monitor metrics alert update

Werk een waarschuwingsregel op basis van metrische gegevens bij.

 Basis GA

az monitor metrics alert create

Bewerken

Maak een waarschuwingsregel op basis van metrische gegevens.

az monitor metrics alert create --condition
                                --name
                                --resource-group
                                --scopes
                                [--action]
                                [--auto-mitigate {false, true}]
                                [--description]
                                [--disabled {false, true}]
                                [--evaluation-frequency]
                                [--region]
                                [--severity]
                                [--tags]
                                [--target-resource-type]
                                [--window-size]

Voorbeelden

Maak een waarschuwing voor hoog CPU-gebruik op een VIRTUELE machine zonder actie.

az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID} --condition "avg Percentage CPU > 90" --description "High CPU"

Maak een waarschuwing voor hoog CPU-gebruik op een VIRTUELE machine met e-mail- en webhookacties.

az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID} \
    --condition "avg Percentage CPU > 90" --window-size 5m --evaluation-frequency 1m \
    --action "/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Insights/actionGroups/<actionGroupName>" apiKey={APIKey} type=HighCPU \
    --description "High CPU"

Maak een waarschuwing wanneer een opslagaccount een groot aantal trage transacties weergeeft met behulp van multidimensionale filters.

az monitor metrics alert create -g {ResourceGroup} -n alert1 --scopes {StorageAccountId} \
    --description "Storage Slow Transactions" \
    --condition "total transactions > 5 where ResponseType includes Success" \
    --condition "avg SuccessE2ELatency > 250 where ApiName includes GetBlob"

Maak een waarschuwingsregel op basis van metrische gegevens waarmee een aangepaste metrische waarde wordt bewaakt.

az monitor metrics alert create -n "metric alert rule on a custom metric" -g "Demos" --scopes {VirtualMachineID} \
    --condition "max Azure.VM.Windows.GuestMetrics.Memory\Available Bytes > 90" \
    --window-size 5m --evaluation-frequency 1m

Maak een waarschuwing voor hoog CPU-gebruik op verschillende VM's zonder acties.

az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID1} {VirtualMachineID2} {VirtualMachineID3} \
    --condition "avg Percentage CPU > 90" --description "High CPU" --region westus

Maak een waarschuwing voor dynamisch CPU-gebruik op verschillende VM's zonder acties.

az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID1} {VirtualMachineID2} {VirtualMachineID3} \
    --condition "avg Percentage CPU > dynamic medium 2 of 4 since 2020-10-01T10:23:00.000Z"
    --description "Dynamic CPU"
    --window-size 5m
    --region westus

Vereiste parameters

--condition

De voorwaarde die de regel activeert. Deze kan worden gemaakt met de opdracht az monitor metrics alert condition create.

Gebruik: --condition {avg,min,max,total,count} [NAAMRUIMTE.] METRISCHE WAARDE [{=,!=,>,>=;<;<=} DREMPELWAARDE] [{<,>,><} dynamische GEVOELIGHEIDSSCHENDINGEN VAN EVALUATIES [sinds DATUM/TIJD]] [where DIMENSION {includes,excludes} VALUE [of VALUE ...] [and DIMENSION {includes,excludes} VALUE [or VALUE ...] ...]] [met skipmetricvalidation]

Gevoeligheid kan 'laag', 'gemiddeld', 'hoog' zijn.

Schendingen kunnen het aantal schendingen zijn om een waarschuwing te activeren. Deze moet kleiner of gelijk zijn aan de evaluatie.

Evaluaties kunnen het aantal evaluatieperioden voor dynamische drempelwaarden zijn.

Datum/tijd kan de datum zijn van waaruit u de metrische historische gegevens moet leren en de dynamische drempelwaarden kunt berekenen (in ISO8601 notatie).

Dimensies kunnen worden opgevraagd door het trefwoord 'where' en meerdere dimensies toe te voegen door ze te combineren met het trefwoord 'en'.

Waarden voor METRIC, DIMENSION en de juiste DREMPELWAARDEn kunnen worden verkregen via az monitor metrics list-definitions de opdracht.

Als een waarschuwingsregel meerdere criteria bevat, is het gebruik van dimensies beperkt tot één waarde per dimensie binnen elk criterium.

Er kunnen meerdere voorwaarden worden opgegeven met behulp van meer dan één --condition argument.

--name -n

Naam van de waarschuwingsregel.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--scopes

Door spaties gescheiden lijst met bereiken waarvoor de regel van toepassing is. De resources die in deze parameter zijn opgegeven, moeten van hetzelfde type zijn en aanwezig zijn op dezelfde locatie.

Optionele parameters

--action -a

Voeg een actiegroep en optionele webhookeigenschappen toe die moeten worden geactiveerd wanneer de waarschuwing wordt geactiveerd.

Gebruik: --action ACTION_GROUP_NAME_OR_ID [KEY=VAL [KEY=VAL ...]]

U kunt meerdere actiegroepen opgeven met behulp van meer dan één --action argument.

--auto-mitigate

De waarschuwing automatisch oplossen.

geaccepteerde waarden: false, true
--description

Beschrijving van de regel in vrije tekst.

--disabled

Maak de regel met een uitgeschakelde status.

geaccepteerde waarden: false, true
standaardwaarde: False
--evaluation-frequency

Frequentie waarmee de regel moet worden geëvalueerd in de notatie '##h##m##s'.

standaardwaarde: 1m
--region --target-resource-region

De regio van de doelresource(s) in bereiken. Dit moet worden opgegeven wanneer bereiken een resourcegroep of abonnement zijn.

--severity

Ernst van de waarschuwing van 0 (kritiek) tot 4 (uitgebreid).

standaardwaarde: 2
--tags

Door spaties gescheiden tags: key[=value] [key[=value] ...]. Gebruik '' om bestaande tags te wissen.

--target-resource-type --type

Het resourcetype van de doelresource(s) in bereiken. Dit moet worden opgegeven wanneer bereiken een resourcegroep of abonnement zijn.

--window-size

Tijd die nodig is om metrische gegevens samen te voegen in de notatie ##h#m##s.

standaardwaarde: 5m
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az monitor metrics alert delete

Bewerken

Verwijder een waarschuwingsregel op basis van metrische gegevens.

az monitor metrics alert delete [--ids]
                                [--name]
                                [--resource-group]
                                [--subscription]

Voorbeelden

Verwijder een waarschuwingsregel op basis van metrische gegevens.

az monitor metrics alert delete --name MyAlertRule --resource-group MyResourceGroup

Optionele parameters

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--name -n

Naam van de waarschuwingsregel.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az monitor metrics alert list

Bewerken

Lijst met waarschuwingsregels op basis van metrische gegevens.

az monitor metrics alert list [--resource-group]

Voorbeelden

Lijst met waarschuwingsregels op basis van metrische gegevens.

az monitor metrics alert list --resource-group MyResourceGroup

Optionele parameters

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az monitor metrics alert show

Bewerken

Een waarschuwingsregel op basis van metrische gegevens weergeven.

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

Voorbeelden

Een waarschuwingsregel op basis van metrische gegevens weergeven.

az --name MyAlertRule --resource-group MyResourceGroup

Optionele parameters

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--name -n

Naam van de waarschuwingsregel.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az monitor metrics alert update

Bewerken

Werk een waarschuwingsregel op basis van metrische gegevens bij.

az monitor metrics alert update [--add]
                                [--add-action]
                                [--add-condition]
                                [--auto-mitigate {0, 1, f, false, n, no, t, true, y, yes}]
                                [--description]
                                [--enabled {0, 1, f, false, n, no, t, true, y, yes}]
                                [--evaluation-frequency]
                                [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                [--ids]
                                [--name]
                                [--remove]
                                [--remove-actions]
                                [--remove-conditions]
                                [--resource-group]
                                [--scopes]
                                [--set]
                                [--severity]
                                [--subscription]
                                [--tags]
                                [--window-size]

Voorbeelden

Schakel een waarschuwingsregel op basis van metrische gegevens uit/in.

az monitor metrics alert update --enabled false --name MyAlertRule --resource-group MyResourceGroup

Optionele parameters

--add

Voeg een object toe aan een lijst met objecten door een pad- en sleutelwaardeparen op te geven. Voorbeeld: --add property.listProperty <key=value, string of JSON string>.

--add-action --add-actions

Voeg een actiegroep en optionele webhookeigenschappen toe die moeten worden geactiveerd wanneer de waarschuwing wordt geactiveerd.

Gebruik: --add-action ACTION_GROUP_NAME_OR_ID [KEY=VAL [KEY=VAL ...]]

U kunt meerdere actiegroepen opgeven met behulp van meer dan één --add-action argument. Ondersteuning voor shorthand-syntaxis, json-file en yaml-file. Probeer '??' om meer weer te geven.

--add-condition --add-conditions

Voeg een voorwaarde toe waarmee de regel wordt geactiveerd.

Gebruik: --add-condition {avg,min,max,total,count} [NAAMRUIMTE.] METRISCHE WAARDE [{=,!=,>,>=;<;<=} DREMPELWAARDE] [{<,>,><} dynamische GEVOELIGHEIDSSCHENDINGEN VAN EVALUATIES [sinds DATUM/TIJD]] [where DIMENSION {includes,excludes} VALUE [of VALUE ...] [and DIMENSION {includes,excludes} VALUE [or VALUE ...] ...]]

Gevoeligheid kan 'laag', 'gemiddeld', 'hoog' zijn.

Schendingen kunnen het aantal schendingen zijn om een waarschuwing te activeren. Deze moet kleiner of gelijk zijn aan de evaluatie.

Evaluaties kunnen het aantal evaluatieperioden voor dynamische drempelwaarden zijn.

Datum/tijd kan de datum zijn van waaruit u de metrische historische gegevens moet leren en de dynamische drempelwaarden kunt berekenen (in ISO8601 notatie).

Dimensies kunnen worden opgevraagd door het trefwoord 'where' en meerdere dimensies toe te voegen door ze te combineren met het trefwoord 'en'.

Waarden voor METRIC, DIMENSION en de juiste DREMPELWAARDEn kunnen worden verkregen via az monitor metrics list-definitions de opdracht.

Als een waarschuwingsregel meerdere criteria bevat, is het gebruik van dimensies beperkt tot één waarde per dimensie binnen elk criterium.

Er kunnen meerdere voorwaarden worden opgegeven met behulp van meer dan één --add-condition argument. Ondersteuning voor shorthand-syntaxis, json-file en yaml-file. Probeer '??' om meer weer te geven.

--auto-mitigate

De waarschuwing automatisch oplossen.

geaccepteerde waarden: 0, 1, f, false, n, no, t, true, y, yes
--description

Beschrijving van de regel in vrije tekst.

--enabled

Of de waarschuwingsregel voor metrische gegevens is ingeschakeld.

geaccepteerde waarden: 0, 1, f, false, n, no, t, true, y, yes
--evaluation-frequency

Frequentie waarmee de regel in ##h##m##s indeling moet worden geëvalueerd.

--force-string

Wanneer u 'set' of 'toevoegen' gebruikt, behoudt u letterlijke tekenreeksen in plaats van te converteren naar JSON.

geaccepteerde waarden: 0, 1, f, false, n, no, t, true, y, yes
--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--name -n

Naam van de waarschuwingsregel.

--remove

Een eigenschap of element uit een lijst verwijderen. Voorbeeld: --remove property.list OR --remove propertyToRemove.

--remove-actions

Door spaties gescheiden lijst met namen van actiegroepen die u wilt verwijderen. Ondersteuning voor shorthand-syntaxis, json-file en yaml-file. Probeer '??' om meer weer te geven.

--remove-conditions

Door spaties gescheiden lijst met voorwaardenamen die u wilt verwijderen. Ondersteuning voor shorthand-syntaxis, json-file en yaml-file. Probeer '??' om meer weer te geven.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--scopes

Door spaties gescheiden lijst met bereiken waarvoor de regel van toepassing is. De resources die in deze parameter zijn opgegeven, moeten van hetzelfde type zijn en aanwezig zijn op dezelfde locatie. Ondersteuning voor shorthand-syntaxis, json-file en yaml-file. Probeer '??' om meer weer te geven.

--set

Werk een object bij door een eigenschapspad en waarde op te geven die u wilt instellen. Voorbeeld: --set property1.property2=.

--severity

Ernst van de waarschuwing van 0 (kritiek) tot 4 (uitgebreid).

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--tags

Door spaties gescheiden tags: key[=value] [key[=value] ...]. Ondersteuning voor shorthand-syntaxis, json-file en yaml-file. Probeer '??' om meer weer te geven.

--window-size

Tijd over het aggregeren van metrische gegevens in ##h##m##s indeling.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.