Freigeben über

Get-AzMetric

  • Referenz
Modul:
Az.Monitor

Ruft die Metrikwerte einer Ressource ab.

Syntax

Get-AzMetric
   [-ResourceId] <String>
   [-TimeGrain <TimeSpan>]
   [-StartTime <DateTime>]
   [-EndTime <DateTime>]
   [[-MetricName] <String[]>]
   [-DetailedOutput]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzMetric
   [-ResourceId] <String>
   [-TimeGrain <TimeSpan>]
   [-AggregationType <AggregationType>]
   [-StartTime <DateTime>]
   [-EndTime <DateTime>]
   [-Top <Int32>]
   [-OrderBy <String>]
   [-MetricNamespace <String>]
   [-ResultType <ResultType>]
   [-MetricFilter <String>]
   [-MetricName] <String[]>
   [-DetailedOutput]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-AzMetric ruft die Metrikwerte für eine angegebene Ressource ab.

Beispiele

Beispiel 1: Abrufen einer Metrik mit zusammengefasster Ausgabe

PS C:\>Get-AzMetric -ResourceId "/subscriptions/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/website3" -TimeGrain 00:01:00
DimensionName  :
DimensionValue :
Name           : AverageResponseTime
EndTime        : 3/20/2015 6:40:46 PM
MetricValues   : {Microsoft.Azure.Insights.Models.MetricValue, Microsoft.Azure.Insights.Models.MetricValue,
                 Microsoft.Azure.Insights.Models.MetricValue, Microsoft.Azure.Insights.Models.MetricValue...}
Properties     : {}
ResourceId     : /subscriptions/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/website3
StartTime      : 3/20/2015 5:40:00 PM
TimeGrain      : 00:01:00
Unit           : Seconds
DimensionName  :
DimensionValue :
Name           : AverageMemoryWorkingSet
EndTime        : 3/20/2015 6:40:46 PM
MetricValues   : {Microsoft.Azure.Insights.Models.MetricValue, Microsoft.Azure.Insights.Models.MetricValue,
                 Microsoft.Azure.Insights.Models.MetricValue, Microsoft.Azure.Insights.Models.MetricValue...}
Properties     : {}
ResourceId     : /subscriptions/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/website3
StartTime      : 3/20/2015 5:40:00 PM
TimeGrain      : 00:01:00
Unit           : Bytes

Dieser Befehl ruft die Metrikwerte für Website3 mit einem Zeitkorn von 1 Minute ab.

Beispiel 2: Abrufen einer Metrik mit detaillierter Ausgabe

PS C:\>Get-AzMetric -ResourceId "/subscriptions/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/website3" -TimeGrain 00:01:00 -DetailedOutput
MetricValues   :
                     Average    : 0
                     Count      : 1
                     Last       :
                     Maximum    :
                     Minimum    :
                     Properties :
                     Timestamp  : 3/20/2015 6:37:00 PM
                     Total      : 0
                     Average    : 0.106
                     Count      : 1
                     Last       :
                     Maximum    :
                     Minimum    :
                     Properties :
                     Timestamp  : 3/20/2015 6:39:00 PM
                     Total      : 0.106
                     Average    : 0.064
                     Count      : 1
                     Last       :
                     Maximum    :
                     Minimum    :
                     Properties :
                     Timestamp  : 3/20/2015 6:41:00 PM
                     Total      : 0.064
Properties     :
DimensionName  :
DimensionValue :
Name           : AverageResponseTime
EndTime        : 3/20/2015 6:43:33 PM
ResourceId     : /subscriptions/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/website3
StartTime      : 3/20/2015 5:43:00 PM
TimeGrain      : 00:01:00
Unit           : Seconds

Dieser Befehl ruft die Metrikwerte für Website3 mit einem Zeitkorn von 1 Minute ab. Die Ausgabe ist detailliert.

Beispiel 3: Abrufen einer detaillierten Ausgabe für eine angegebene Metrik

PS C:\>Get-AzMetric -ResourceId "/subscriptions/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/website3" -MetricName "Requests" -TimeGrain 00:01:00 -DetailedOutput
MetricValues   :
                     Average    : 1
                     Count      : 1
                     Last       :
                     Maximum    :
                     Minimum    :
                     Properties :
                     Timestamp  : 3/20/2015 6:39:00 PM
                     Total      : 1
                     Average    : 1
                     Count      : 1
                     Last       :
                     Maximum    :
                     Minimum    :
                     Properties :
                     Timestamp  : 3/20/2015 6:41:00 PM
                     Total      : 1
                     Average    : 0
                     Count      : 1
                     Last       :
                     Maximum    :
                     Minimum    :
                     Properties :
                     Timestamp  : 3/20/2015 6:43:00 PM
                     Total      : 0
                     Average    : 1
                     Count      : 1
                     Last       :
                     Maximum    :
                     Minimum    :
                     Properties :
                     Timestamp  : 3/20/2015 6:44:00 PM
                     Total      : 1
                     Average    : 0
                     Count      : 1
                     Last       :
                     Maximum    :
                     Minimum    :
                     Properties :
                     Timestamp  : 3/20/2015 6:45:00 PM
                     Total      : 0
Properties     :
DimensionName  :
DimensionValue :
Name           : Requests
EndTime        : 3/20/2015 6:47:56 PM
ResourceId     : /subscriptions/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/website3
StartTime      : 3/20/2015 5:47:00 PM
TimeGrain      : 00:01:00
Unit           : Count

Dieser Befehl erhält eine detaillierte Ausgabe für die Anforderungsmetrik.

Beispiel 4: Abrufen einer zusammengefassten Ausgabe für eine angegebene Metrik mit angegebenem Dimensionsfilter

PS C:\> $dimFilter = @((New-AzMetricFilter -Dimension City -Operator eq -Value "Seattle","Toronto"), (New-AzMetricFilter -Dimension AuthenticationType -Operator eq -Value User))

PS C:\> Get-AzMetric -ResourceId <resourceId> -MetricName PageViews -TimeGrain PT5M -MetricFilter $dimFilter -StartTime 2018-02-01T12:00:00Z -EndTime 2018-02-01T12:10:00Z -AggregationType -Average
ResourceId	: [ResourceId]
MetricNamespace	: Microsoft.Insights/ApplicationInsights
Metric Name	:
					LocalizedValue	: Page Views
					Value		: PageViews
Unit		: Seconds
Timeseries	:
			City 			: Seattle
			AuthenticationType 	: User

					Timestamp	: 2018-02-01 12:00:00 PM
					Average		: 3518

					Timestamp	: 2018-02-01 12:05:00 PM
					Average		: 1984

			City 			: Toronto
			AuthenticationType 	: User

					Timestamp	: 2018-02-01 12:00:00 PM
					Average		: 894

					Timestamp	: 2018-02-01 12:05:00 PM
					Average		: 967

Mit diesem Befehl wird die Ausgabe für die PageViews-Metrik mit dem angegebenen Bemaßungsfilter und Aggregationstyp zusammengefasst.

Parameter

-AggregationType

Der Aggregationstyp der Abfrage

Typ:Nullable<T>[AggregationType]
Zulässige Werte:None, Average, Count, Minimum, Maximum, Total
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DetailedOutput

Gibt an, dass dieses Cmdlet eine detaillierte Ausgabe anzeigt. Die Ausgabe wird standardmäßig zusammengefasst.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-EndTime

Gibt die Endzeit der Abfrage in lokaler Zeit an. Der Standardwert ist die aktuelle Uhrzeit.

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-MetricFilter

Gibt den Metrikdimensionsfilter an, für den Metriken abzufragen sind.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-MetricName

Gibt ein Array von Namen von Metriken an.

Typ:String[]
Aliase:MetricNames
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-MetricNamespace

Gibt den Metriknamespace an, für den Metriken abzufragen sind.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-OrderBy

Gibt die Aggregation an, die zum Sortieren von Ergebnissen und zur Richtung der Sortierung verwendet werden soll (Beispiel: Summe asc).

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ResourceId

Gibt die Ressourcen-ID der Metrik an.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ResultType

Gibt den ergebnistyp an, der zurückgegeben werden soll (Metadaten oder Daten).

Typ:Nullable<T>[ResultType]
Zulässige Werte:Data, Metadata
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-StartTime

Gibt die Startzeit der Abfrage in lokaler Zeit an. Der Standardwert ist die aktuelle Ortszeit minus einer Stunde.

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-TimeGrain

Gibt das Zeitkorn der Metrik als TimeSpan -Objekt im Format hh:mm:ss an.

Typ:TimeSpan
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Top

Gibt die maximale Anzahl abzurufender Datensätze an (Standard:10), die mit $filter angegeben werden sollen.

Typ:Nullable<T>[Int32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

String

TimeSpan

Nullable<T>[[Microsoft.Azure.Management.Monitor.Models.AggregationType, Microsoft.Azure.Management.Monitor, Version=0.21.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

DateTime

Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Nullable<T>[[Microsoft.Azure.Management.Monitor.Models.ResultType, Microsoft.Azure.Management.Monitor, Version=0.21.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

String[]

SwitchParameter

Ausgaben

PSMetric

Hinweise

Weitere Informationen zu den unterstützten Metriken finden Sie unter: https://learn.microsoft.com/en-us/azure/azure-monitor/platform/metrics-supported