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
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.
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 |
De lijst met dimensies (door spaties gescheiden) waar de metrische gegevens in worden opgevraagd.
| Eigenschap | Waarde |
|---|---|
| Waarde vanaf: | az monitor metrics list-definitions |
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 |
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.
Het interval voor het aggregeren van metrische gegevens, in ##h##m-indeling.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Time Arguments |
| Default value: | 1m |
Retourneert de metagegevenswaarden in plaats van metrische gegevens.
Door spaties gescheiden lijst met metrische namen om op te halen.
| Eigenschap | Waarde |
|---|---|
| Waarde vanaf: | az monitor metrics list-definitions |
Naamruimte voor het opvragen van metrische definities voor.
| Eigenschap | Waarde |
|---|---|
| Waarde vanaf: | az monitor metrics list-namespaces |
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 |
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.
Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Target Resource Arguments |
Naamruimte van doelresourceprovider.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Target Resource Arguments |
Bovenliggend doelresourcepad, indien van toepassing.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Target Resource Arguments |
Doelresourcetype. Kan ook de notatie van de naamruimte/het type accepteren (bijvoorbeeld : 'Microsoft.Compute/virtualMachines').
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Target Resource Arguments |
Begintijd van de query. Notatie: datum (jjjj-mm-dd) tijd (uu:mm:ss.xxxxx) tijdzone (+/-hh:mm).
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Time Arguments |
Maximum aantal records dat moet worden opgehaald.
| Eigenschap | Waarde |
|---|---|
| Default value: | 10 |
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
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
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.
Naamruimte voor het opvragen van metrische definities voor.
| Eigenschap | Waarde |
|---|---|
| Waarde vanaf: | az monitor metrics list-namespaces |
Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Target Resource Arguments |
Naamruimte van doelresourceprovider.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Target Resource Arguments |
Bovenliggend doelresourcepad, indien van toepassing.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Target Resource Arguments |
Doelresourcetype. Kan ook de notatie van de naamruimte/het type accepteren (bijvoorbeeld : 'Microsoft.Compute/virtualMachines').
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Target Resource Arguments |
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
az monitor metrics list-namespaces
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
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.
Begintijd van de query. Notatie: datum (jjjj-mm-dd) tijd (uu:mm:ss.xxxxx) tijdzone (+/-hh:mm).
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Time Arguments |
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
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
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.
De lijst met aggregatietypen (door komma's gescheiden) die moeten worden opgehaald.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Body Arguments |
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 |
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 |
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 |
De namen van de metrische gegevens (door komma's gescheiden) die moeten worden opgehaald.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Body Arguments |
Metrische naamruimte waarin de gewenste metrische gegevens zich bevinden.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Body Arguments |
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 |
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 |
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 |
De tijdsduur van de query. Het is een tekenreeks met de volgende notatie 'startDateTime_ISO/endDateTime_ISO'.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Body Arguments |
Het maximum aantal records dat moet worden opgehaald. Alleen geldig als $filter is opgegeven. De standaardwaarde is 10.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Body Arguments |
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
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
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
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.
Metrische naamruimte waarin de gewenste metrische gegevens zich bevinden.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |