Get-AzMetricsBatch
여러 리소스에 대한 메트릭 값을 나열합니다.
Syntax
Get-AzMetricsBatch
-Endpoint <String>
[-SubscriptionId <String[]>]
-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>] Get-AzMetricsBatch
-Endpoint <String>
-InputObject <IMetricIdentity>
-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>] Description
여러 리소스에 대한 메트릭 값을 나열합니다.
예제
예제 1: 스토리지 계정에서 수신 및 송신
$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/9e223dbe-3399-4e19-88eb-0975f02ac87f/resourcegroups/joyer-monitor/providers/Microsoft.Storage/storageAccounts/psmetric01Endtime : 2023-12-06T08:00:00Z
Interval : 00:01:00a
Namespace : Microsoft.Storage/storageAccounts
Resourceid : /subscriptions/9e223dbe-3399-4e19-88eb-0975f02ac87f/resourcegroups/joyer-monitor/providers/Microsoft.Storage/storageAccounts/psmetric01
Resourceregion : eastus
Starttime : 2023-12-06T07:00:00Z
Value : {{
"name": {
"value": "Ingress",
"localizedValue": "Ingress"
},
"id": "/subscriptions/9e223dbe-3399-4e19-88eb-0975f02ac87f/resourcegroups/joyer-monitor/providers/Microsoft.Storage/storageAccounts/psmetric01/providers/Microsoft.Insigh
ts/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:02:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:03:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:04:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:05:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:06:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:07:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:08:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:09:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:10:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:11:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:12:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:13:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:14:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:15:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:16:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:17:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:18:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:19:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:20:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:21:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:22:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:23:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:24:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:25:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:26:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:27:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:28:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:29:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:30:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:31:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:32:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:33:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:34:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:35:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:36:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:37:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:38:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:39:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:40:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:41:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:42:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:43:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:44:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:45:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:46:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:47:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:48:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:49:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:50:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:51:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:52:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:53:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:54:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:55:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:56:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:57:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:58:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:59:00.0000000Z",
"total": 0
}
]
}
]
}, {
"name": {
"value": "Egress",
"localizedValue": "Egress"
},
"id": "/subscriptions/9e223dbe-3399-4e19-88eb-0975f02ac87f/resourcegroups/joyer-monitor/providers/Microsoft.Storage/storageAccounts/psmetric01/providers/Microsoft.Insigh
ts/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:02:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:03:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:04:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:05:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:06:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:07:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:08:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:09:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:10:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:11:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:12:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:13:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:14:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:15:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:16:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:17:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:18:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:19:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:20:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:21:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:22:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:23:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:24:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:25:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:26:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:27:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:28:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:29:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:30:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:31:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:32:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:33:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:34:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:35:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:36:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:37:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:38:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:39:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:40:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:41:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:42:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:43:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:44:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:45:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:46:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:47:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:48:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:49:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:50:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:51:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:52:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:53:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:54:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:55:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:56:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:57:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:58:00.0000000Z",
"total": 0
},
{
"timeStamp": "2023-12-06T07:59:00.0000000Z",
"total": 0
}
]
}
]
}}
이 명령은 지정된 리소스에 대한 메트릭 값을 나열합니다.
PARAMETERS
-집계
검색할 집계 형식(쉼표로 구분)의 목록입니다. 예: 평균, 최소, 최대
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DefaultProfile
DefaultProfile 매개 변수가 작동하지 않습니다. 다른 구독에 대해 cmdlet을 실행하는 경우 사용 가능한 경우 SubscriptionId 매개 변수를 사용합니다.
Type: PSObject
Parameter Sets: (All)
Aliases: AzureRMContext, AzureCredential
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-끝점
사용할 지역별 엔드포인트(예 https://eastus.metrics.monitor.azure.com: .)
지역은 요청된 리소스의 지역과 일치해야 합니다.
글로벌 리소스의 경우 지역은 '전역'이어야 합니다.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Endtime
쿼리의 종료 시간입니다. 'yyyy-MM-ddTHH:mm:ss.fffZ' 형식의 문자열입니다.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Filter
필터는 반환되는 메트릭 데이터 집합을 줄이는 데 사용됩니다. 예: 메트릭에는 메타데이터 A, B 및 C가 포함됩니다.
- A = a1 및 B = b1 또는 b2 filter=A eq 'a1' 및 B eq 'b1' 또는 B eq 'b2' 및 C eq '*'인 C의 모든 시계열을 반환합니다.
- 잘못된 변형: filter=A eq 'a1' 및 B eq 'b1' 및 C eq '*' 또는 B = 'b2' 논리 또는 연산자는 두 개의 다른 메타데이터 이름을 구분할 수 없기 때문에 유효하지 않습니다.
- A = a1, B = b1 및 C = c1: filter=A eq 'a1' 및 B eq 'b1' 및 C eq 'c1'인 모든 시계열을 반환합니다.
- A = a1 filter=A eq 'a1' 및 B eq '' 및 C eq ''인 모든 시계열을 반환합니다.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
생성할 ID 매개 변수는 INPUTOBJECT 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.
Type: IMetricIdentity
Parameter Sets: BatchViaIdentityExpanded
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-간격
ISO 8601 기간 형식의 쿼리 간격(예: timegrain)입니다. 기본값은 PT1M입니다. 요청된 전체 시간 범위에 대해 단일 데이터 포인트를 반환하는 'FULL' 값에 대한 특수 사례입니다. 예: PT15M, PT1H, P1D, FULL
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
검색할 메트릭의 이름(쉼표로 구분됨)입니다.
Type: System.Collections.Generic.List`1[System.String]
Parameter Sets: (All)
Aliases: MetricName
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-네임 스페이스
요청된 메트릭 이름을 포함하는 메트릭 네임스페이스입니다.
Type: String
Parameter Sets: (All)
Aliases: MetricNamespace
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Orderby
정렬 결과 및 정렬 방향에 사용할 집계입니다. 하나의 순서만 지정할 수 있습니다. 예: sum asc
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Resourceid
메트릭을 쿼리할 리소스 ID 목록입니다.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Rollupby
결과를 롤업할 차원 이름입니다. 예를 들어 'City eq Seattle 또는 City eq Tacoma'와 같은 필터가 있는 메트릭 값만 보려고 하지만 각 도시에 대해 별도의 값을 표시하지 않으려는 경우 'RollUpBy=City'를 지정하여 시애틀 및 타코마에 대한 결과를 한 번으로 롤업할 수 있습니다.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Starttime
쿼리의 시작 시간입니다. 'yyyy-MM-ddTHH:mm:ss.fffZ' 형식의 문자열입니다. 엔드타임 매개 변수를 지정한 경우 이 매개 변수가 필요합니다. 시작 시간만 지정하면 엔드타임은 기본적으로 현재 시간으로 설정됩니다. 시간 간격을 지정하지 않으면 기본값은 1시간입니다.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SubscriptionId
이 일괄 처리의 리소스에 대한 구독 식별자입니다.
Type: String[]
Parameter Sets: BatchExpanded
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Top
요청의 리소스 ID당 검색할 최대 레코드 수입니다. 필터를 지정한 경우에만 유효합니다. 기본값은 10입니다.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
이 cmdlet 일반 매개 변수를 지원합니다. -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction 및 -WarningVariable. 자세한 내용은 about_CommonParameters를 참조하세요.
입력
Microsoft.Azure.PowerShell.Cmdlets.Metric.Models.IMetricIdentity
출력
Microsoft.Azure.PowerShell.Cmdlets.Metric.Models.IMetricResultsResponse
메모장
복합 매개 변수 속성
아래에 설명된 매개 변수를 만들려면 적절한 속성을 포함하는 해시 테이블을 생성합니다. 해시 테이블에 대한 자세한 내용은 Get-Help about_Hash_Tables 실행합니다.
INPUTOBJECT <IMetricIdentity>: ID 매개 변수 [ID <문자열>]: 리소스 ID 경로 [SubscriptionId <String>]: 이 일괄 처리의 리소스에 대한 구독 식별자입니다.
관련 링크
https://learn.microsoft.com/powershell/module/az.monitor/get-azmetricsbatch
GitHub에서 Microsoft와 공동 작업
이 콘텐츠의 원본은 GitHub에서 찾을 수 있으며, 여기서 문제와 끌어오기 요청을 만들고 검토할 수도 있습니다. 자세한 내용은 참여자 가이드를 참조하세요.
Azure PowerShell
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기