Delen via


az monitor scheduled-query

Note

Deze verwijzing maakt deel uit van de geplande query-extensie voor de Azure CLI (versie 2.54.0 of hoger). De extensie installeert automatisch de eerste keer dat u een az monitor scheduled-query opdracht uitvoert. Meer informatie over uitbreidingen.

Opdrachten voor het beheren van geplande query's.

Opdracht

Name Description Type Status
az monitor scheduled-query create

Maak een geplande query.

Extension GA
az monitor scheduled-query delete

Een geplande query verwijderen.

Extension GA
az monitor scheduled-query list

Geef alle geplande query's weer.

Extension GA
az monitor scheduled-query show

Details van een geplande query weergeven.

Extension GA
az monitor scheduled-query update

Een geplande query bijwerken.

Extension 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 --cwas {false, true}]
                                  [--condition-query]
                                  [--custom-properties]
                                  [--description]
                                  [--disabled {false, true}]
                                  [--evaluation-frequency]
                                  [--location]
                                  [--mad --mute-actions-duration]
                                  [--severity]
                                  [--skip-query-validation {false, true}]
                                  [--tags]
                                  [--target-resource-type --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,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

Naam van 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

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

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

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

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

Querydeteils om de tijdelijke aanduidingen in --condition 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.

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

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

Eigenschap Waarde
Default value: 5m
--location -l

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

Eigenschap Waarde
Default value: 2
--skip-query-validation

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

Eigenschap Waarde
Default value: False
Geaccepteerde waarden: false, true
--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.

Eigenschap Waarde
Default value: 5m
Globale parameters
--debug

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

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Naam of id van 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.

Eigenschap Waarde
Default value: False

az monitor scheduled-query delete

Een geplande query verwijderen.

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

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--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. U moet ofwel --id's of andere 'Resource Id'-argumenten opgeven.

Eigenschap Waarde
Parametergroep: Resource Id Arguments
--name -n

Naam van de geplande queryregel.

Eigenschap Waarde
Parametergroep: Resource Id Arguments
--resource-group -g

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

Eigenschap Waarde
Parametergroep: Resource Id Arguments
--subscription

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

Eigenschap Waarde
Parametergroep: Resource Id Arguments
--yes -y

Niet vragen om bevestiging.

Eigenschap Waarde
Default value: False
Globale parameters
--debug

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

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Eigenschap Waarde
Default value: False

az monitor scheduled-query list

Geef alle geplande query's weer.

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

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--resource-group -g

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

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Naam of id van 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.

Eigenschap Waarde
Default value: False

az monitor scheduled-query show

Details van een geplande query weergeven.

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

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--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. U moet ofwel --id's of andere 'Resource Id'-argumenten opgeven.

Eigenschap Waarde
Parametergroep: Resource Id Arguments
--name -n

Naam van de geplande queryregel.

Eigenschap Waarde
Parametergroep: Resource Id Arguments
--resource-group -g

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

Eigenschap Waarde
Parametergroep: Resource Id Arguments
--subscription

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

Eigenschap Waarde
Parametergroep: Resource Id Arguments
Globale parameters
--debug

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

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Eigenschap Waarde
Default value: False

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 --cwas {false, true}]
                                  [--condition]
                                  [--condition-query]
                                  [--custom-properties]
                                  [--description]
                                  [--disabled {false, true}]
                                  [--evaluation-frequency]
                                  [--force-string]
                                  [--ids]
                                  [--mad --mute-actions-duration]
                                  [--name]
                                  [--remove]
                                  [--resource-group]
                                  [--set]
                                  [--severity]
                                  [--skip-query-validation {false, true}]
                                  [--subscription]
                                  [--tags]
                                  [--target-resource-type --type]
                                  [--window-size]

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

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

Eigenschap Waarde
Parametergroep: Generic Update Arguments
Default value: []
--auto-mitigate

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

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

Eigenschap Waarde
Geaccepteerde waarden: false, true
--condition

De voorwaarde die de regel activeert.

Gebruik: --condition {avg,min,max,total,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 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.

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

Eigenschap Waarde
Parametergroep: Generic Update Arguments
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. U moet ofwel --id's of andere 'Resource Id'-argumenten opgeven.

Eigenschap Waarde
Parametergroep: Resource Id Arguments
--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.

Eigenschap Waarde
Parametergroep: Resource Id Arguments
--remove

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

Eigenschap Waarde
Parametergroep: Generic Update Arguments
Default value: []
--resource-group -g

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

Eigenschap Waarde
Parametergroep: Resource Id Arguments
--set

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

Eigenschap Waarde
Parametergroep: Generic Update Arguments
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.

Eigenschap Waarde
Geaccepteerde waarden: false, true
--subscription

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

Eigenschap Waarde
Parametergroep: Resource Id Arguments
--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.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Eigenschap Waarde
Default value: False