다음을 통해 공유


Get-AzMetricsBatch

여러 리소스에 대한 메트릭 값을 나열합니다.

구문

BatchExpanded (기본값)

Get-AzMetricsBatch
    -Endpoint <String>
    -Name <System.Collections.Generic.List`1[System.String]>
    -Namespace <String>
    [-SubscriptionId <String[]>]
    [-Aggregation <String>]
    [-EndTime <String>]
    [-Filter <String>]
    [-Interval <String>]
    [-Orderby <String>]
    [-Rollupby <String>]
    [-StartTime <String>]
    [-Top <Int32>]
    [-ResourceId <String[]>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

BatchViaIdentityExpanded

Get-AzMetricsBatch
    -Endpoint <String>
    -InputObject <IMetricdataIdentity>
    -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/{subid}/resourcegroups/{groupname}/providers/Microsoft.Storage/storageAccounts/{account}'
Endtime        : 2023-12-06T08:00:00Z
Interval       : 00:01:00a
Namespace      : Microsoft.Storage/storageAccounts
Resourceid     : /subscriptions/subid/resourcegroups/groupname/providers/Microsoft.Storage/storageAccounts/account
Resourceregion : eastus
Starttime      : 2023-12-06T07:00:00Z
Value          : {{
                   "name": {
                     "value": "Ingress",
                     "localizedValue": "Ingress"
                   },
                   "id": "/subscriptions/subid/resourcegroups/groupname/providers/Microsoft.Storage/storageAccounts/account/providers/Microsoft.Insights/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:59:00.0000000Z",
                           "total": 0
                         }
                       ]
                     }
                   ]
                 }, {
                   "name": {
                     "value": "Egress",
                     "localizedValue": "Egress"
                   },
                   "id": "/subscriptions/subid/resourcegroups/groupname/providers/Microsoft.Storage/storageAccounts/account/providers/Microsoft.Insights/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:59:00.0000000Z",
                           "total": 0
                         }
                       ]
                     }
                   ]
                 }}

이 명령은 지정된 리소스에 대한 메트릭 값을 나열합니다. 긴 시계열의 삭제된 데이터 예제입니다.

매개 변수

-Aggregation

검색할 집계 형식(쉼표로 구분)의 목록입니다. 예: 평균, 최소, 최대

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False
별칭:cf(cf)

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-DefaultProfile

DefaultProfile 매개 변수가 작동하지 않습니다. 다른 구독에 대해 cmdlet을 실행하는 경우 사용 가능한 경우 SubscriptionId 매개 변수를 사용합니다.

매개 변수 속성

형식:PSObject
Default value:None
와일드카드 지원:False
DontShow:False
별칭:AzureRMContext, AzureCredential

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Endpoint

사용할 지역별 엔드포인트(예 https://eastus.metrics.monitor.azure.com: .) 지역은 요청된 리소스의 지역과 일치해야 합니다. 글로벌 리소스의 경우 지역은 '전역'이어야 합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-EndTime

쿼리의 종료 시간입니다. 'yyyy-MM-ddTHH:mm:ss.fffZ' 형식의 문자열입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값: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 ''인 모든 시계열을 반환합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-InputObject

ID 매개 변수

매개 변수 속성

형식:IMetricdataIdentity
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

BatchViaIdentityExpanded
Position:Named
필수:True
파이프라인의 값:True
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Interval

ISO 8601 기간 형식의 쿼리 간격(예: timegrain)입니다. 기본값은 PT1M입니다. 요청된 전체 시간 범위에 대해 단일 데이터 포인트를 반환하는 'FULL' 값에 대한 특수 사례입니다. 예: PT15M, PT1H, P1D, FULL

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Name

검색할 메트릭의 이름(쉼표로 구분됨)입니다.

매개 변수 속성

형식:

List<T>[String]

Default value:None
와일드카드 지원:False
DontShow:False
별칭:지표명

매개 변수 집합

(All)
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Namespace

요청된 메트릭 이름을 포함하는 메트릭 네임스페이스입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False
별칭:MetricNamespace

매개 변수 집합

(All)
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Orderby

정렬 결과 및 정렬 방향에 사용할 집계입니다. 하나의 순서만 지정할 수 있습니다. 예: sum asc

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ResourceId

메트릭을 쿼리할 리소스 ID 목록입니다.

매개 변수 속성

형식:

String[]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Rollupby

결과를 롤업할 차원 이름입니다. 예를 들어 'City eq Seattle 또는 City eq Tacoma'와 같은 필터가 있는 메트릭 값만 보려고 하지만 각 도시에 대해 별도의 값을 표시하지 않으려는 경우 'RollUpBy=City'를 지정하여 시애틀 및 타코마에 대한 결과를 한 번으로 롤업할 수 있습니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-StartTime

쿼리의 시작 시간입니다. 'yyyy-MM-ddTHH:mm:ss.fffZ' 형식의 문자열입니다. 엔드타임 매개 변수를 지정한 경우 이 매개 변수가 필요합니다. 시작 시간만 지정하면 엔드타임은 기본적으로 현재 시간으로 설정됩니다. 시간 간격을 지정하지 않으면 기본값은 1시간입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-SubscriptionId

이 일괄 처리의 리소스에 대한 구독 식별자입니다.

매개 변수 속성

형식:

String[]

Default value:(Get-AzContext).Subscription.Id
와일드카드 지원:False
DontShow:False

매개 변수 집합

BatchExpanded
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Top

요청의 리소스 ID당 검색할 최대 레코드 수입니다. 필터를 지정한 경우에만 유효합니다. 기본값은 10입니다.

매개 변수 속성

형식:Int32
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False
별칭:위스콘신

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

IMetricdataIdentity

출력

IMetricResultsResponse