mon-list-metrics
설명
AWS 계정과 연결된 지표의 이름, 네임스페이스 및 차원을 나열합니다. 지표 이름, 네임스페이스 또는 차원의 모든 조합을 사용하여 지표를 필터링할 수 있습니다. 필터를 지정하지 않으면 해당 속성에 대해 일치하는 가능한 모든 항목이 반환됩니다.
참고
mon-list-metrics 명령이 호출로 mon-put-data
에 추가된 새 메트릭 이름, 네임스페이스 및 차원을 보고하는 데에는 최대 15분 가량 소요될 수 있습니다. mon-put-data
명령이 mon-get-statistics
로 반환된 데이터 요소 또는 기타 메소드를 사용할 수 있게 되기까지는 5분이 채 걸리지 않습니다.
구문
mon-list-metrics [--dimensions
"key1=
value1
,key2=value2
..."] [--metric-name value
] [--namespace value
] [Common Options]
옵션
명칭 | 설명 |
---|---|
-d, --dimensions |
검색할 지표의 차원. 다음과 같이 차원을 두 가지 방식으로 지정할 수 있으며 형식을 결합하거나 서로 바꿔서 사용할 수 있습니다.
차원을 지정하지 않으면 차원이 필터링되지 않습니다. 요청된 다른 필터가 적용됩니다. 메트릭에 요청한 메트릭 이외의 추가 차원이 포함되어 있을 수 있더라도 결과에 포함되려면 메트릭에는 지정된 차원이 모두 있어야 합니다. 유형: 맵 유효한 값: name=value 형식의 문자열. 여기서 키는 차원의 이름이고 값은 차원의 값입니다. 차원 이름 및 값은 길이가 1~250자인 ANSI 문자열이어야 합니다. 허용되는 최대 차원 수는 10개입니다. 기본값: 해당 사항 없음 필수 항목 여부: 아니요 |
|
지표의 이름. 결과에 포함하려면 지표 이름이 요청한 지표 이름과 정확하게 일치해야 합니다. 지표 이름을 지정하지 않으면 필터링되지 않습니다. 요청된 다른 필터가 적용됩니다. 유형: Simple 유효한 값: 길이가 1~ 250자인 유효한 모든 메트릭 이름 기본값: 해당 사항 없음 필수 항목 여부: 아니요 |
|
지표를 필터링하는 데 사용할 네임스페이스. 네임스페이스에 대한 자세한 내용은 AWS 네임스페이스 단원을 참조하세요. 타입: 문자열 유효한 값: 길이가 1~ 250자인 유효한 네임스페이스 기본값: 해당 사항 없음 필수 항목 여부: 아니요 |
일반 옵션
이름 | 설명 |
---|---|
|
AWS 자격 증명을 포함하는 파일의 위치입니다. 환경 변수 타입: 문자열 유효한 값: 액세스 키 ID 및 비밀 액세스 키를 포함하는 파일의 유효한 경로입니다. 기본값: |
|
요청 서명을 위한 EC2 인증서 파일의 위치입니다. 환경 변수 타입: 문자열 유효한 값: Amazon EC2 또는 AWS Identity and Access Management에서 제공하는 PEM 파일의 유효한 파일 경로입니다. 기본값: |
|
연결 제한 시간 값(초)입니다. 유형: 정수 유효한 값: 양수입니다. 기본값: 30 |
|
구분된(long) 결과를 표시할 때 사용할 구분 기호입니다. 타입: 문자열 유효한 값: 문자열입니다. 기본값: 쉼표(,) |
|
표 형식 또는 구분된 결과를 표시하는 경우 열 머리글을 포함합니다. XML 결과를 표시하는 경우 서비스 요청에서 HTTP 헤더를 반환합니다(해당하는 경우). 유형: 플래그 유효한 값: 제공되면 헤더를 표시합니다. 기본값: |
|
비밀 키와 함께 요청에 서명하는 데 사용할 액세스 키 ID입니다. 이는 --secret-key와 함께 사용해야 합니다. 그렇지 않으면 옵션이 무시됩니다. CloudWatch에 대한 모든 요청에 서명해야 합니다. 그러지 않으면 요청이 거부됩니다. 타입: 문자열 유효한 값: 유효한 액세스 키 ID입니다. 기본값: None |
|
요청에 서명하는 데 사용할 프라이빗 키입니다. 퍼블릭 또는 프라이빗 키를 사용하면 CLI에서 SOAP를 사용하게 됩니다. 퍼블릭 인증서 및 프라이빗 키를 사용하여 요청에 서명합니다. 이 파라미터는 타입: 문자열 유효한 값: 유효한 ASN.1 프라이빗 키에 대한 경로입니다. 기본값: None |
|
요청이 전달되는 리전입니다. 환경 변수 타입: 문자열 유효한 값: AWS 리전(예: us-east-1)입니다. 기본값: |
|
액세스 키 ID와 함께 요청에 서명하는 데 사용할 비밀 액세스 키입니다. 이 파라미터는 타입: 문자열 유효한 값: 액세스 키 ID입니다. 기본값: None |
|
이 데이터가 요청되지 않았음을 나타내는 자리 표시자로 (nil)을 사용하여 빈 필드를 표시합니다. 유형: 플래그 유효한 값: 없음 기본값: 빈 필드는 기본적으로 표시되지 않습니다. |
|
CLI가 AWS를 호출하는 데 사용하는 URL을 표시합니다. 유형: 플래그 유효한 값: 없음 기본값: false |
|
결과가 표시되는 방식을 지정합니다. 예를 들어 결과를 표 형식, 구분된(long) 형식, XML 형식 또는 출력 없음(quiet) 형식으로 표시할 수 있습니다. 유형: 플래그 유효한 값: 없음 기본값: |
|
CloudWatch에 연결할 때 사용하는 URL입니다. 환경 변수 타입: 문자열 유효한 값: 유효한 HTTP 또는 HTTPS URL입니다. 기본값: |
출력
이 명령은 다음이 포함된 표를 반환합니다.
-
메트릭 이름 – 이 메트릭에 연결된 메트릭의 이름입니다.
-
네임스페이스 – 이 메트릭과 연결된 네임스페이스입니다.
-
차원 – 이 지표와 연결된 차원 이름 및 값입니다.
Amazon CloudWatch CLI는 stderr에 오류를 표시합니다.
예
요청 예제
이 예는 모든 메트릭 목록을 반환합니다.
mon-list-metrics
'mon-list-metrics'에 대한 호출의 출력을 보여주는 예제입니다.
Metric Name Namespace Dimensions CPUUtilization AWS/EC2 {InstanceId=i-e7e48a8e} CPUUtilization AWS/EC2 {InstanceId=i-231d744a} CPUUtilization AWS/EC2 {InstanceId=i-22016e4b} CPUUtilization AWS/EC2 {InstanceId=i-b0345cd9} CPUUtilization AWS/EC2 {InstanceId=i-539dff3a} CPUUtilization AWS/EC2 {InstanceId=i-af3544c6} CPUUtilization AWS/EC2 {InstanceId=i-d4f29ebd} CPUUtilization AWS/EC2 {ImageId=ami-de4daab7} ...
요청 예제
이 예제에서는 지정된 이름을 가진 지표를 나열합니다.
mon-list-metrics --metric-name RequestCount
요청 예제
이 예제에서는 지정된 네임스페이스에 속하는 지표를 나열합니다.
mon-list-metrics --namespace MyService
요청 예제
이 예제에서는 지정된 차원 이름 및 값을 가진 지표를 나열합니다.
mon-list-metrics --dimensions "User=SomeUser,Stack=Test"