다음을 통해 공유

az monitor metrics

Azure 리소스 메트릭을 봅니다.

명령

Name Description 형식 상태
az monitor metrics alert

거의 실시간 메트릭 경고 규칙을 관리합니다.

 Core GA
az monitor metrics alert condition

근 실시간 메트릭 경고 규칙 조건을 관리합니다.

 Core GA
az monitor metrics alert condition create

메트릭 경고 규칙 조건을 빌드합니다.

 Core Preview
az monitor metrics alert create

메트릭 기반 경고 규칙을 만듭니다.

 Core GA
az monitor metrics alert delete

메트릭 기반 경고 규칙을 삭제합니다.

 Core GA
az monitor metrics alert dimension

거의 실시간 메트릭 경고 규칙 차원을 관리합니다.

 Core GA
az monitor metrics alert dimension create

메트릭 경고 규칙 차원을 빌드합니다.

 Core Preview
az monitor metrics alert list

메트릭 기반 경고 규칙을 나열합니다.

 Core GA
az monitor metrics alert show

메트릭 기반 경고 규칙을 표시합니다.

 Core GA
az monitor metrics alert update

메트릭 기반 경고 규칙을 업데이트합니다.

 Core GA
az monitor metrics list

리소스의 메트릭 값을 나열합니다.

 Core GA
az monitor metrics list-definitions

리소스에 대한 메트릭 정의를 나열합니다.

 Core GA
az monitor metrics list-namespaces

리소스의 메트릭 네임스페이스를 나열합니다.

 Core Preview
az monitor metrics list-sub

구독에 대한 메트릭 데이터를 나열합니다. 본문에 매개 변수를 지정할 수 있습니다.

 Core GA
az monitor metrics list-sub-definitions

구독에 대한 메트릭 정의를 나열합니다.

 Core GA

az monitor metrics list

편집

리소스의 메트릭 값을 나열합니다.

az monitor metrics list --resource
                        [--aggregation {Average, Count, Maximum, Minimum, None, Total}]
                        [--dimension]
                        [--end-time]
                        [--filter]
                        [--interval]
                        [--metadata]
                        [--metrics]
                        [--namespace]
                        [--offset]
                        [--orderby]
                        [--resource-group]
                        [--resource-namespace]
                        [--resource-parent]
                        [--resource-type]
                        [--start-time]
                        [--top]

예제

지난 시간 동안 VM의 CPU 사용량 나열

az monitor metrics list --resource {ResourceName} --metric "Percentage CPU"

스토리지 계정의 성공 E2E 대기 시간을 나열하고 API 이름에 따라 데이터 계열을 분할합니다.

az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
                        --dimension ApiName

스토리지 계정의 성공 E2E 대기 시간을 나열하고 API 이름 및 지역 유형 모두에 따라 데이터 계열을 분할합니다.

az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
                        --dimension ApiName GeoType

스토리지 계정의 성공 E2E 대기 시간을 나열하고 "--filter" 매개 변수를 사용하여 API 이름과 지역 형식을 기반으로 데이터 계열을 분할합니다.

az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
                        --filter "ApiName eq '*' and GeoType eq '*'"

스토리지 계정의 성공 E2E 대기 시간을 나열하고 API 이름 및 지역 유형에 따라 데이터 계열을 분할합니다. API 이름을 'DeleteContainer'로 제한합니다.

az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
                        --filter "ApiName eq 'DeleteContainer' and GeoType eq '*'"

2017-01-01 이후의 일일 스토리지 계정 트랜잭션 나열

az monitor metrics list --resource {ResourceName} --metric Transactions \
                        --start-time 2017-01-01T00:00:00Z \
                        --interval PT24H

2017년 이후 트랜잭션 메트릭의 api 이름 차원 아래에 스토리지 계정에 대한 메타데이터 값을 나열합니다.

az monitor metrics list --resource {ResourceName} --metric Transactions \
                        --filter "ApiName eq '*'" \
                        --start-time 2017-01-01T00:00:00Z

필수 매개 변수

--resource

대상 리소스의 이름 또는 ID입니다.

속성 값
매개 변수 그룹: Target Resource Arguments

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--aggregation

검색할 집계 형식(공백으로 구분)의 목록입니다.

속성 값
허용되는 값: Average, Count, Maximum, Minimum, None, Total
다음의 값: az monitor metrics list-definitions
--dimension

메트릭을 쿼리하는 차원 목록(공백으로 구분)입니다.

속성 값
다음의 값: az monitor metrics list-definitions
--end-time

쿼리의 종료 시간입니다. 기본값은 현재 시간입니다. 형식: date(yyyy-mm-dd) 시간(hh:mm:ss.xxxxx) 표준 시간대(+/-hh:mm).

속성 값
매개 변수 그룹: Time Arguments
--filter

반환된 메트릭 데이터 집합을 줄이는 데 사용되는 문자열입니다. eg. "BlobType eq '*'".

필터의 전체 목록은 https://learn.microsoft.com/rest/api/monitor/metrics/list필터 문자열 참조를 참조하세요.

--interval

##h##m 형식으로 메트릭을 집계할 간격입니다.

속성 값
매개 변수 그룹: Time Arguments
Default value: 1m
--metadata

메트릭 데이터 대신 메타데이터 값을 반환합니다.

--metrics

검색할 메트릭 이름의 공백으로 구분된 목록입니다.

속성 값
다음의 값: az monitor metrics list-definitions
--namespace

메트릭 정의를 쿼리할 네임스페이스입니다.

속성 값
다음의 값: az monitor metrics list-namespaces
--offset

쿼리 범위의 시간 오프셋(##d##h 형식)

--start-time 또는 --end-time과 함께 사용할 수 있습니다. --start-time과 함께 사용하는 경우 오프셋을 추가하여 종료 시간을 계산합니다. --end-time(기본값)과 함께 사용하는 경우 오프셋을 빼서 시작 시간을 계산합니다. --start-time 및 --end-time이 제공되면 --offset이 무시됩니다.

속성 값
매개 변수 그룹: Time Arguments
Default value: 1h
--orderby

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

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.

속성 값
매개 변수 그룹: Target Resource Arguments
--resource-namespace

대상 리소스 공급자 네임스페이스입니다.

속성 값
매개 변수 그룹: Target Resource Arguments
--resource-parent

대상 리소스 부모 경로(해당하는 경우)입니다.

속성 값
매개 변수 그룹: Target Resource Arguments
--resource-type

대상 리소스 종류입니다. 네임스페이스/형식 형식(예: 'Microsoft.Compute/virtualMachines')도 수락할 수 있습니다.

속성 값
매개 변수 그룹: Target Resource Arguments
--start-time

쿼리의 시작 시간입니다. 형식: date(yyyy-mm-dd) 시간(hh:mm:ss.xxxxx) 표준 시간대(+/-hh:mm).

속성 값
매개 변수 그룹: Time Arguments
--top

검색할 최대 레코드 수입니다.

속성 값
Default value: 10
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성 값
Default value: False
--output -o

출력 형식

속성 값
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az monitor metrics list-definitions

편집

리소스에 대한 메트릭 정의를 나열합니다.

az monitor metrics list-definitions --resource
                                    [--namespace]
                                    [--resource-group]
                                    [--resource-namespace]
                                    [--resource-parent]
                                    [--resource-type]

예제

리소스에 대한 메트릭 정의를 나열합니다. (autogenerated)

az monitor metrics list-definitions --resource /subscriptions/{subscriptionID}/resourceGroups/{resourceGroup}/Microsoft.Network/networkSecurityGroups/{resourceName}

필수 매개 변수

--resource

대상 리소스의 이름 또는 ID입니다.

속성 값
매개 변수 그룹: Target Resource Arguments

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--namespace

메트릭 정의를 쿼리할 네임스페이스입니다.

속성 값
다음의 값: az monitor metrics list-namespaces
--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.

속성 값
매개 변수 그룹: Target Resource Arguments
--resource-namespace

대상 리소스 공급자 네임스페이스입니다.

속성 값
매개 변수 그룹: Target Resource Arguments
--resource-parent

대상 리소스 부모 경로(해당하는 경우)입니다.

속성 값
매개 변수 그룹: Target Resource Arguments
--resource-type

대상 리소스 종류입니다. 네임스페이스/형식 형식(예: 'Microsoft.Compute/virtualMachines')도 수락할 수 있습니다.

속성 값
매개 변수 그룹: Target Resource Arguments
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성 값
Default value: False
--output -o

출력 형식

속성 값
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az monitor metrics list-namespaces

편집
미리 보기

이 명령은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

리소스의 메트릭 네임스페이스를 나열합니다.

az monitor metrics list-namespaces --resource-uri
                                   [--start-time]

예제

리소스의 메트릭 네임스페이스를 나열합니다.

az monitor metrics list-namespaces --resource /subscriptions/{subscriptionID}/resourceGroups/{resourceGroup}/Microsoft.Network/networkSecurityGroups/{resourceName} --start-time 2021-03-01T00:00:00Z

필수 매개 변수

--resource-uri

리소스의 식별자입니다.

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--start-time

쿼리의 시작 시간입니다. 형식: date(yyyy-mm-dd) 시간(hh:mm:ss.xxxxx) 표준 시간대(+/-hh:mm).

속성 값
매개 변수 그룹: Time Arguments
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성 값
Default value: False
--output -o

출력 형식

속성 값
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az monitor metrics list-sub

편집

구독에 대한 메트릭 데이터를 나열합니다. 본문에 매개 변수를 지정할 수 있습니다.

az monitor metrics list-sub --region
                            [--aggregation]
                            [--auto-adjust-timegrain {0, 1, f, false, n, no, t, true, y, yes}]
                            [--filter]
                            [--interval]
                            [--metricnames]
                            [--metricnamespace]
                            [--order-by]
                            [--result-type {Data, Metadata}]
                            [--roll-up-by]
                            [--timespan]
                            [--top]
                            [--validate-dimensions {0, 1, f, false, n, no, t, true, y, yes}]

필수 매개 변수

--region

원하는 메트릭이 있는 지역입니다.

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--aggregation

검색할 집계 형식(쉼표로 구분)의 목록입니다.

속성 값
매개 변수 그룹: Body Arguments
--auto-adjust-timegrain

true로 설정하면 전달된 시간 범위가 이 메트릭에서 지원되지 않는 경우 API는 지원되는 가장 가까운 시간 간격을 사용하여 결과를 반환합니다. false로 설정하면 잘못된 시간 범위 매개 변수에 대한 오류가 반환됩니다. 기본값은 false입니다.

속성 값
매개 변수 그룹: Body Arguments
허용되는 값: 0, 1, f, false, n, no, t, true, y, yes
--filter

$filter 반환된 메트릭 데이터 집합을 줄이는 데 사용됩니다.
Example:
메트릭에는 메타데이터 A, B 및 C가 포함됩니다.
- A = a1 및 B = b1 또는 b2인 C의 모든 시계열을 반환합니다.
$filter=A eq 'a1' 및 B eq 'b1' 또는 B eq 'b2' 및 C eq '*'
- 잘못된 변형:
$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 ''.

속성 값
매개 변수 그룹: Body Arguments
--interval

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

속성 값
매개 변수 그룹: Body Arguments
--metricnames

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

속성 값
매개 변수 그룹: Body Arguments
--metricnamespace

원하는 메트릭이 있는 메트릭 네임스페이스입니다.

속성 값
매개 변수 그룹: Body Arguments
--order-by

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

속성 값
매개 변수 그룹: Body Arguments
--result-type

수집된 데이터 집합을 줄입니다. 허용되는 구문은 작업에 따라 달라집니다. 자세한 내용은 작업의 설명을 참조하세요.

속성 값
매개 변수 그룹: Body Arguments
허용되는 값: Data, Metadata
--roll-up-by

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

속성 값
매개 변수 그룹: Body Arguments
--timespan

쿼리의 시간 범위입니다. 'startDateTime_ISO/endDateTime_ISO' 형식의 문자열입니다.

속성 값
매개 변수 그룹: Body Arguments
--top

검색할 최대 레코드 수입니다. $filter 지정한 경우에만 유효합니다. 기본값은 10입니다.

속성 값
매개 변수 그룹: Body Arguments
--validate-dimensions

false로 설정하면 잘못된 필터 매개 변수 값이 무시됩니다. true로 설정하면 잘못된 필터 매개 변수에 대한 오류가 반환됩니다. 기본값은 true입니다.

속성 값
매개 변수 그룹: Body Arguments
허용되는 값: 0, 1, f, false, n, no, t, true, y, yes
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성 값
Default value: False
--output -o

출력 형식

속성 값
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az monitor metrics list-sub-definitions

편집

구독에 대한 메트릭 정의를 나열합니다.

az monitor metrics list-sub-definitions --region
                                        [--metricnamespace]

필수 매개 변수

--region

원하는 메트릭이 있는 지역입니다.

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--metricnamespace

원하는 메트릭이 있는 메트릭 네임스페이스입니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성 값
Default value: False
--output -o

출력 형식

속성 값
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False