mon-describe-alarms
설명
지정한 경보에 대한 정보를 가져옵니다. 경보 이름을 지정하지 않으면 이 명령은 모든 경보에 대한 정보를 반환합니다. 경보 이름 접두사, 경보 상태 또는 작업 접두사만 사용하여 경보를 검색할 수 있습니다.
구문
mon-describe-alarms
[AlarmNames [
AlarmNames
...]] [--action-prefix value
] [--alarm-name-prefix value
]
[--state-value value
] [Common Options]
옵션
명칭 | 설명 |
---|---|
|
경보의 이름입니다. 이 값은 유형: 인수 유효한 값: 기존 경보 이름. 그렇지 않으면 응답이 반환되지 않습니다. 기본값: 해당 사항 없음. 기본적으로 모든 경보가 표시됩니다. 필수 항목 여부: 아니요 |
|
작업 이름의 접두사 유형: 인수 유효한 값: 기존 작업 이름의 접두사(ARN 형식) 기본값: 해당 사항 없음. 기본적으로 첫 번째 작업이 표시됩니다. 필수 항목 여부: 아니요 |
|
경보 이름의 접두사 유형: 인수 유효한 값: 기존 경보 이름의 접두사 기본값: 해당 사항 없음 필수 항목 여부: 아니요 |
|
경보 상태 유형: 열거 유효한 값: OK, ALARM 또는 INSUFFICIENT_DATA 기본값: 모든 경보 상태 필수 항목 여부: 아니요 |
일반 옵션
이름 | 설명 |
---|---|
|
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입니다. 기본값: |
출력
이 명령은 다음이 포함된 표를 반환합니다.
-
ALARM – 경보 이름입니다.
-
DESCRIPTION - 경보 설명입니다. 이 열은 --show-long 보기에만 나타납니다.
-
STATE - 경보 상태입니다.
-
STATE_REASON - 사람이 읽을 수 있는 상태에 대한 원인입니다. 이 열은 --show-long 보기에만 나타납니다.
-
STATE_REASON_DATA - 시스템에서 읽을 수 있는 상태에 대한 원인(JSON 형식)입니다. 이 열은 --show-long 보기에만 나타납니다.
-
ENABLED - 작업을 사용하거나 사용 중지합니다. 이 열은 --show-long 보기에만 나타납니다.
-
OK_ACTIONS - OK 상태에서 실행할 작업입니다. 이 열은 --show-long 보기에만 나타납니다.
-
ALARM_ACTIONS - ALARM 상태에서 실행할 작업입니다.
-
INSUFFICIENT_DATA_ACTIONS - INSUFFICIENT_DATA 상태에서 실행할 작업입니다. 이 열은 --show-long 보기에만 나타납니다.
-
NAMESPACE - 지표의 네임스페이스입니다.
-
METRIC_NAME - 지표의 이름입니다.
-
DIMENSIONS - 지표 차원입니다. 이 열은 --show-long 보기에만 나타납니다.
-
PERIOD - 기간입니다.
-
STATISTIC - 통계(Average, Minimum, Maximum, Sum, SampleCount)입니다.
-
EXTENDEDSTATISTIC - 백분위수 통계입니다.
-
UNIT - 단위입니다. 이 열은 --show-long 보기에만 나타납니다.
-
EVAL_PERIODS - 지표를 평가할 기간입니다.
-
COMPARISON - 비교 연산자입니다.
-
THRESHOLD - 임계값입니다.
Amazon CloudWatch CLI는 stderr에 오류를 표시합니다.
예시
요청 예제
이 예는 이름이 my-alarm으로 시작하는 모든 경보에 대해 설명합니다.
mon-describe-alarms --alarm-name-prefix my-alarm --headers
다음은 이 명령의 출력 예입니다.
ALARM STATE ALARM_ACTIONS NAMESPACE METRIC_NAME PERIOD STATISTIC EVAL_PERIODS COMPARISON THRESHOLD my-alarm1 OK arn:aws:sns:.. AWS/EC2 CPUUtilization 60 Average 3 GreaterThanThreshold 100.0 my-alarm2 OK arn:aws:sns:.. AWS/EC2 CPUUtilization 60 Average 5 GreaterThanThreshold 80o.0