Udostępnij przez

Get-AzMetricsBatch

Moduł:
Az.Monitor Module

Wyświetla listę wartości metryk dla wielu zasobów.

Składnia

BatchExpanded (domyślnie) 

Get-AzMetricsBatch
    -Endpoint <String>
    -Name <System.Collections.Generic.List`1[System.String]>
    -Namespace <String>
    [-SubscriptionId <String[]>]
    [-Aggregation <String>]
    [-EndTime <String>]
    [-Filter <String>]
    [-Interval <String>]
    [-Orderby <String>]
    [-Rollupby <String>]
    [-StartTime <String>]
    [-Top <Int32>]
    [-ResourceId <String[]>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

BatchViaIdentityExpanded 

Get-AzMetricsBatch
    -Endpoint <String>
    -InputObject <IMetricdataIdentity>
    -Name <System.Collections.Generic.List`1[System.String]>
    -Namespace <String>
    [-Aggregation <String>]
    [-EndTime <String>]
    [-Filter <String>]
    [-Interval <String>]
    [-Orderby <String>]
    [-Rollupby <String>]
    [-StartTime <String>]
    [-Top <Int32>]
    [-ResourceId <String[]>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Opis

Wyświetla listę wartości metryk dla wielu zasobów.

Przykłady

Przykład 1. Pobieranie ruchu przychodzącego i wychodzącego z konta magazynu

$endpoint = 'https://eastus.metrics.monitor.azure.com'
$start = "2023-12-06T07:00:00.000Z"
$end = "2023-12-06T08:00:00.000Z"
Get-AzMetricsBatch -Endpoint $endpoint -Name 'ingress','egress' -Namespace "Microsoft.Storage/storageAccounts" -EndTime $end -StartTime $start -ResourceId '/subscriptions/{subid}/resourcegroups/{groupname}/providers/Microsoft.Storage/storageAccounts/{account}'

Endtime        : 2023-12-06T08:00:00Z
Interval       : 00:01:00a
Namespace      : Microsoft.Storage/storageAccounts
Resourceid     : /subscriptions/subid/resourcegroups/groupname/providers/Microsoft.Storage/storageAccounts/account
Resourceregion : eastus
Starttime      : 2023-12-06T07:00:00Z
Value          : {{
                   "name": {
                     "value": "Ingress",
                     "localizedValue": "Ingress"
                   },
                   "id": "/subscriptions/subid/resourcegroups/groupname/providers/Microsoft.Storage/storageAccounts/account/providers/Microsoft.Insights/metrics/Ingress",
                   "type": "Microsoft.Insights/metrics",
                   "displayDescription": "The amount of ingress data, in bytes. This number includes ingress from an external client into Azure Storage as well as ingress within Azure.",
                   "errorCode": "Success",
                   "unit": "Bytes",
                   "timeseries": [
                     {
                       "metadatavalues": [ ],
                       "data": [
                         {
                           "timeStamp": "2023-12-06T07:00:00.0000000Z",
                           "total": 0
                         },
                         {
                           "timeStamp": "2023-12-06T07:01:00.0000000Z",
                           "total": 0
                         },
                         {
                           "timeStamp": "2023-12-06T07:59:00.0000000Z",
                           "total": 0
                         }
                       ]
                     }
                   ]
                 }, {
                   "name": {
                     "value": "Egress",
                     "localizedValue": "Egress"
                   },
                   "id": "/subscriptions/subid/resourcegroups/groupname/providers/Microsoft.Storage/storageAccounts/account/providers/Microsoft.Insights/metrics/Egress",
                   "type": "Microsoft.Insights/metrics",
                   "displayDescription": "The amount of egress data. This number includes egress to external client from Azure Storage as well as egress within Azure. As a result, this
                 number does not reflect billable egress.",
                   "errorCode": "Success",
                   "unit": "Bytes",
                   "timeseries": [
                     {
                       "metadatavalues": [ ],
                       "data": [
                         {
                           "timeStamp": "2023-12-06T07:00:00.0000000Z",
                           "total": 0
                         },
                         {
                           "timeStamp": "2023-12-06T07:01:00.0000000Z",
                           "total": 0
                         },
                         {
                           "timeStamp": "2023-12-06T07:59:00.0000000Z",
                           "total": 0
                         }
                       ]
                     }
                   ]
                 }}

To polecenie wyświetla listę wartości metryk dla określonych zasobów. Przykładowe usunięte dane z długiej serii czasowej.

Parametry

-Aggregation

Lista typów agregacji (rozdzielonych przecinkami) do pobrania. Przykłady: średnia, minimalna, maksymalna

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:por

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DefaultProfile

Parametr DefaultProfile nie działa. Użyj parametru SubscriptionId, jeśli jest dostępny, jeśli wykonuje polecenie cmdlet dla innej subskrypcji.

Właściwości parametru

Typ:PSObject
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:AzureRMContext, AzureCredential

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Endpoint

Regionalny punkt końcowy do użycia, na przykład https://eastus.metrics.monitor.azure.com. Region powinien być zgodny z regionem żądanych zasobów. W przypadku zasobów globalnych region powinien być "globalny".

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-EndTime

Godzina zakończenia zapytania. Jest to ciąg w formacie "rrrr-MM-ddTHH:mm:ss.fffZ".

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Filter

Filtr służy do zmniejszenia zestawu zwracanych danych metryk. Przykład: Metryka zawiera metadane A, B i C.

  • Zwraca cały szereg czasowy języka C, gdzie A = a1 i B = b1 lub b2 filter=A eq "a1" i B eq "b1" lub B eq "b2" i C eq "*"
  • Nieprawidłowy wariant: filter=A eq "a1" i B eq "b1" i C eq "*" lub B = "b2" Jest to nieprawidłowe, ponieważ operator logiczny lub operator nie może oddzielić dwóch różnych nazw metadanych.
  • Zwracanie wszystkich szeregów czasowych, gdzie A = a1, B = b1 i C = c1: filter=A eq "a1" i B eq "b1" i C eq "c1"
  • Zwracaj wszystkie szeregi czasowe, w których A = a1 filter=A eq "a1" i B eq "" i C eq "".

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-InputObject

Parametr tożsamości

Właściwości parametru

Typ:IMetricdataIdentity
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

BatchViaIdentityExpanded
Position:Named
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Interval

Interwał (tj. timegrain) zapytania w formacie czasu trwania ISO 8601. Domyślnie to PT1M. Specjalny przypadek dla wartości "FULL", która zwraca pojedynczy punkt danych dla całego żądanego przedziału czasu. Przykłady: PT15M, PT1H, P1D, FULL

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Name

Nazwy metryk (rozdzielone przecinkami) do pobrania.

Właściwości parametru

Typ:

List<T>[String]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Nazwa metryki

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Namespace

Przestrzeń nazw metryk zawierająca żądane nazwy metryk.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:MetricNamespace

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Orderby

Agregacja do użycia do sortowania wyników i kierunku sortowania. Można określić tylko jedno zamówienie. Przykłady: sum asc

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ResourceId

Lista identyfikatorów zasobów do wykonywania zapytań dotyczących metryk.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Rollupby

Nazwy wymiarów do zestawienia wyników według. Jeśli na przykład chcesz wyświetlić tylko wartości metryk z filtrem, na przykład "City eq Seattle lub City eq Tacoma", ale nie chcesz widzieć oddzielnych wartości dla każdego miasta, możesz określić wartość "RollUpBy=City", aby wyświetlić wyniki dla Seattle i Tacoma zwinięte w jeden czasomierz.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-StartTime

Godzina rozpoczęcia zapytania. Jest to ciąg w formacie "rrrr-MM-ddTHH:mm:ss.fffZ". Jeśli określono parametr endtime, ten parametr jest wymagany. Jeśli określono tylko godzinę rozpoczęcia, wartość domyślna endtime to bieżąca godzina. Jeśli nie określono interwału czasu, wartość domyślna to 1 godzina.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-SubscriptionId

Identyfikator subskrypcji zasobów w tej partii.

Właściwości parametru

Typ:

String[]

Domyślna wartość:(Get-AzContext).Subscription.Id
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

BatchExpanded
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Top

Maksymalna liczba rekordów do pobrania na identyfikator zasobu w żądaniu. Prawidłowy tylko wtedy, gdy określono filtr. Wartość domyślna to 10.

Właściwości parametru

Typ:Int32
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Wi

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

IMetricdataIdentity

Dane wyjściowe

IMetricResultsResponse