Delen via

az monitor scheduled-query

  • Referentie

Notitie

Deze verwijzing maakt deel uit van de geplande query-extensie voor de Azure CLI (versie 2.54.0 of hoger). De extensie wordt automatisch geïnstalleerd wanneer u een az monitor scheduled-query-opdracht uitvoert. Meer informatie over extensies.

Opdrachten voor het beheren van geplande query's.

Opdracht

Name Description Type Status
az monitor scheduled-query create

Maak een geplande query.

 Toestel GA
az monitor scheduled-query delete

Een geplande query verwijderen.

 Toestel GA
az monitor scheduled-query list

Geef alle geplande query's weer.

 Toestel GA
az monitor scheduled-query show

Details van een geplande query weergeven.

 Toestel GA
az monitor scheduled-query update

Een geplande query bijwerken.

 Toestel GA

az monitor scheduled-query create

Maak een geplande query.

az monitor scheduled-query create --condition
                                  --name
                                  --resource-group
                                  --scopes
                                  [--action-groups]
                                  [--auto-mitigate {false, true}]
                                  [--check-ws-alerts-storage {false, true}]
                                  [--condition-query]
                                  [--custom-properties]
                                  [--description]
                                  [--disabled {false, true}]
                                  [--evaluation-frequency]
                                  [--location]
                                  [--mad]
                                  [--severity]
                                  [--skip-query-validation {false, true}]
                                  [--tags]
                                  [--target-resource-type]
                                  [--window-size]

Voorbeelden

Maak een geplande query voor een virtuele machine.

az monitor scheduled-query create -g {rg} -n {name1} --scopes {vm_id} --condition "count 'Placeholder_1' > 360 resource id _ResourceId at least 1 violations out of 5 aggregated points" --condition-query Placeholder_1="union Event, Syslog | where TimeGenerated > ago(1h) | where EventLevelName=='Error' or SeverityLevel=='err'" --description "Test rule"

Maak een geplande query voor VM's in een resourcegroep.

az monitor scheduled-query create -g {rg} -n {name1} --scopes {rg_id} --condition "count 'Placeholder_1' > 360 resource id _ResourceId at least 1 violations out of 5 aggregated points" --condition-query Placeholder_1="union Event, Syslog | where TimeGenerated > ago(1h) | where EventLevelName=='Error' or SeverityLevel=='err'" --description "Test rule"

Vereiste parameters

--condition

De voorwaarde die de regel activeert.

Gebruik: --condition {avg,min,max,total,count} ["METRIC COLUMN" from] "QUERY_PLACEHOLDER" {=,!=,>>,<,<=} THRESHOLD [resource id RESOURCEID] [where DIMENSION {includes,excludes} VALUE [or VALUE ...] [and DIMENSION {includes,excludes} VALUE [or VALUE ...] ...]] [ten minste MinTimeToFail-schendingen van geaggregeerde punten van EvaluationPeriod]' Tijdelijke aanduidingen voor query's kunnen worden gedefinieerd in --condition-queryargument Dimensies door het sleutelwoord 'where' toe te voegen en meerdere dimensies kunnen worden opgevraagd door ze te combineren met het sleutelwoord 'and'.

--name -n

Naam van de geplande queryregel.

--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-groups

Resource-id's van de actiegroep die moeten worden aangeroepen wanneer de waarschuwing wordt geactiveerd.

Gebruik: --action-groups ACTION_GROUP_NAME_OR_ID [NAME_OR_ID,...].

--auto-mitigate

De vlag die aangeeft of de waarschuwing automatisch moet worden opgelost of niet. De standaardwaarde is waar.

Geaccepteerde waarden: false, true
Default value: True
--check-ws-alerts-storage --cwas

De vlag die aangeeft of deze geplande queryregel moet worden opgeslagen in de opslag van de klant.

Geaccepteerde waarden: false, true
Default value: False
--condition-query

Querydeteils om de tijdelijke aanduidingen in --condition het argument te vervangen.

--custom-properties

De eigenschappen van een nettolading van een waarschuwing.

Gebruik: --custom-properties ALERT_PAYLOAD_PROPERTIES [KEY=VAL,KEY=VAL ...].

--description

Beschrijving van de regel in vrije tekst.

--disabled

Schakel de geplande query uit.

Geaccepteerde waarden: false, true
Default value: False
--evaluation-frequency

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

Default value: 5m
--location -l

Locatie. Waarden van: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.

--mad --mute-actions-duration

Demp acties voor de gekozen periode (in ISO 8601-duurnotatie) nadat de waarschuwing is geactiveerd.

--severity

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

Default value: 2
--skip-query-validation

De vlag die aangeeft of de opgegeven query moet worden gevalideerd of niet.

Geaccepteerde waarden: false, true
Default value: False
--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 voor het aggregeren van metrische gegevens in de notatie ##h##m##s.

Default value: 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
Default value: 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 scheduled-query delete

Een geplande query verwijderen.

az monitor scheduled-query delete [--ids]
                                  [--name]
                                  [--resource-group]
                                  [--subscription]
                                  [--yes]

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 geplande queryregel.

--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.

--yes -y

Niet vragen om bevestiging.

Default value: False
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
Default value: 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 scheduled-query list

Geef alle geplande query's weer.

az monitor scheduled-query list [--resource-group]

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
Default value: 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 scheduled-query show

Details van een geplande query weergeven.

az monitor scheduled-query show [--ids]
                                [--name]
                                [--resource-group]
                                [--subscription]

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 geplande queryregel.

--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
Default value: 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 scheduled-query update

Een geplande query bijwerken.

az monitor scheduled-query update [--action-groups]
                                  [--add]
                                  [--auto-mitigate {false, true}]
                                  [--check-ws-alerts-storage {false, true}]
                                  [--condition]
                                  [--condition-query]
                                  [--custom-properties]
                                  [--description]
                                  [--disabled {false, true}]
                                  [--evaluation-frequency]
                                  [--force-string]
                                  [--ids]
                                  [--mad]
                                  [--name]
                                  [--remove]
                                  [--resource-group]
                                  [--set]
                                  [--severity]
                                  [--skip-query-validation {false, true}]
                                  [--subscription]
                                  [--tags]
                                  [--target-resource-type]
                                  [--window-size]

Optionele parameters

--action-groups

Resource-id's van de actiegroep die moeten worden aangeroepen wanneer de waarschuwing wordt geactiveerd.

--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 or JSON string>.

Default value: []
--auto-mitigate

De vlag die aangeeft of de waarschuwing automatisch moet worden opgelost of niet. De standaardwaarde is waar.

Geaccepteerde waarden: false, true
--check-ws-alerts-storage --cwas

De vlag die aangeeft of deze geplande queryregel moet worden opgeslagen in de opslag van de klant.

Geaccepteerde waarden: false, true
--condition

De voorwaarde die de regel activeert.

Gebruik: --condition {avg,min,max,total,count} ["METRIC COLUMN" from] "QUERY_PLACEHOLDER" {=,!=,>>,<,<=} THRESHOLD [resource id RESOURCEID] [where DIMENSION {includes,excludes} VALUE [or VALUE ...] [and DIMENSION {includes,excludes} VALUE [or VALUE ...] ...]] [ten minste MinTimeToFail-schendingen van geaggregeerde punten van EvaluationPeriod]'

Tijdelijke aanduidingen voor query's kunnen worden gedefinieerd in --condition-queryargument Dimensies kunnen worden opgevraagd door het trefwoord 'where' toe te voegen en meerdere dimensies te combineren met het sleutelwoord 'and'.

--condition-query

Querydeteils om de tijdelijke aanduidingen in --condition het argument te vervangen.

--custom-properties

De eigenschappen van een nettolading van een waarschuwing.

Gebruik: --custom-properties ALERT_PAYLOAD_PROPERTIES [KEY=VAL,KEY=VAL ...].

--description

Beschrijving van de regel in vrije tekst.

--disabled

Schakel de geplande query uit.

Geaccepteerde waarden: false, true
--evaluation-frequency

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

--force-string

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

Default value: False
--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.

--mad --mute-actions-duration

Demp acties voor de gekozen periode (in ISO 8601-duurnotatie) nadat de waarschuwing is geactiveerd.

--name -n

Naam van de geplande queryregel.

--remove

Een eigenschap of element uit een lijst verwijderen. Voorbeeld: --remove property.list <indexToRemove> OF --remove propertyToRemove.

Default value: []
--resource-group -g

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

--set

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

Default value: []
--severity

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

--skip-query-validation

De vlag die aangeeft of de opgegeven query moet worden gevalideerd of niet.

Geaccepteerde waarden: false, true
--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] ...]. 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 voor het aggregeren van metrische gegevens in de notatie ##h##m##s.

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
Default value: 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.