Get-AzMetric

Modul:: Az.Monitor Module

Ruft die Metrikwerte einer Ressource ab.

Syntax

GetWithDefaultParameters (Standardwert)

Get-AzMetric
    [-ResourceId] <String>
    [[-MetricName] <String[]>]
    [-TimeGrain <TimeSpan>]
    [-StartTime <DateTime>]
    [-EndTime <DateTime>]
    [-MetricFilter <String>]
    [-Dimension <String[]>]
    [-DetailedOutput]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

GetWithFullParameters

Get-AzMetric
    [-ResourceId] <String>
    [-MetricName] <String[]>
    [-TimeGrain <TimeSpan>]
    [-AggregationType <AggregationType>]
    [-StartTime <DateTime>]
    [-EndTime <DateTime>]
    [-Top <Int32>]
    [-OrderBy <String>]
    [-MetricNamespace <String>]
    [-ResultType <ResultType>]
    [-MetricFilter <String>]
    [-Dimension <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

Get-AzMetric -ResourceId "/subscriptions/e3f5b07d-3c39-4b0f-bf3b-40fdeba10f2a/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/website3" -TimeGrain 00:01:00

Id         : /subscriptions/e3f5b07d-3c39-4b0f-bf3b-40fdeba10f2a/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/website3/providers/Microsoft.Insights/metrics/Requests
Name       :
                LocalizedValue : Requests
                Value          : Requests

Type       : Microsoft.Insights/metrics
Unit       : Count
Data       : {Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue, Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue,
             Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue, Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue…}
Timeseries : {Microsoft.Azure.Management.Monitor.Models.TimeSeriesElement}

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

Beispiel 2: Abrufen einer Metrik mit detaillierter Ausgabe

Get-AzMetric -ResourceId "/subscriptions/e3f5b07d-3c39-4b0f-bf3b-40fdeba10f2a/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/website3" -TimeGrain 00:01:00 -DetailedOutput

Id         : /subscriptions/e3f5b07d-3c39-4b0f-bf3b-40fdeba10f2a/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/website3/providers/Microsoft.Insights/metrics/Requests
Name       : Microsoft.Azure.Management.Monitor.Models.LocalizableString

Type       : Microsoft.Insights/metrics
Unit       : Count
Data       : {Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue, Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue,
             Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue, Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue…}
Timeseries : {Microsoft.Azure.Management.Monitor.Models.TimeSeriesElement}

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

Beispiel 3: Abrufen einer angegebenen Metrik

Get-AzMetric -ResourceId "/subscriptions/e3f5b07d-3c39-4b0f-bf3b-40fdeba10f2a/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/website3" -MetricName "Requests" -TimeGrain 00:01:00

Id         : /subscriptions/e3f5b07d-3c39-4b0f-bf3b-40fdeba10f2a/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/website3/providers/Microsoft.Insights/metrics/Requests
Name       :
                LocalizedValue : Requests
                Value          : Requests

Type       : Microsoft.Insights/metrics
Unit       : Count
Data       : {Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue, Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue,
             Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue, Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue…}
Timeseries : {Microsoft.Azure.Management.Monitor.Models.TimeSeriesElement}

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

$dimFilter = "$(New-AzMetricFilter -Dimension City -Operator eq -Value "Seattle","Toronto") and $(New-AzMetricFilter -Dimension AuthenticationType -Operator eq -Value User)"

Get-AzMetric -ResourceId <ResourceId> -MetricName availabilityResults/availabilityPercentage -TimeGrain 00:05:00 -MetricFilter $dimFilter -StartTime 2024-07-02T00:00:00Z -EndTime 2024-07-02T00:10:00Z -AggregationType Average

Id         : [ResourceId]/providers/Microsoft.Insights/metrics/availabilityResults/availabilityPercentage
Name       :
                LocalizedValue : Availability
                Value          : availabilityResults/availabilityPercentage

Type       : Microsoft.Insights/metrics
Unit       : Percent
Data       :
Timeseries : {}

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

Parametereigenschaften

Typ:	Nullable<T>[Microsoft.Azure.Management.Monitor.Models.AggregationType]
Standardwert:	None
Zulässige Werte:	None, Average, Count, Minimum, Maximum, Total
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

GetWithFullParameters

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-DefaultProfile

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

Parametereigenschaften

Typ:	IAzureContextContainer
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False
Aliase:	AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-DetailedOutput

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

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-Dimension

Die Metrikabmessungen zum Abfragen von Metriken für

Parametereigenschaften

Typ:	String[]
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-EndTime

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

Parametereigenschaften

Typ:	DateTime
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-MetricFilter

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

Parametereigenschaften

Typ:	String
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-MetricName

Gibt ein Array von Namen von Metriken an.

Parametereigenschaften

Typ:	String[]
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False
Aliase:	MetricNames

Parametersätze

GetWithDefaultParameters

Position:	1
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-MetricNamespace

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

Parametereigenschaften

Typ:	String
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

GetWithFullParameters

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-OrderBy

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

Parametereigenschaften

Typ:	String
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

GetWithFullParameters

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-ResourceId

Gibt die Ressourcen-ID der Metrik an.

Parametereigenschaften

Typ:	String
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	0
Obligatorisch.:	True
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-ResultType

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

Parametereigenschaften

Typ:	Nullable<T>[Microsoft.Azure.Management.Monitor.Models.ResultType]
Standardwert:	None
Zulässige Werte:	Data, Metadata
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

GetWithFullParameters

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-StartTime

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

Parametereigenschaften

Typ:	DateTime
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-TimeGrain

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

Parametereigenschaften

Typ:	TimeSpan
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-Top

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

Parametereigenschaften

Typ:	Nullable<T>[Int32]
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

GetWithFullParameters

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Ausgaben

PSMetric

Hinweise

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

Freigeben über

Get-AzMetric

Syntax

GetWithDefaultParameters (Standardwert)

GetWithFullParameters

Beschreibung

Beispiele

Beispiel 1: Abrufen einer Metrik mit zusammengefasster Ausgabe

Beispiel 2: Abrufen einer Metrik mit detaillierter Ausgabe

Beispiel 3: Abrufen einer angegebenen Metrik

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

Parameter

-AggregationType

Parametereigenschaften

Parametersätze

-DefaultProfile

Parametereigenschaften

Parametersätze

-DetailedOutput

Parametereigenschaften

Parametersätze

-Dimension

Parametereigenschaften

Parametersätze

-EndTime

Parametereigenschaften

Parametersätze

-MetricFilter

Parametereigenschaften

Parametersätze

-MetricName

Parametereigenschaften

Parametersätze

-MetricNamespace

Parametereigenschaften

Parametersätze

-OrderBy

Parametereigenschaften

Parametersätze

-ResourceId

Parametereigenschaften

Parametersätze

-ResultType

Parametereigenschaften

Parametersätze

-StartTime

Parametereigenschaften

Parametersätze

-TimeGrain

Parametereigenschaften

Parametersätze

-Top

Parametereigenschaften

Parametersätze

CommonParameters

Eingaben

Ausgaben

Hinweise

Ähnliche Themen

Feedback