mon-describe-alarm-history

설명

지정한 경보의 기록을 검색합니다. 날짜 범위 또는 항목 유형별로 경보를 필터링할 수 있습니다. 경보 이름을 지정하지 않은 경우 Amazon CloudWatch는 모든 경보에 대한 기록을 반환합니다.

참고

Amazon CloudWatch는 활성 경보 및 삭제된 경보의 기록을 2주간 유지합니다.

구문

mon-describe-alarm-history [AlarmNames [AlarmNames ...]] [--end-date value] [--history-item-type value] [--start-date value] [Common Options]

옵션

명칭	설명
`AlarmName` `AlarmNames`	경보 이름으로, 공백으로 구분됩니다. 경보 이름을 지정하지 않으면 이 명령은 모든 경보에 대한 기록을 반환합니다. 이 값은 `--alarm-name`을 사용하여 설정할 수도 있습니다. 유형: 인수 유효한 값: 길이가 1~255자인 모든 문자열 기본값: 해당 사항 없음 필수 항목 여부: 아니요
`--end-date` `VALUE`	기록에 대한 날짜 범위의 끝입니다. 유형: 날짜 유효한 값: YYYY-MM-DD 형식의 날짜 기본값: 현재 날짜 필수 여부: 아니요
`--history-item-type` `VALUE`	검색할 기록 항목의 유형입니다. 기본적으로 모든 유형이 반환됩니다. 유형: 열거 유효한 값: ConfigurationUpdate, StateUpdate 또는 Action 기본값: 모든 유형이 반환됩니다. 필수 항목 여부: 아니요
`--start-date` `VALUE`	기록에 대한 날짜 범위의 시작입니다. 기본적으로 사용 가능한 모든 기록으로 확장됩니다. 유형: 날짜 유효한 값: YYYY-MM-DD 형식의 날짜 기본값: 사용 가능한 모든 기록 필수 항목 여부: 아니요

일반 옵션

이름	설명
`--aws-credential-file` `VALUE`	AWS 자격 증명을 포함하는 파일의 위치입니다. 환경 변수 `AWS_CREDENTIAL_FILE`을 사용하여 이 값을 설정할 수 있습니다. 환경 변수를 정의하거나 자격 증명 파일에 대한 경로를 제공하는 경우 이 파일이 있어야 합니다. 그렇지 않으면 요청이 실패합니다. 액세스 키 ID 및 비밀 액세스 키를 사용하여 모든 CloudWatch 요청에 서명해야 합니다. 타입: 문자열 유효한 값: 액세스 키 ID 및 비밀 액세스 키를 포함하는 파일의 유효한 경로입니다. 기본값: `AWS_CREDENTIAL_FILE` 환경 변수(설정된 경우)를 사용합니다.
`-C, --ec2-cert-file-path` `VALUE`	요청 서명을 위한 EC2 인증서 파일의 위치입니다. 환경 변수 `EC2_CERT`를 사용하여 이 값을 지정할 수 있습니다. 타입: 문자열 유효한 값: Amazon EC2 또는 AWS Identity and Access Management에서 제공하는 PEM 파일의 유효한 파일 경로입니다. 기본값: `EC2_CERT` 환경 변수(설정된 경우)를 사용합니다.
`--connection-timeout` `VALUE`	연결 제한 시간 값(초)입니다. 유형: 정수 유효한 값: 양수입니다. 기본값: 30
`--delimiter` `VALUE`	구분된(long) 결과를 표시할 때 사용할 구분 기호입니다. 타입: 문자열 유효한 값: 문자열입니다. 기본값: 쉼표(,)
`--headers`	표 형식 또는 구분된 결과를 표시하는 경우 열 머리글을 포함합니다. XML 결과를 표시하는 경우 서비스 요청에서 HTTP 헤더를 반환합니다(해당하는 경우). 유형: 플래그 유효한 값: 제공되면 헤더를 표시합니다. 기본값: `--headers` 옵션은 기본적으로 해제되어 있습니다.
`-I, --access-key-id` `VALUE`	비밀 키와 함께 요청에 서명하는 데 사용할 액세스 키 ID입니다. 이는 --secret-key와 함께 사용해야 합니다. 그렇지 않으면 옵션이 무시됩니다. CloudWatch에 대한 모든 요청에 서명해야 합니다. 그러지 않으면 요청이 거부됩니다. 타입: 문자열 유효한 값: 유효한 액세스 키 ID입니다. 기본값: None
`-K, --ec2-private-key-file-path` `VALUE`	요청에 서명하는 데 사용할 프라이빗 키입니다. 퍼블릭 또는 프라이빗 키를 사용하면 CLI에서 SOAP를 사용하게 됩니다. 퍼블릭 인증서 및 프라이빗 키를 사용하여 요청에 서명합니다. 이 파라미터는 `EC2_CERT`와 함께 사용해야 합니다. 그렇지 않으면 값이 무시됩니다. 환경 변수 `EC2_PRIVATE_KEY` 값은 설정되고 이 옵션이 지정되지 않은 경우 사용됩니다. 이 옵션은 환경 변수 `AWS_CREDENTIAL_FILE`이 설정되거나 `--aws-credentials-file`이 사용되는 경우 무시됩니다. CloudWatch에 대한 모든 요청에 서명해야 합니다. 그러지 않으면 요청이 거부됩니다. 타입: 문자열 유효한 값: 유효한 ASN.1 프라이빗 키에 대한 경로입니다. 기본값: None
`--region` `VALUE`	요청이 전달되는 리전입니다. 환경 변수 `EC2_REGION`을 사용하여 값을 지정할 수 있습니다. 리전은 CloudWatch를 호출하는 데 사용되는 URL을 생성하는 데 이용되며 유효한 Amazon Web Services(AWS) 리전이어야 합니다. 타입: 문자열 유효한 값: AWS 리전(예: us-east-1)입니다. 기본값: `EC2_REGION` 환경 변수가 설정되지 않은 경우 us-east-1입니다.
`S, --secret-key` `VALUE`	액세스 키 ID와 함께 요청에 서명하는 데 사용할 비밀 액세스 키입니다. 이 파라미터는 `--access-key-id`와 함께 사용해야 합니다. 그렇지 않으면 이 옵션이 무시됩니다. 타입: 문자열 유효한 값: 액세스 키 ID입니다. 기본값: None
`--show-empty-fields`	이 데이터가 요청되지 않았음을 나타내는 자리 표시자로 (nil)을 사용하여 빈 필드를 표시합니다. 유형: 플래그 유효한 값: 없음 기본값: 빈 필드는 기본적으로 표시되지 않습니다.
`--show-request`	CLI가 AWS를 호출하는 데 사용하는 URL을 표시합니다. 유형: 플래그 유효한 값: 없음 기본값: false
`--show-table, --show-long, --show-xml, --quiet`	결과가 표시되는 방식을 지정합니다. 예를 들어 결과를 표 형식, 구분된(long) 형식, XML 형식 또는 출력 없음(quiet) 형식으로 표시할 수 있습니다. `--show-table` 표시에서는 데이터의 하위 집합을 고정 열 너비 형식으로 표시하고, `--show-long`은 반환된 모든 값을 문자로 구분된 형식으로 표시하고, `--show-xml`은 서비스에서의 원시 반환이며, `--quiet`는 모든 표준 출력을 억제합니다. 모든 옵션은 서로 함께 사용되지 않으며 우선순위는 `--show-table`, `--show-long`, `--show-xml`, `--quiet`입니다. 유형: 플래그 유효한 값: 없음 기본값: `--show-table`
`-U, --url` `VALUE`	CloudWatch에 연결할 때 사용하는 URL입니다. 환경 변수 `AWS_CLOUDWATCH_URL`을 사용하여 이 값을 설정할 수 있습니다. 이 값은 `--region`과 함께 사용되어 예상 URL을 생성합니다. 이 옵션은 서비스 호출에 대한 URL을 재정의합니다. 타입: 문자열 유효한 값: 유효한 HTTP 또는 HTTPS URL입니다. 기본값: `AWS_CLOUDWATCH_URL`에 지정된 값을 사용합니다(설정된 경우).

출력

이 명령은 다음이 포함된 표를 반환합니다.

ALARM - 경보 이름.
TIMESTAMP - 타임스탬프.
TYPE – 이벤트 유형으로, ConfigurationUpdate, StateUpdate 및 Action 중 하나입니다.
SUMMARY – 사람이 읽을 수 있는 기록 이벤트 요약
DATA – 기계 판독이 가능한 JSON 형식의 이벤트에 대한 자세한 데이터. 이 열은 --show-long 보기에만 나타납니다.

Amazon CloudWatch CLI는 stderr에 오류를 표시합니다.

예

요청 예제

이 예는 경보 my-alarm에 대한 모든 기록 항목을 설명합니다.


mon-describe-alarm-history--alarm-name my-alarm --headers

다음은 이 명령의 출력 예입니다.


ALARM     TIMESTAMP                 TYPE                 SUMMARY
my-alarm  2013-05-07T18:46:16.121Z  Action               Published a notification to arn:aws:sns:...
my-alarm  2013-05-07T18:46:16.118Z  StateUpdate          Alarm updated from INSUFFICIENT_DATA to OK
my-alarm  2013-05-07T18:46:07.362Z  ConfigurationUpdate  Alarm "my-alarm" created

mon-describe-alarm-history

설명

참고

구문

옵션

일반 옵션

출력

예

요청 예제

관련 주제

다운로드

관련 작업

관련 명령