Delen via


az monitor metrics

Metrische gegevens van Azure-resources weergeven.

Opdracht

Name Description Type Status
az monitor metrics alert

Regels voor waarschuwingen voor bijna realtime metrische gegevens beheren.

Core GA
az monitor metrics alert condition

Voorwaarden voor waarschuwingsregels voor bijna realtime metrische gegevens beheren.

Core GA
az monitor metrics alert condition create

Een regelvoorwaarde voor metrische waarschuwingen maken.

Core Preview
az monitor metrics alert create

Maak een waarschuwingsregel op basis van metrische gegevens.

Core GA
az monitor metrics alert delete

Verwijder een waarschuwingsregel op basis van metrische gegevens.

Core GA
az monitor metrics alert dimension

Dimensies van waarschuwingsregel voor bijna realtime metrische gegevens beheren.

Core GA
az monitor metrics alert dimension create

Een metrische waarschuwingsregeldimensie bouwen.

Core Preview
az monitor metrics alert list

Lijst met waarschuwingsregels op basis van metrische gegevens.

Core GA
az monitor metrics alert show

Een waarschuwingsregel op basis van metrische gegevens weergeven.

Core GA
az monitor metrics alert update

Werk een waarschuwingsregel op basis van metrische gegevens bij.

Core GA
az monitor metrics list

Geef de metrische waarden voor een resource weer.

Core GA
az monitor metrics list-definitions

Geef de metrische definities voor de resource weer.

Core GA
az monitor metrics list-namespaces

Geef de metrische naamruimten voor de resource weer.

Core Preview
az monitor metrics list-sub

Toont de metrische gegevens voor een abonnement. Parameters kunnen worden opgegeven op de hoofdtekst.

Core GA
az monitor metrics list-sub-definitions

Geef de metrische definities voor het abonnement weer.

Core GA

az monitor metrics list

Geef de metrische waarden voor een resource weer.

az monitor metrics list --resource
                        [--aggregation {Average, Count, Maximum, Minimum, None, Total}]
                        [--dimension]
                        [--end-time]
                        [--filter]
                        [--interval]
                        [--metadata]
                        [--metrics]
                        [--namespace]
                        [--offset]
                        [--orderby]
                        [--resource-group]
                        [--resource-namespace]
                        [--resource-parent]
                        [--resource-type]
                        [--start-time]
                        [--top]

Voorbeelden

Het CPU-gebruik van een VIRTUELE machine voor het afgelopen uur weergeven

az monitor metrics list --resource {ResourceName} --metric "Percentage CPU"

Lijst met geslaagde E2E-latentie van een opslagaccount en splits de gegevensreeks op basis van API-naam

az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
                        --dimension ApiName

Lijst met geslaagde E2E-latentie van een opslagaccount en splitst de gegevensreeks op basis van de API-naam en het geo-type

az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
                        --dimension ApiName GeoType

De E2E-latentie van een opslagaccount vermelden en de gegevensreeks splitsen op basis van de API-naam en het geo-type met de parameter --filter

az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
                        --filter "ApiName eq '*' and GeoType eq '*'"

Vermeld de E2E-latentie van een opslagaccount en splitst de gegevensreeks op basis van de API-naam en het geo-type. De API-naam wordt beperkt tot 'DeleteContainer'

az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
                        --filter "ApiName eq 'DeleteContainer' and GeoType eq '*'"

Transacties van een opslagaccount per dag weergeven sinds 2017-01-01

az monitor metrics list --resource {ResourceName} --metric Transactions \
                        --start-time 2017-01-01T00:00:00Z \
                        --interval PT24H

Geef de metagegevenswaarden voor een opslagaccount weer onder de API-naamdimensie van de metrische transactiegegevens sinds 2017

az monitor metrics list --resource {ResourceName} --metric Transactions \
                        --filter "ApiName eq '*'" \
                        --start-time 2017-01-01T00:00:00Z

Vereiste parameters

--resource

Naam of id van de doelresource.

Eigenschap Waarde
Parametergroep: Target Resource Arguments

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.

--aggregation

De lijst met aggregatietypen (door spaties gescheiden) die moeten worden opgehaald.

Eigenschap Waarde
Geaccepteerde waarden: Average, Count, Maximum, Minimum, None, Total
Waarde vanaf: az monitor metrics list-definitions
--dimension

De lijst met dimensies (door spaties gescheiden) waar de metrische gegevens in worden opgevraagd.

Eigenschap Waarde
Waarde vanaf: az monitor metrics list-definitions
--end-time

Eindtijd van de query. De standaardinstelling is de huidige tijd. Notatie: datum (jjjj-mm-dd) tijd (uu:mm:ss.xxxxx) tijdzone (+/-hh:mm).

Eigenschap Waarde
Parametergroep: Time Arguments
--filter

Een tekenreeks die wordt gebruikt om de set metrische gegevens te verminderen die worden geretourneerd. eg. "BlobType eq "*".

Zie de filtertekenreeksreferentie op https://learn.microsoft.com/rest/api/monitor/metrics/listvoor een volledige lijst met filters.

--interval

Het interval voor het aggregeren van metrische gegevens, in ##h##m-indeling.

Eigenschap Waarde
Parametergroep: Time Arguments
Default value: 1m
--metadata

Retourneert de metagegevenswaarden in plaats van metrische gegevens.

--metrics

Door spaties gescheiden lijst met metrische namen om op te halen.

Eigenschap Waarde
Waarde vanaf: az monitor metrics list-definitions
--namespace

Naamruimte voor het opvragen van metrische definities voor.

Eigenschap Waarde
Waarde vanaf: az monitor metrics list-namespaces
--offset

Tijdsverschil van het querybereik, in ##d##h-indeling.

Kan worden gebruikt met --start-time of --end-time. Als deze wordt gebruikt met --begintijd, wordt de eindtijd berekend door de offset toe te voegen. Als deze wordt gebruikt met --end-time (standaard), wordt de begintijd berekend door de offset af te trekken. Als --begintijd en --eindtijd worden opgegeven, wordt --offset genegeerd.

Eigenschap Waarde
Parametergroep: Time Arguments
Default value: 1h
--orderby

Aggregatie die moet worden gebruikt voor het sorteren van resultaten en de richting van het sorteren. Er kan slechts één bestelling worden opgegeven. Voorbeelden: som asc.

--resource-group -g

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

Eigenschap Waarde
Parametergroep: Target Resource Arguments
--resource-namespace

Naamruimte van doelresourceprovider.

Eigenschap Waarde
Parametergroep: Target Resource Arguments
--resource-parent

Bovenliggend doelresourcepad, indien van toepassing.

Eigenschap Waarde
Parametergroep: Target Resource Arguments
--resource-type

Doelresourcetype. Kan ook de notatie van de naamruimte/het type accepteren (bijvoorbeeld : 'Microsoft.Compute/virtualMachines').

Eigenschap Waarde
Parametergroep: Target Resource Arguments
--start-time

Begintijd van de query. Notatie: datum (jjjj-mm-dd) tijd (uu:mm:ss.xxxxx) tijdzone (+/-hh:mm).

Eigenschap Waarde
Parametergroep: Time Arguments
--top

Maximum aantal records dat moet worden opgehaald.

Eigenschap Waarde
Default value: 10
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 metrics list-definitions

Geef de metrische definities voor de resource weer.

az monitor metrics list-definitions --resource
                                    [--namespace]
                                    [--resource-group]
                                    [--resource-namespace]
                                    [--resource-parent]
                                    [--resource-type]

Voorbeelden

Geef de metrische definities voor de resource weer. (autogenerated)

az monitor metrics list-definitions --resource /subscriptions/{subscriptionID}/resourceGroups/{resourceGroup}/Microsoft.Network/networkSecurityGroups/{resourceName}

Vereiste parameters

--resource

Naam of id van de doelresource.

Eigenschap Waarde
Parametergroep: Target Resource Arguments

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.

--namespace

Naamruimte voor het opvragen van metrische definities voor.

Eigenschap Waarde
Waarde vanaf: az monitor metrics list-namespaces
--resource-group -g

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

Eigenschap Waarde
Parametergroep: Target Resource Arguments
--resource-namespace

Naamruimte van doelresourceprovider.

Eigenschap Waarde
Parametergroep: Target Resource Arguments
--resource-parent

Bovenliggend doelresourcepad, indien van toepassing.

Eigenschap Waarde
Parametergroep: Target Resource Arguments
--resource-type

Doelresourcetype. Kan ook de notatie van de naamruimte/het type accepteren (bijvoorbeeld : 'Microsoft.Compute/virtualMachines').

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

--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 metrics list-namespaces

Preview

Deze opdracht is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Geef de metrische naamruimten voor de resource weer.

az monitor metrics list-namespaces --resource-uri
                                   [--start-time]

Voorbeelden

Geef de metrische naamruimten voor de resource weer.

az monitor metrics list-namespaces --resource /subscriptions/{subscriptionID}/resourceGroups/{resourceGroup}/Microsoft.Network/networkSecurityGroups/{resourceName} --start-time 2021-03-01T00:00:00Z

Vereiste parameters

--resource-uri

De id van de resource.

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.

--start-time

Begintijd van de query. Notatie: datum (jjjj-mm-dd) tijd (uu:mm:ss.xxxxx) tijdzone (+/-hh:mm).

Eigenschap Waarde
Parametergroep: Time 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.

--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 metrics list-sub

Toont de metrische gegevens voor een abonnement. Parameters kunnen worden opgegeven op de hoofdtekst.

az monitor metrics list-sub --region
                            [--aggregation]
                            [--auto-adjust-timegrain {0, 1, f, false, n, no, t, true, y, yes}]
                            [--filter]
                            [--interval]
                            [--metricnames]
                            [--metricnamespace]
                            [--order-by]
                            [--result-type {Data, Metadata}]
                            [--roll-up-by]
                            [--timespan]
                            [--top]
                            [--validate-dimensions {0, 1, f, false, n, no, t, true, y, yes}]

Vereiste parameters

--region

De regio waarin de gewenste metrische gegevens zich bevinden.

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.

--aggregation

De lijst met aggregatietypen (door komma's gescheiden) die moeten worden opgehaald.

Eigenschap Waarde
Parametergroep: Body Arguments
--auto-adjust-timegrain

Als de doorgegeven tijdsperiode niet wordt ondersteund door deze metrische waarde, retourneert de API het resultaat met behulp van de dichtstbijzijnde ondersteunde periode. Als deze waarde is ingesteld op onwaar, wordt er een fout geretourneerd voor ongeldige tijdspanneparameters. Standaard ingesteld op onwaar.

Eigenschap Waarde
Parametergroep: Body Arguments
Geaccepteerde waarden: 0, 1, f, false, n, no, t, true, y, yes
--filter

De $filter wordt gebruikt om de set metrische gegevens te verminderen die worden geretourneerd.
Example:
Metrische gegevens bevatten metagegevens A, B en C.
- Alle tijdreeksen van C retourneren waarbij A = a1 en B = b1 of b2
$filter=A eq 'a1' en B eq 'b1' of B eq 'b2' en C eq '*'
- Ongeldige variant:
$filter=A eq 'a1' en B eq 'b1' en C eq '*' of B = 'b2'
Dit is ongeldig omdat de logische of operator twee verschillende metagegevensnamen niet kan scheiden.
- Alle tijdreeksen retourneren waarbij A = a1, B = b1 en C = c1:
$filter=A eq 'a1' en B eq 'b1' en C eq 'c1'
- Alle tijdreeksen retourneren waarbij A = a1
$filter=A eq 'a1' en B eq '' en C eq ''.

Eigenschap Waarde
Parametergroep: Body Arguments
--interval

Het interval (bijvoorbeeld timegrain) van de query in iso 8601-duurnotatie. Standaard ingesteld op PT1M. Speciale case voor 'FULL'-waarde die één gegevenspunt retourneert voor een volledige periode die is aangevraagd. Voorbeelden: PT15M, PT1H, P1D, FULL.

Eigenschap Waarde
Parametergroep: Body Arguments
--metricnames

De namen van de metrische gegevens (door komma's gescheiden) die moeten worden opgehaald.

Eigenschap Waarde
Parametergroep: Body Arguments
--metricnamespace

Metrische naamruimte waarin de gewenste metrische gegevens zich bevinden.

Eigenschap Waarde
Parametergroep: Body Arguments
--order-by

De aggregatie die moet worden gebruikt voor het sorteren van resultaten en de richting van de sortering. Er kan slechts één bestelling worden opgegeven. Voorbeelden: som asc.

Eigenschap Waarde
Parametergroep: Body Arguments
--result-type

Vermindert de set verzamelde gegevens. De toegestane syntaxis is afhankelijk van de bewerking. Zie de beschrijving van de bewerking voor meer informatie.

Eigenschap Waarde
Parametergroep: Body Arguments
Geaccepteerde waarden: Data, Metadata
--roll-up-by

Dimensienaam(en) om resultaten samen te vouwen op. Als u bijvoorbeeld alleen metrische waarden wilt zien met een filter zoals 'City eq Seattle of City eq Tacoma', maar geen afzonderlijke waarden voor elke stad wilt zien, kunt u RollUpBy=City opgeven om de resultaten voor Seattle en Tacoma in één tijdreeks te zien.

Eigenschap Waarde
Parametergroep: Body Arguments
--timespan

De tijdsduur van de query. Het is een tekenreeks met de volgende notatie 'startDateTime_ISO/endDateTime_ISO'.

Eigenschap Waarde
Parametergroep: Body Arguments
--top

Het maximum aantal records dat moet worden opgehaald. Alleen geldig als $filter is opgegeven. De standaardwaarde is 10.

Eigenschap Waarde
Parametergroep: Body Arguments
--validate-dimensions

Als deze waarde is ingesteld op onwaar, worden ongeldige filterparameterwaarden genegeerd. Als deze waarde is ingesteld op true, wordt er een fout geretourneerd voor ongeldige filterparameters. De standaardwaarde is waar.

Eigenschap Waarde
Parametergroep: Body Arguments
Geaccepteerde waarden: 0, 1, f, false, n, no, t, true, y, yes
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 metrics list-sub-definitions

Geef de metrische definities voor het abonnement weer.

az monitor metrics list-sub-definitions --region
                                        [--metricnamespace]

Vereiste parameters

--region

De regio waarin de gewenste metrische gegevens zich bevinden.

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.

--metricnamespace

Metrische naamruimte waarin de gewenste metrische gegevens zich bevinden.

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