az monitor metrics

  • Referenz

Anzeigen von Azure-Ressourcenmetriken.

Befehle

Name Beschreibung Typ Status
az monitor metrics alert

Verwalten Von Warnungsregeln für metrische Benachrichtigungen in Nahezu-Echtzeit.

 Core Allgemein verfügbar
az monitor metrics alert condition

Verwalten Von Regelbedingungen für metrische Warnungen in Nahezu-Echtzeit.

 Core Allgemein verfügbar
az monitor metrics alert condition create

Erstellen Sie eine metrische Warnungsregelbedingung.

 Core Vorschau
az monitor metrics alert create

Erstellen Sie eine metrikbasierte Warnungsregel.

 Core Allgemein verfügbar
az monitor metrics alert delete

Löschen einer metrikbasierten Warnungsregel.

 Core Allgemein verfügbar
az monitor metrics alert dimension

Verwalten Von Warnungsregelabmessungen in Nahezu-Echtzeit.

 Core Allgemein verfügbar
az monitor metrics alert dimension create

Erstellen Sie eine Metrik-Warnungsregeldimension.

 Core Vorschau
az monitor metrics alert list

Listen Sie metrikbasierte Warnungsregeln auf.

 Core Allgemein verfügbar
az monitor metrics alert show

Anzeigen einer metrikbasierten Warnungsregel.

 Core Allgemein verfügbar
az monitor metrics alert update

Aktualisieren einer metrikbasierten Warnungsregel.

 Core Allgemein verfügbar
az monitor metrics list

Listet die Metrikwerte für eine Ressource auf.

 Core Allgemein verfügbar
az monitor metrics list-definitions

Listen Sie die Metrikdefinitionen für die Ressource auf.

 Core Allgemein verfügbar
az monitor metrics list-namespaces

Listen Sie die Metriknamespaces für die Ressource auf.

 Core Vorschau
az monitor metrics list-sub

Listet die Metrikdaten für ein Abonnement auf. Parameter können im Textkörper angegeben werden.

 Core Allgemein verfügbar
az monitor metrics list-sub-definitions

Listen Sie die Metrikdefinitionen für das Abonnement auf.

 Core Allgemein verfügbar

az monitor metrics list

Bearbeiten

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.

Optionale Parameter

--aggregation

Die Liste der aggregationstypen (durch Leerzeichen getrennt), die abgerufen werden sollen.

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.

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

Die Endzeit der Abfrage. Der Standardwert ist die aktuelle Uhrzeit. Format: Uhrzeit (jjjj-mm-tt) (hh:mm:ss.xxxxx) Zeitzone (+/-hh:mm).

--filter

Eine Zeichenfolge, die zum Reduzieren der zurückgegebenen Metrikdaten verwendet wird. Beispiel: "BlobType eq '*'".

Eine vollständige Liste der Filter finden Sie in der Filterzeichenfolgenreferenz unter https://docs.microsoft.com/rest/api/monitor/metrics/list.

--interval

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

Standardwert: 1m
--metadata

Gibt die Metadatenwerte anstelle von Metrikdaten zurück.

--metrics

Durch Leerzeichen getrennte Liste der abzurufenden Metriknamen.

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

Namespace zum Abfragen von Metrikdefinitionen für.

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

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

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.

--resource-namespace

Namespace des Zielressourcenanbieters.

--resource-parent

Übergeordneter Zielpfad der Ressource, falls zutreffend.

--resource-type

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

--start-time

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

--top

Max. Anzahl der abzurufenden Datensätze.

Standardwert: 10
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az monitor metrics list-definitions

Bearbeiten

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

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

Erforderliche Parameter

--resource

Name oder ID der Zielressource.

Optionale Parameter

--namespace

Namespace zum Abfragen von Metrikdefinitionen für.

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.

--resource-namespace

Namespace des Zielressourcenanbieters.

--resource-parent

Übergeordneter Zielpfad der Ressource, falls zutreffend.

--resource-type

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az monitor metrics list-namespaces

Bearbeiten
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

--start-time

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az monitor metrics list-sub

Bearbeiten

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

--aggregation

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

--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. Der Standardwert ist „false“.

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

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

--metricnames

Die Namen der abzurufenden Metriken (kommagetrennt).

--metricnamespace

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

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

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

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.

--timespan

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

--top

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

--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. Der Standardwert ist TRUE.

Zulässige Werte: 0, 1, f, false, n, no, t, true, y, yes
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az monitor metrics list-sub-definitions

Bearbeiten

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

--metricnamespace

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.