az monitor metrics
Anzeigen von Azure-Ressourcenmetriken.
Befehle
| Name | Beschreibung | Typ | Status |
|---|---|---|---|
| az monitor metrics alert |
Verwalten Von Warnungsregeln für metrische Benachrichtigungen in Nahezu-Echtzeit. |
Core | GA |
| az monitor metrics alert condition |
Verwalten Von Regelbedingungen für metrische Warnungen in Nahezu-Echtzeit. |
Core | GA |
| az monitor metrics alert condition create |
Erstellen Sie eine metrische Warnungsregelbedingung. |
Core | Preview |
| az monitor metrics alert create |
Erstellen Sie eine metrikbasierte Warnungsregel. |
Core | GA |
| az monitor metrics alert delete |
Löschen einer metrikbasierten Warnungsregel. |
Core | GA |
| az monitor metrics alert dimension |
Verwalten Von Warnungsregelabmessungen in Nahezu-Echtzeit. |
Core | GA |
| az monitor metrics alert dimension create |
Erstellen Sie eine Metrik-Warnungsregeldimension. |
Core | Preview |
| az monitor metrics alert list |
Listen Sie metrikbasierte Warnungsregeln auf. |
Core | GA |
| az monitor metrics alert show |
Anzeigen einer metrikbasierten Warnungsregel. |
Core | GA |
| az monitor metrics alert update |
Aktualisieren einer metrikbasierten Warnungsregel. |
Core | GA |
| az monitor metrics list |
Listet die Metrikwerte für eine Ressource auf. |
Core | GA |
| az monitor metrics list-definitions |
Listen Sie die Metrikdefinitionen für die Ressource auf. |
Core | GA |
| az monitor metrics list-namespaces |
Listen Sie die Metriknamespaces für die Ressource auf. |
Core | Preview |
| az monitor metrics list-sub |
Listet die Metrikdaten für ein Abonnement auf. Parameter können im Textkörper angegeben werden. |
Core | GA |
| az monitor metrics list-sub-definitions |
Listen Sie die Metrikdefinitionen für das Abonnement auf. |
Core | GA |
az monitor metrics list
Listet die Metrikwerte für eine Ressource auf.
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]
Beispiele
Auflisten der CPU-Auslastung eines virtuellen Computers für die letzte Stunde
az monitor metrics list --resource {ResourceName} --metric "Percentage CPU"
E2E-Latenz eines Speicherkontos auflisten und die Datenreihe basierend auf dem API-Namen aufteilen
az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
--dimension ApiName
E2E-Latenz eines Speicherkontos auflisten und die Datenreihe basierend auf API-Name und Geotyp aufteilen
az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
--dimension ApiName GeoType
E2E-Latenz eines Speicherkontos auflisten und die Datenreihe basierend auf API-Name und Geotyp mithilfe des Parameters "--filter" aufteilen
az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
--filter "ApiName eq '*' and GeoType eq '*'"
Listet die E2E-Latenz eines Speicherkontos auf und teilt die Datenreihe basierend auf API-Name und Geotyp auf. Beschränkt den API-Namen auf "DeleteContainer"
az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
--filter "ApiName eq 'DeleteContainer' and GeoType eq '*'"
Auflisten von Transaktionen eines Speicherkontos pro Tag seit 2017-01-01
az monitor metrics list --resource {ResourceName} --metric Transactions \
--start-time 2017-01-01T00:00:00Z \
--interval PT24H
Auflisten der Metadatenwerte für ein Speicherkonto unter der Api-Namensdimension der Transaktionsmetrik seit 2017
az monitor metrics list --resource {ResourceName} --metric Transactions \
--filter "ApiName eq '*'" \
--start-time 2017-01-01T00:00:00Z
Erforderliche Parameter
Name oder ID der Zielressource.
| Eigenschaft | Wert |
|---|---|
| Parametergruppe: | Target Resource Arguments |
Optionale Parameter
Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.
Die Liste der aggregationstypen (durch Leerzeichen getrennt), die abgerufen werden sollen.
| Eigenschaft | Wert |
|---|---|
| Zulässige Werte: | Average, Count, Maximum, Minimum, None, Total |
| Wert aus: | az monitor metrics list-definitions |
Die Liste der Dimensionen (durch Leerzeichen getrennt) werden die Metriken abgefragt.
| Eigenschaft | Wert |
|---|---|
| Wert aus: | az monitor metrics list-definitions |
Die Endzeit der Abfrage. Der Standardwert ist die aktuelle Uhrzeit. Format: Datum (jjjj-mm-dd) Uhrzeit (hh:mm:ss.xxxxx) Zeitzone (+/-hh:mm).
| Eigenschaft | Wert |
|---|---|
| Parametergruppe: | Time Arguments |
Eine Zeichenfolge, die zum Reduzieren der zurückgegebenen Metrikdaten verwendet wird. eg. "BlobType eq '*'".
Eine vollständige Liste der Filter finden Sie in der Filterzeichenfolgenreferenz unter https://learn.microsoft.com/rest/api/monitor/metrics/list.
Das Intervall, über das Metriken aggregiert werden sollen, im Format "##h##m".
| Eigenschaft | Wert |
|---|---|
| Parametergruppe: | Time Arguments |
| Standardwert: | 1m |
Gibt die Metadatenwerte anstelle von Metrikdaten zurück.
Durch Leerzeichen getrennte Liste der abzurufenden Metriknamen.
| Eigenschaft | Wert |
|---|---|
| Wert aus: | az monitor metrics list-definitions |
Namespace zum Abfragen von Metrikdefinitionen für.
| Eigenschaft | Wert |
|---|---|
| Wert aus: | az monitor metrics list-namespaces |
Zeitoffset des Abfragebereichs im Format "##d##h".
Kann entweder mit --start-time oder --end-time verwendet werden. Wenn sie mit --start-time verwendet wird, wird die Endzeit durch Hinzufügen des Offsets berechnet. Bei Verwendung mit --end-time (Standard) wird die Startzeit berechnet, indem der Offset subtrahiert wird. Wenn --start-time und --end-time bereitgestellt werden, wird --offset ignoriert.
| Eigenschaft | Wert |
|---|---|
| Parametergruppe: | Time Arguments |
| Standardwert: | 1h |
Aggregation, die zum Sortieren von Ergebnissen und zur Richtung der Sortierung verwendet werden soll. Es kann nur eine Bestellung spezifisch sein. Beispiele: Summe asc.
Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.
| Eigenschaft | Wert |
|---|---|
| Parametergruppe: | Target Resource Arguments |
Namespace des Zielressourcenanbieters.
| Eigenschaft | Wert |
|---|---|
| Parametergruppe: | Target Resource Arguments |
Übergeordneter Zielpfad der Ressource, falls zutreffend.
| Eigenschaft | Wert |
|---|---|
| Parametergruppe: | Target Resource Arguments |
Zielressourcentyp. Kann auch das Namespace-/Typformat akzeptieren (z. B. 'Microsoft.Compute/virtualMachines').
| Eigenschaft | Wert |
|---|---|
| Parametergruppe: | Target Resource Arguments |
Die Startzeit der Abfrage. Format: Datum (jjjj-mm-dd) Uhrzeit (hh:mm:ss.xxxxx) Zeitzone (+/-hh:mm).
| Eigenschaft | Wert |
|---|---|
| Parametergruppe: | Time Arguments |
Max. Anzahl der abzurufenden Datensätze.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | 10 |
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | False |
Diese Hilfemeldung anzeigen und schließen.
Nur Fehler anzeigen, Warnungen unterdrücken.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | False |
Ausgabeformat.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | json |
| Zulässige Werte: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | False |
az monitor metrics list-definitions
Listen Sie die Metrikdefinitionen für die Ressource auf.
az monitor metrics list-definitions --resource
[--namespace]
[--resource-group]
[--resource-namespace]
[--resource-parent]
[--resource-type]
Beispiele
Listen Sie die Metrikdefinitionen für die Ressource auf. (autogenerated)
az monitor metrics list-definitions --resource /subscriptions/{subscriptionID}/resourceGroups/{resourceGroup}/Microsoft.Network/networkSecurityGroups/{resourceName}
Erforderliche Parameter
Name oder ID der Zielressource.
| Eigenschaft | Wert |
|---|---|
| Parametergruppe: | Target Resource Arguments |
Optionale Parameter
Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.
Namespace zum Abfragen von Metrikdefinitionen für.
| Eigenschaft | Wert |
|---|---|
| Wert aus: | az monitor metrics list-namespaces |
Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.
| Eigenschaft | Wert |
|---|---|
| Parametergruppe: | Target Resource Arguments |
Namespace des Zielressourcenanbieters.
| Eigenschaft | Wert |
|---|---|
| Parametergruppe: | Target Resource Arguments |
Übergeordneter Zielpfad der Ressource, falls zutreffend.
| Eigenschaft | Wert |
|---|---|
| Parametergruppe: | Target Resource Arguments |
Zielressourcentyp. Kann auch das Namespace-/Typformat akzeptieren (z. B. 'Microsoft.Compute/virtualMachines').
| Eigenschaft | Wert |
|---|---|
| Parametergruppe: | Target Resource Arguments |
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | False |
Diese Hilfemeldung anzeigen und schließen.
Nur Fehler anzeigen, Warnungen unterdrücken.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | False |
Ausgabeformat.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | json |
| Zulässige Werte: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | False |
az monitor metrics list-namespaces
Dieser Befehl befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus
Listen Sie die Metriknamespaces für die Ressource auf.
az monitor metrics list-namespaces --resource-uri
[--start-time]
Beispiele
Listen Sie die Metriknamespaces für die Ressource auf.
az monitor metrics list-namespaces --resource /subscriptions/{subscriptionID}/resourceGroups/{resourceGroup}/Microsoft.Network/networkSecurityGroups/{resourceName} --start-time 2021-03-01T00:00:00Z
Erforderliche Parameter
Der Bezeichner der Ressource.
Optionale Parameter
Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.
Die Startzeit der Abfrage. Format: Datum (jjjj-mm-dd) Uhrzeit (hh:mm:ss.xxxxx) Zeitzone (+/-hh:mm).
| Eigenschaft | Wert |
|---|---|
| Parametergruppe: | Time Arguments |
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | False |
Diese Hilfemeldung anzeigen und schließen.
Nur Fehler anzeigen, Warnungen unterdrücken.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | False |
Ausgabeformat.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | json |
| Zulässige Werte: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | False |
az monitor metrics list-sub
Listet die Metrikdaten für ein Abonnement auf. Parameter können im Textkörper angegeben werden.
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}]
Erforderliche Parameter
Die Region, in der sich die gewünschten Metriken befinden.
Optionale Parameter
Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.
Die Liste der aggregationstypen (kommagetrennt), die abgerufen werden sollen.
| Eigenschaft | Wert |
|---|---|
| Parametergruppe: | Body Arguments |
Wenn dieser Wert auf "true" festgelegt ist, wenn der übergebene Zeitbereich von dieser Metrik nicht unterstützt wird, gibt die API das Ergebnis mithilfe des nächstgelegenen unterstützten Zeitbereichs zurück. Wenn dieser Wert auf "false" festgelegt ist, wird ein Fehler für ungültige Zeitbereichsparameter zurückgegeben. Standardwert ist "false".
| Eigenschaft | Wert |
|---|---|
| Parametergruppe: | Body Arguments |
| Zulässige Werte: | 0, 1, f, false, n, no, t, true, y, yes |
Die $filter wird verwendet, um den Satz zurückgegebener Metrikdaten zu reduzieren.
Example:
Die Metrik enthält Metadaten A, B und C.
- Gibt alle Zeitreihen von C zurück, wobei A = a1 und B = b1 oder b2
$filter=A eq 'a1' und B eq 'b1' oder B eq 'b2' und C eq '*'
- Ungültige Variante:
$filter=A eq 'a1' und B eq 'b1' und C eq '*' oder B = 'b2'
Dies ist ungültig, da der logische Oder Operator zwei unterschiedliche Metadatennamen nicht trennen kann.
- Gibt alle Zeitreihen zurück, wobei A = a1, B = b1 und C = c1:
$filter=A eq 'a1' und B eq 'b1' und C eq 'c1'
- Gibt alle Zeitreihen zurück, wobei A = a1
$filter=A eq 'a1' und B eq '' und C eq ''.
| Eigenschaft | Wert |
|---|---|
| Parametergruppe: | Body Arguments |
Das Intervall (d. h. Zeitgran) der Abfrage im ISO 8601-Dauerformat. Standardwert ist PT1M. Sonderfall für den Wert "FULL", der einen einzelnen Datenpunkt für die gesamte angeforderte Zeitspanne zurückgibt. Beispiele: PT15M, PT1H, P1D, FULL.
| Eigenschaft | Wert |
|---|---|
| Parametergruppe: | Body Arguments |
Die Namen der abzurufenden Metriken (kommagetrennt).
| Eigenschaft | Wert |
|---|---|
| Parametergruppe: | Body Arguments |
Metrischer Namespace, in dem sich die gewünschten Metriken befinden.
| Eigenschaft | Wert |
|---|---|
| Parametergruppe: | Body Arguments |
Die Aggregation, die zum Sortieren von Ergebnissen und zur Richtung der Sortierung verwendet werden soll. Es kann nur eine Bestellung angegeben werden. Beispiele: Summe asc.
| Eigenschaft | Wert |
|---|---|
| Parametergruppe: | Body Arguments |
Reduziert die Menge der gesammelten Daten. Die zulässige Syntax hängt vom Vorgang ab. Details finden Sie in der Beschreibung des Vorgangs.
| Eigenschaft | Wert |
|---|---|
| Parametergruppe: | Body Arguments |
| Zulässige Werte: | Data, Metadata |
Bemaßungsname(n) zum Rollup der Ergebnisse nach. Wenn Sie beispielsweise nur Metrikwerte mit einem Filter wie "City eq Seattle oder City eq Tacoma" anzeigen möchten, aber keine separaten Werte für jede Stadt sehen möchten, können Sie "RollUpBy=City" angeben, um die Ergebnisse für Seattle und Tacoma in einer Zeitserie anzuzeigen.
| Eigenschaft | Wert |
|---|---|
| Parametergruppe: | Body Arguments |
Der Zeitbereich der Abfrage. Es handelt sich um eine Zeichenfolge mit dem folgenden Format "startDateTime_ISO/endDateTime_ISO".
| Eigenschaft | Wert |
|---|---|
| Parametergruppe: | Body Arguments |
Die maximale Anzahl der abzurufenden Datensätze. Nur gültig, wenn $filter angegeben ist. Standardwert ist 10.
| Eigenschaft | Wert |
|---|---|
| Parametergruppe: | Body Arguments |
Wenn dieser Wert auf "false" festgelegt ist, werden ungültige Filterparameterwerte ignoriert. Wenn dieser Wert auf "true" festgelegt ist, wird ein Fehler für ungültige Filterparameter zurückgegeben. Standardwert ist "true".
| Eigenschaft | Wert |
|---|---|
| Parametergruppe: | Body Arguments |
| Zulässige Werte: | 0, 1, f, false, n, no, t, true, y, yes |
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | False |
Diese Hilfemeldung anzeigen und schließen.
Nur Fehler anzeigen, Warnungen unterdrücken.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | False |
Ausgabeformat.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | json |
| Zulässige Werte: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | False |
az monitor metrics list-sub-definitions
Listen Sie die Metrikdefinitionen für das Abonnement auf.
az monitor metrics list-sub-definitions --region
[--metricnamespace]
Erforderliche Parameter
Die Region, in der sich die gewünschten Metriken befinden.
Optionale Parameter
Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.
Metrischer Namespace, in dem sich die gewünschten Metriken befinden.
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | False |
Diese Hilfemeldung anzeigen und schließen.
Nur Fehler anzeigen, Warnungen unterdrücken.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | False |
Ausgabeformat.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | json |
| Zulässige Werte: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | False |