Get-AzMetric

Module:: Az.Monitor Module

Haalt de metrische waarden van een resource op.

Syntaxis

GetWithDefaultParameters (Standaard)

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

Description

Met de cmdlet Get-AzMetric worden de metrische waarden voor een opgegeven resource opgehaald.

Voorbeelden

Voorbeeld 1: Een metrische waarde ophalen met samengevatte uitvoer

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}

Met deze opdracht worden de metrische waarden voor website3 opgehaald met een tijdsinterval van 1 minuut.

Voorbeeld 2: Een metrische waarde ophalen met gedetailleerde uitvoer

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}

Met deze opdracht worden de metrische waarden voor website3 opgehaald met een tijdsinterval van 1 minuut. De uitvoer is gedetailleerd.

Voorbeeld 3: Een opgegeven metrische waarde ophalen

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}

Met deze opdracht krijgt u gedetailleerde uitvoer voor de metrische gegevens voor aanvragen.

Voorbeeld 4: Samengevatte uitvoer ophalen voor een opgegeven metrische waarde met opgegeven dimensiefilter

$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 : {}

Met deze opdracht wordt een samengevatte uitvoer opgehaald voor de metrische gegevens PageViews met het opgegeven dimensiefilter en het aggregatietype.

Parameters

-AggregationType

Het aggregatietype van de query

Parametereigenschappen

Type:	Nullable<T>[Microsoft.Azure.Management.Monitor.Models.AggregationType]
Default value:	None
Geaccepteerde waarden:	None, Average, Count, Minimum, Maximum, Total
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

GetWithFullParameters

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Parametereigenschappen

Type:	IAzureContextContainer
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False
Aliassen:	AzContext, AzureRmContext, AzureCredential

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-DetailedOutput

Geeft aan dat deze cmdlet gedetailleerde uitvoer weergeeft. Standaard wordt de uitvoer samengevat.

Parametereigenschappen

Type:	SwitchParameter
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

-Dimension

De metrische dimensies voor het opvragen van metrische gegevens voor

Parametereigenschappen

Type:	String[]
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

-EndTime

Hiermee geeft u de eindtijd van de query in lokale tijd. De standaardwaarde is de huidige tijd.

Parametereigenschappen

Type:	DateTime
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

-MetricFilter

Hiermee geeft u het dimensiefilter voor metrische gegevens op waarvoor u metrische gegevens wilt opvragen.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

-MetricName

Hiermee geeft u een matrix van namen van metrische gegevens.

Parametereigenschappen

Type:	String[]
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False
Aliassen:	MetricNames

Parametersets

GetWithDefaultParameters

Position:	1
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

-MetricNamespace

Hiermee geeft u de naamruimte voor metrische gegevens op waarvoor u metrische gegevens wilt opvragen.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

GetWithFullParameters

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

-OrderBy

Hiermee geeft u de aggregatie die moet worden gebruikt voor het sorteren van resultaten en de richting van de sortering (voorbeeld: som asc).

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

GetWithFullParameters

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

-ResourceId

Hiermee geeft u de resource-id van de metrische waarde op.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	0
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

-ResultType

Hiermee geeft u het resultaattype dat moet worden geretourneerd (metagegevens of gegevens).

Parametereigenschappen

Type:	Nullable<T>[Microsoft.Azure.Management.Monitor.Models.ResultType]
Default value:	None
Geaccepteerde waarden:	Data, Metadata
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

GetWithFullParameters

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

-StartTime

Hiermee geeft u de begintijd van de query in lokale tijd. De standaardwaarde is de huidige lokale tijd min één uur.

Parametereigenschappen

Type:	DateTime
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

-TimeGrain

Hiermee geeft u de tijdsinterval van de metrische waarde op als een TimeSpan-object in de notatie uu:mm:ss.

Parametereigenschappen

Type:	TimeSpan
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

-Top

Hiermee geeft u het maximum aantal records op dat moet worden opgehaald (standaard:10), dat moet worden opgegeven met $filter.

Parametereigenschappen

Type:	Nullable<T>[Int32]
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

GetWithFullParameters

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Uitvoerwaarden

PSMetric

Notities

Meer informatie over de ondersteunde metrische gegevens vindt u op: https://learn.microsoft.com/azure/azure-monitor/platform/metrics-supported

Delen via

Get-AzMetric

Syntaxis

GetWithDefaultParameters (Standaard)

GetWithFullParameters

Description

Voorbeelden

Voorbeeld 1: Een metrische waarde ophalen met samengevatte uitvoer

Voorbeeld 2: Een metrische waarde ophalen met gedetailleerde uitvoer

Voorbeeld 3: Een opgegeven metrische waarde ophalen

Voorbeeld 4: Samengevatte uitvoer ophalen voor een opgegeven metrische waarde met opgegeven dimensiefilter

Parameters

-AggregationType

Parametereigenschappen

Parametersets

-DefaultProfile

Parametereigenschappen

Parametersets

-DetailedOutput

Parametereigenschappen

Parametersets

-Dimension

Parametereigenschappen

Parametersets

-EndTime

Parametereigenschappen

Parametersets

-MetricFilter

Parametereigenschappen

Parametersets

-MetricName

Parametereigenschappen

Parametersets

-MetricNamespace

Parametereigenschappen

Parametersets

-OrderBy

Parametereigenschappen

Parametersets

-ResourceId

Parametereigenschappen

Parametersets

-ResultType

Parametereigenschappen

Parametersets

-StartTime

Parametereigenschappen

Parametersets

-TimeGrain

Parametereigenschappen

Parametersets

-Top

Parametereigenschappen

Parametersets

CommonParameters

Invoerwaarden

Uitvoerwaarden

Notities

Verwante koppelingen

Feedback