Sdílet prostřednictvím


az monitor metrics

Zobrazení metrik prostředků Azure

Příkazy

Name Description Typ Stav
az monitor metrics alert

Spravujte pravidla upozornění metrik téměř v reálném čase.

Core GA
az monitor metrics alert condition

Spravujte podmínky pravidla upozornění na metriku téměř v reálném čase.

Core GA
az monitor metrics alert condition create

Vytvořte podmínku pravidla upozornění na metriku.

Core Preview
az monitor metrics alert create

Vytvořte pravidlo upozornění na základě metrik.

Core GA
az monitor metrics alert delete

Odstraňte pravidlo upozornění na základě metrik.

Core GA
az monitor metrics alert dimension

Spravujte dimenze pravidla upozornění na metriku téměř v reálném čase.

Core GA
az monitor metrics alert dimension create

Vytvořte dimenzi pravidla upozornění na metriku.

Core Preview
az monitor metrics alert list

Seznam pravidel upozornění založených na metrikách

Core GA
az monitor metrics alert show

Zobrazení pravidla upozornění na základě metrik

Core GA
az monitor metrics alert update

Aktualizujte pravidlo upozornění na základě metrik.

Core GA
az monitor metrics list

Zobrazí seznam hodnot metrik pro prostředek.

Core GA
az monitor metrics list-definitions

Vypíše definice metrik pro prostředek.

Core GA
az monitor metrics list-namespaces

Vypíše obory názvů metrik pro prostředek.

Core Preview
az monitor metrics list-sub

Zobrazí seznam dat metrik pro předplatné. Parametry lze zadat v těle.

Core GA
az monitor metrics list-sub-definitions

Vypíše definice metrik pro předplatné.

Core GA

az monitor metrics list

Zobrazí seznam hodnot metrik pro prostředek.

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]

Příklady

Zobrazení seznamu využití procesoru virtuálního počítače za poslední hodinu

az monitor metrics list --resource {ResourceName} --metric "Percentage CPU"

Vypsat latenci E2E účtu úložiště a rozdělit datovou řadu na základě názvu rozhraní API

az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
                        --dimension ApiName

Vypište latenci E2E účtu úložiště a rozdělte datovou řadu na základě názvu rozhraní API i geografického typu.

az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
                        --dimension ApiName GeoType

Vypište latenci E2E účtu úložiště a rozdělte datovou řadu na základě názvu rozhraní API i geografického typu pomocí parametru --filter.

az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
                        --filter "ApiName eq '*' and GeoType eq '*'"

Uveďte latenci E2E úspěšného účtu úložiště a rozdělte datovou řadu na základě názvu rozhraní API i geografického typu. Omezuje název rozhraní API na DeleteContainer.

az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
                        --filter "ApiName eq 'DeleteContainer' and GeoType eq '*'"

Výpis transakcí účtu úložiště za den od 1. 1. 2017

az monitor metrics list --resource {ResourceName} --metric Transactions \
                        --start-time 2017-01-01T00:00:00Z \
                        --interval PT24H

Výpis hodnot metadat pro účet úložiště v rámci dimenze názvu rozhraní API metriky transakcí od roku 2017

az monitor metrics list --resource {ResourceName} --metric Transactions \
                        --filter "ApiName eq '*'" \
                        --start-time 2017-01-01T00:00:00Z

Povinné parametry

--resource

Název nebo ID cílového prostředku

Vlastnost Hodnota
Skupina parametrů: Target Resource Arguments

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--aggregation

Seznam typů agregace (oddělených mezerami) k načtení.

Vlastnost Hodnota
Přípustné hodnoty: Average, Count, Maximum, Minimum, None, Total
Počáteční hodnota: az monitor metrics list-definitions
--dimension

Seznam dimenzí (oddělených mezerami) se metriky dotazují.

Vlastnost Hodnota
Počáteční hodnota: az monitor metrics list-definitions
--end-time

Koncový čas dotazu. Výchozí hodnota je aktuální čas. Formát: datum (rrrr-mm-dd) čas (hh:mm:ss.xxxxx) časové pásmo (+/-hh:mm).

Vlastnost Hodnota
Skupina parametrů: Time Arguments
--filter

Řetězec sloužící ke snížení sady vrácených dat metriky. eg. "BlobType eq '*'".

Úplný seznam filtrů najdete v odkazu na řetězec filtru na https://learn.microsoft.com/rest/api/monitor/metrics/list.

--interval

Interval agregace metrik ve formátu ##h##m.

Vlastnost Hodnota
Skupina parametrů: Time Arguments
Default value: 1m
--metadata

Vrátí hodnoty metadat místo dat metriky.

--metrics

Seznam názvů metrik oddělených mezerami, které se mají načíst.

Vlastnost Hodnota
Počáteční hodnota: az monitor metrics list-definitions
--namespace

Obor názvů pro dotazování definic metrik.

Vlastnost Hodnota
Počáteční hodnota: az monitor metrics list-namespaces
--offset

Časový posun rozsahu dotazu ve formátu ##d##h

Lze použít s --start-time nebo --end-time. Pokud použijete parametr --start-time, vypočítá se koncový čas přidáním posunu. Pokud se použije s --end-time (výchozí), počáteční čas se vypočítá odečtením posunu. Pokud je k dispozici --start-time a --end-time, bude posun --offset ignorován.

Vlastnost Hodnota
Skupina parametrů: Time Arguments
Default value: 1h
--orderby

Agregace, která se má použít k řazení výsledků a směru řazení. Je možné určit pouze jednu objednávku. Příklady: sum asc.

--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Vlastnost Hodnota
Skupina parametrů: Target Resource Arguments
--resource-namespace

Obor názvů poskytovatele cílových prostředků

Vlastnost Hodnota
Skupina parametrů: Target Resource Arguments
--resource-parent

Cílová nadřazená cesta prostředku, pokud je k dispozici.

Vlastnost Hodnota
Skupina parametrů: Target Resource Arguments
--resource-type

Typ cílového prostředku. Může také přijmout formát oboru názvů nebo typu (např. Microsoft.Compute/virtualMachines).

Vlastnost Hodnota
Skupina parametrů: Target Resource Arguments
--start-time

Počáteční čas dotazu. Formát: datum (rrrr-mm-dd) čas (hh:mm:ss.xxxxx) časové pásmo (+/-hh:mm).

Vlastnost Hodnota
Skupina parametrů: Time Arguments
--top

Maximální počet záznamů, které se mají načíst.

Vlastnost Hodnota
Default value: 10
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False

az monitor metrics list-definitions

Vypíše definice metrik pro prostředek.

az monitor metrics list-definitions --resource
                                    [--namespace]
                                    [--resource-group]
                                    [--resource-namespace]
                                    [--resource-parent]
                                    [--resource-type]

Příklady

Vypíše definice metrik pro prostředek. (autogenerated)

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

Povinné parametry

--resource

Název nebo ID cílového prostředku

Vlastnost Hodnota
Skupina parametrů: Target Resource Arguments

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--namespace

Obor názvů pro dotazování definic metrik.

Vlastnost Hodnota
Počáteční hodnota: az monitor metrics list-namespaces
--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Vlastnost Hodnota
Skupina parametrů: Target Resource Arguments
--resource-namespace

Obor názvů poskytovatele cílových prostředků

Vlastnost Hodnota
Skupina parametrů: Target Resource Arguments
--resource-parent

Cílová nadřazená cesta prostředku, pokud je k dispozici.

Vlastnost Hodnota
Skupina parametrů: Target Resource Arguments
--resource-type

Typ cílového prostředku. Může také přijmout formát oboru názvů nebo typu (např. Microsoft.Compute/virtualMachines).

Vlastnost Hodnota
Skupina parametrů: Target Resource Arguments
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False

az monitor metrics list-namespaces

Preview

Tento příkaz je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Vypíše obory názvů metrik pro prostředek.

az monitor metrics list-namespaces --resource-uri
                                   [--start-time]

Příklady

Vypíše obory názvů metrik pro prostředek.

az monitor metrics list-namespaces --resource /subscriptions/{subscriptionID}/resourceGroups/{resourceGroup}/Microsoft.Network/networkSecurityGroups/{resourceName} --start-time 2021-03-01T00:00:00Z

Povinné parametry

--resource-uri

Identifikátor prostředku.

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--start-time

Počáteční čas dotazu. Formát: datum (rrrr-mm-dd) čas (hh:mm:ss.xxxxx) časové pásmo (+/-hh:mm).

Vlastnost Hodnota
Skupina parametrů: Time Arguments
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False

az monitor metrics list-sub

Zobrazí seznam dat metrik pro předplatné. Parametry lze zadat v těle.

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}]

Povinné parametry

--region

Oblast, ve které se nachází metriky, které chcete mít.

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--aggregation

Seznam typů agregace (oddělených čárkami) k načtení.

Vlastnost Hodnota
Skupina parametrů: Body Arguments
--auto-adjust-timegrain

Pokud je tato metrika nastavená na hodnotu true, rozhraní API vrátí výsledek pomocí nejbližšího podporovaného časového rozsahu. Při nastavení na hodnotu false se vrátí chyba pro neplatné parametry časového rozsahu. Výchozí nastavení je „false“.

Vlastnost Hodnota
Skupina parametrů: Body Arguments
Přípustné hodnoty: 0, 1, f, false, n, no, t, true, y, yes
--filter

$filter slouží ke snížení sady vrácených dat metriky.
Example:
Metrika obsahuje metadata A, B a C.
- Vrátí všechny časové řady C, kde A = a1 a B = b1 nebo b2
$filter=A eq 'a1' a B eq 'b1' nebo B eq 'b2' a C eq '*'
- Neplatná varianta:
$filter=A eq 'a1' a B eq 'b1' a C eq '*' nebo B = 'b2'
Je to neplatné, protože logický operátor nemůže oddělit dva různé názvy metadat.
- Vrátí všechny časové řady, kde A = a1, B = b1 a C = c1:
$filter=A eq 'a1' a B eq 'b1' a C eq 'c1'
- Vrátí všechny časové řady, kde A = a1
$filter=A eq 'a1' a B eq '' a C eq ''.

Vlastnost Hodnota
Skupina parametrů: Body Arguments
--interval

Interval dotazu (tj. timegrain) dotazu ve formátu doby trvání ISO 8601. Výchozí hodnota je PT1M. Zvláštní případ pro hodnotu FULL, která vrací jeden datový bod po celou dobu požadovanou. Příklady: PT15M, PT1H, P1D, FULL.

Vlastnost Hodnota
Skupina parametrů: Body Arguments
--metricnames

Názvy metrik (oddělené čárkami) pro načtení.

Vlastnost Hodnota
Skupina parametrů: Body Arguments
--metricnamespace

Obor názvů metrik, ve kterém se mají nacházet metriky, které chcete mít.

Vlastnost Hodnota
Skupina parametrů: Body Arguments
--order-by

Agregace, která se má použít k řazení výsledků a směru řazení. Lze zadat pouze jednu objednávku. Příklady: sum asc.

Vlastnost Hodnota
Skupina parametrů: Body Arguments
--result-type

Snižuje sadu shromážděných dat. Povolená syntaxe závisí na operaci. Podrobnosti najdete v popisu operace.

Vlastnost Hodnota
Skupina parametrů: Body Arguments
Přípustné hodnoty: Data, Metadata
--roll-up-by

Názvy dimenzí pro souhrnné výsledky. Pokud například chcete zobrazit jenom hodnoty metrik s filtrem, jako je City eq Seattle nebo City eq Tacoma, ale nechcete zobrazit samostatné hodnoty pro každé město, můžete zadat RollUpBy=City, abyste viděli výsledky pro Seattle a Tacoma, které se shrnují do časových období.

Vlastnost Hodnota
Skupina parametrů: Body Arguments
--timespan

Časový rozsah dotazu. Jedná se o řetězec s následujícím formátem "startDateTime_ISO/endDateTime_ISO".

Vlastnost Hodnota
Skupina parametrů: Body Arguments
--top

Maximální počet záznamů, které se mají načíst. Platné pouze v případě, že je zadán $filter. Výchozí hodnota je 10.

Vlastnost Hodnota
Skupina parametrů: Body Arguments
--validate-dimensions

Pokud je nastavená hodnota false, budou neplatné hodnoty parametrů filtru ignorovány. Pokud je hodnota true, vrátí se chyba pro neplatné parametry filtru. Výchozí hodnota je true.

Vlastnost Hodnota
Skupina parametrů: Body Arguments
Přípustné hodnoty: 0, 1, f, false, n, no, t, true, y, yes
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False

az monitor metrics list-sub-definitions

Vypíše definice metrik pro předplatné.

az monitor metrics list-sub-definitions --region
                                        [--metricnamespace]

Povinné parametry

--region

Oblast, ve které se nachází metriky, které chcete mít.

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--metricnamespace

Obor názvů metrik, ve kterém se mají nacházet metriky, které chcete mít.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False