Freigeben über


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

--resource

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.

--aggregation

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

Die Liste der Dimensionen (durch Leerzeichen getrennt) werden die Metriken abgefragt.

Eigenschaft Wert
Wert aus: az monitor metrics list-definitions
--end-time

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

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.

--interval

Das Intervall, über das Metriken aggregiert werden sollen, im Format "##h##m".

Eigenschaft Wert
Parametergruppe: Time Arguments
Standardwert: 1m
--metadata

Gibt die Metadatenwerte anstelle von Metrikdaten zurück.

--metrics

Durch Leerzeichen getrennte Liste der abzurufenden Metriknamen.

Eigenschaft Wert
Wert aus: az monitor metrics list-definitions
--namespace

Namespace zum Abfragen von Metrikdefinitionen für.

Eigenschaft Wert
Wert aus: az monitor metrics list-namespaces
--offset

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

Aggregation, die zum Sortieren von Ergebnissen und zur Richtung der Sortierung verwendet werden soll. Es kann nur eine Bestellung spezifisch sein. Beispiele: Summe asc.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Eigenschaft Wert
Parametergruppe: Target Resource Arguments
--resource-namespace

Namespace des Zielressourcenanbieters.

Eigenschaft Wert
Parametergruppe: Target Resource Arguments
--resource-parent

Übergeordneter Zielpfad der Ressource, falls zutreffend.

Eigenschaft Wert
Parametergruppe: Target Resource Arguments
--resource-type

Zielressourcentyp. Kann auch das Namespace-/Typformat akzeptieren (z. B. 'Microsoft.Compute/virtualMachines').

Eigenschaft Wert
Parametergruppe: Target Resource Arguments
--start-time

Die Startzeit der Abfrage. Format: Datum (jjjj-mm-dd) Uhrzeit (hh:mm:ss.xxxxx) Zeitzone (+/-hh:mm).

Eigenschaft Wert
Parametergruppe: Time Arguments
--top

Max. Anzahl der abzurufenden Datensätze.

Eigenschaft Wert
Standardwert: 10
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

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

--resource

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

Namespace zum Abfragen von Metrikdefinitionen für.

Eigenschaft Wert
Wert aus: az monitor metrics list-namespaces
--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Eigenschaft Wert
Parametergruppe: Target Resource Arguments
--resource-namespace

Namespace des Zielressourcenanbieters.

Eigenschaft Wert
Parametergruppe: Target Resource Arguments
--resource-parent

Übergeordneter Zielpfad der Ressource, falls zutreffend.

Eigenschaft Wert
Parametergruppe: Target Resource Arguments
--resource-type

Zielressourcentyp. Kann auch das Namespace-/Typformat akzeptieren (z. B. 'Microsoft.Compute/virtualMachines').

Eigenschaft Wert
Parametergruppe: Target Resource Arguments
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

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

Vorschau

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

--resource-uri

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.

--start-time

Die Startzeit der Abfrage. Format: Datum (jjjj-mm-dd) Uhrzeit (hh:mm:ss.xxxxx) Zeitzone (+/-hh:mm).

Eigenschaft Wert
Parametergruppe: Time Arguments
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

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

--region

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.

--aggregation

Die Liste der aggregationstypen (kommagetrennt), die abgerufen werden sollen.

Eigenschaft Wert
Parametergruppe: Body Arguments
--auto-adjust-timegrain

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

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

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

Die Namen der abzurufenden Metriken (kommagetrennt).

Eigenschaft Wert
Parametergruppe: Body Arguments
--metricnamespace

Metrischer Namespace, in dem sich die gewünschten Metriken befinden.

Eigenschaft Wert
Parametergruppe: Body Arguments
--order-by

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
--result-type

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
--roll-up-by

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

Der Zeitbereich der Abfrage. Es handelt sich um eine Zeichenfolge mit dem folgenden Format "startDateTime_ISO/endDateTime_ISO".

Eigenschaft Wert
Parametergruppe: Body Arguments
--top

Die maximale Anzahl der abzurufenden Datensätze. Nur gültig, wenn $filter angegeben ist. Standardwert ist 10.

Eigenschaft Wert
Parametergruppe: Body Arguments
--validate-dimensions

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

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

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

--region

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.

--metricnamespace

Metrischer Namespace, in dem sich die gewünschten Metriken befinden.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False