az monitor metrics

  • Referentie

Metrische gegevens van Azure-resources weergeven.

Opdracht

Name Description Type Status
az monitor metrics alert

Regels voor waarschuwingen voor bijna realtime metrische gegevens beheren.

 Basis GA
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 list

Geef de metrische waarden voor een resource weer.

 Basis GA
az monitor metrics list-definitions

Geef de metrische definities voor de resource weer.

 Basis GA
az monitor metrics list-namespaces

Geef de metrische naamruimten voor de resource weer.

 Basis Preview
az monitor metrics list-sub

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

 Basis GA
az monitor metrics list-sub-definitions

Geef de metrische definities voor het abonnement weer.

 Basis GA

az monitor metrics list

Bewerken

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.

Optionele parameters

--aggregation

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

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.

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

--filter

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

Zie voor een volledige lijst met filters de verwijzing naar de filtertekenreeks op https://docs.microsoft.com/rest/api/monitor/metrics/list.

--interval

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

standaardwaarde: 1m
--metadata

Retourneert de metagegevenswaarden in plaats van metrische gegevens.

--metrics

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

waarde vanaf: az monitor metrics list-definitions
--namespace

Naamruimte voor het opvragen van metrische definities voor.

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.

standaardwaarde: 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

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

--resource-namespace

Naamruimte van doelresourceprovider.

--resource-parent

Bovenliggend doelresourcepad, indien van toepassing.

--resource-type

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

--start-time

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

--top

Maximum aantal records dat moet worden opgehaald.

standaardwaarde: 10
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 list-definitions

Bewerken

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. (automatisch gegenereerd)

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

Vereiste parameters

--resource

Naam of id van de doelresource.

Optionele parameters

--namespace

Naamruimte voor het opvragen van metrische definities voor.

waarde vanaf: az monitor metrics list-namespaces
--resource-group -g

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

--resource-namespace

Naamruimte van doelresourceprovider.

--resource-parent

Bovenliggend doelresourcepad, indien van toepassing.

--resource-type

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

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

Bewerken
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

--start-time

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

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

Bewerken

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

--aggregation

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

--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. De standaardwaarde is onwaar.

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.
Voorbeeld:
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 ''.

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

--metricnames

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

--metricnamespace

Metrische naamruimte waarin de gewenste metrische gegevens zich bevinden.

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

--result-type

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

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.

--timespan

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

--top

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

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

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.

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

Bewerken

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

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

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