Get-AzMetric
리소스의 메트릭 값을 가져옵니다.
Syntax
Get-AzMetric
[-ResourceId] <String>
[-TimeGrain <TimeSpan>]
[-StartTime <DateTime>]
[-EndTime <DateTime>]
[-MetricFilter <String>]
[-Dimension <String[]>]
[[-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>]
[-Dimension <String[]>]
[-MetricName] <String[]>
[-DetailedOutput]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
Get-AzMetric cmdlet은 지정된 리소스에 대한 메트릭 값을 가져옵니다.
예제
예제 1: 요약된 출력을 사용하여 메트릭 가져오기
Get-AzMetric -ResourceId "/subscriptions/e3f5b07d-3c39-4b0f-bf3b-40fdeba10f2a/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/e3f5b07d-3c39-4b0f-bf3b-40fdeba10f2a/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/e3f5b07d-3c39-4b0f-bf3b-40fdeba10f2a/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/website3
StartTime : 3/20/2015 5:40:00 PM
TimeGrain : 00:01:00
Unit : Bytes이 명령은 시간 범위가 1분인 website3의 메트릭 값을 가져옵니다.
예제 2: 자세한 출력을 사용하여 메트릭 가져오기
Get-AzMetric -ResourceId "/subscriptions/e3f5b07d-3c39-4b0f-bf3b-40fdeba10f2a/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/e3f5b07d-3c39-4b0f-bf3b-40fdeba10f2a/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/website3
StartTime : 3/20/2015 5:43:00 PM
TimeGrain : 00:01:00
Unit : Seconds이 명령은 시간 범위가 1분인 website3의 메트릭 값을 가져옵니다. 출력이 자세히 설명되어 있습니다.
예제 3: 지정된 메트릭에 대한 자세한 출력 가져오기
Get-AzMetric -ResourceId "/subscriptions/e3f5b07d-3c39-4b0f-bf3b-40fdeba10f2a/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/e3f5b07d-3c39-4b0f-bf3b-40fdeba10f2a/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/website3
StartTime : 3/20/2015 5:47:00 PM
TimeGrain : 00:01:00
Unit : Count이 명령은 요청 메트릭에 대한 자세한 출력을 가져옵니다.
예제 4: 지정된 차원 필터를 사용하여 지정된 메트릭에 대한 요약 출력 가져오기
$dimFilter = @((New-AzMetricFilter -Dimension City -Operator eq -Value "Seattle","Toronto"), (New-AzMetricFilter -Dimension AuthenticationType -Operator eq -Value User))
Get-AzMetric -ResourceId <resourceId> -MetricName PageViews -TimeGrain 00:05:00 -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이 명령은 지정된 차원 필터 및 집계 유형을 사용하여 PageViews 메트릭에 대한 요약 출력을 가져옵니다.
매개 변수
-AggregationType
쿼리의 집계 형식
| Type: | Nullable<T>[AggregationType] |
| Accepted values: | None, Average, Count, Minimum, Maximum, Total |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DefaultProfile
Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DetailedOutput
이 cmdlet에 자세한 출력이 표시됨을 나타냅니다. 기본적으로 출력은 요약됩니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Dimension
메트릭을 쿼리할 메트릭 차원
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-EndTime
쿼리의 종료 시간을 현지 시간으로 지정합니다. 기본값은 현재 시간입니다.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-MetricFilter
메트릭을 쿼리할 메트릭 차원 필터를 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-MetricName
메트릭 이름 배열을 지정합니다.
| Type: | String[] |
| Aliases: | MetricNames |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-MetricNamespace
메트릭을 쿼리할 메트릭 네임스페이스를 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-OrderBy
정렬 결과에 사용할 집계와 정렬 방향(예: sum asc)을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourceId
메트릭의 리소스 ID를 지정합니다.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResultType
반환할 결과 형식(메타데이터 또는 데이터)을 지정합니다.
| Type: | Nullable<T>[ResultType] |
| Accepted values: | Data, Metadata |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-StartTime
로컬 시간에 쿼리의 시작 시간을 지정합니다. 기본값은 현재 현지 시간에서 1시간을 뺀 값입니다.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TimeGrain
메트릭의 시간 조직체를 hh:mm:ss 형식의 TimeSpan 개체로 지정합니다.
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Top
$filter 사용하여 지정할 최대 레코드 수(기본값:10)를 지정합니다.
| Type: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
입력
Nullable<T>[[Microsoft.Azure.Management.Monitor.Models.AggregationType, Microsoft.Azure.Management.Monitor, Version=0.21.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]
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[]
출력
참고
지원되는 메트릭에 대한 자세한 내용은 다음에서 확인할 수 있습니다. https://learn.microsoft.com/azure/azure-monitor/platform/metrics-supported