mon-put-metric-alarm - Amazon CloudWatch
설명구문옵션일반 옵션출력예시관련 주제

mon-put-metric-alarm

설명

경보를 생성 또는 업데이트하고 이를 지정된 CloudWatch 지표와 연결합니다 또한 이 명령을 사용하여 하나 이상의 Amazon Simple Notification Service(Amazon SNS) 리소스를 경보와 연결할 수도 있습니다.

이 작업이 경보를 만들면 해당 경보 상태는 바로 INSUFFICIENT_DATA로 설정됩니다. 경보가 평가되고 경보의 StateValue가 적절하게 설정됩니다. 그런 다음 StateValue와 연결된 작업이 실행됩니다.

참고

기존 경보를 업데이트할 때 해당 경보의 StateValue는 변경되지 않고 그대로 유지됩니다.

구문

mon-put-metric-alarm AlarmName --comparison-operator value --evaluation-periods value --metric-name value --namespace value --period value [--statistic value] [--extendedstatistic value] --threshold value [--actions-enabled value] [--alarm-actions value[,value...] ] [--alarm-description value] [--dimensions "key1=value1,key2=value2..."] [--ok-actions value[,value...] ] [--unit value] [--insufficient-data-actions value[,value...]] [Common Options]

옵션

명칭 설명

AlarmName

업데이트하거나 생성할 경보의 이름을 지정합니다. 이름은 AWS 계정 내에서 고유해야 합니다. 이 값은 --alarm-name을 사용하여 설정할 수도 있습니다.

유형: 인수

유효한 값: UTF-8 문자열

기본값: 해당 사항 없음

필수 여부: 예

--actions-enabled VALUE

경보 상태 변경 시 작업을 실행해야 할지 여부를 지정합니다.

타입: 부울

유효한 값: True 또는 False

기본값: True

필수 항목 여부: 아니요

--alarm-actions VALUE1,VALUE2,VALUE3...

경보가 기타 모든 상태에서 ALARM 상태로 전환될 때 실행할 작업입니다(최대 5개). 각 작업은 Amazon 리소스 이름(ARN)으로 지정됩니다. 경보 작업을 사용하여 Amazon SNS 주제에 게시하고, Amazon EC2 Auto Scaling 정책을 활성화하거나 Amazon EC2 인스턴스를 정지, 종료 또는 복구할 수 있습니다.

참고

AWS Identity and Access Management(IAM) 계정을 사용하여 경보를 생성하거나 수정할 경우 다음 Amazon EC2 권한이 있어야 합니다.

  • ec2:DescribeInstanceStatus 및 ec2:DescribeInstances - Amazon EC2 인스턴스 상태 지표에 대한 모든 경보

  • ec2:StopInstances - 중지 작업을 수반하는 경보

  • ec2:TerminateInstances - 종료 작업을 수반하는 경보

  • ec2:DescribeInstanceRecoveryAttribute 및 ec2:RecoverInstances - 복구 작업을 수반하는 경보

읽기 또는 쓰기 권한이 Amazon CloudWatch에 대해서는 있지만 Amazon EC2에 대해서는 없는 경우 여전히 경보를 생성할 수 있지만 Amazon EC2 인스턴스에서 중지 또는 종료 작업을 수행할 수 없습니다. 그러나 연결된 Amazon EC2 API를 사용할 수 있는 권한을 나중에 부여받는 경우 이전에 생성한 경보 작업을 수행할 수 있게 됩니다. IAM 권한에 대한 자세한 내용은 IAM 사용 설명서의 권한 및 정책 단원을 참조하세요.

IAM 역할(예: Amazon EC2 인스턴스 프로파일)을 사용 중인 경우 경보 작업을 사용하여 인스턴스를 중지하거나 종료할 수 없습니다. 그러나 경보 상태는 계속 표시되고 Amazon SNS 알림 또는 Amazon EC2 Auto Scaling 정책과 같은 다른 작업은 수행할 수 있습니다.

AWS Security Token Service(AWS STS)를 사용하여 부여된 임시 보안 자격 증명을 사용 중인 경우 경보 작업을 사용하여 Amazon EC2 인스턴스를 중지하거나 종료할 수 없습니다.

유형: 문자열

유효한 값: Amazon SNS 주제의 ARN, Auto Scaling 정책 또는 Amazon EC2 인스턴스를 정지, 종료 또는 복구하는 ARN.

기본값: 해당 사항 없음

필수 항목 여부: 아니요

--alarm-description VALUE

경보에 대한 설명입니다.

유형: 문자열

유효한 값: 길이가 1~ 255자인 모든 Unicode 문자열

기본값: 해당 사항 없음

필수 항목 여부: 아니요

--comparison-operator VALUE

데이터 포인트와 임계값을 비교하는 데 사용되는 비교 연산자입니다.

유형: 열거

유효한 값: GreaterThanOrEqualToThreshold, GreaterThanThreshold, LessThanThreshold 또는 LessThanOrEqualToThreshold 중 하나

기본값: 해당 사항 없음

필수 여부: 예

--dimensions "key1=value1,key2=value2..."

경보를 생성하려는 지표의 차원입니다. 다음과 같이 차원을 두 가지 방식으로 지정할 수 있으며 형식을 결합하거나 서로 바꿔서 사용할 수 있습니다.

  • 차원당 한 가지 옵션: --dimensions "key1=value1" --dimensions "key2=value2"

  • 한 가지 옵션으로 모두 적용: --dimensions "key1=value1,key2=value2"

유형: 맵

유효한 값: name=value 형식의 문자열. 여기서 키는 차원의 이름이고 값은 차원의 값입니다. 차원 이름 및 값은 길이가 1~250자인 ANSI 문자열이어야 합니다. 허용되는 최대 차원 수는 10개입니다.

기본값: 해당 사항 없음

필수 항목 여부: 아니요

--evaluation-periods VALUE

지표 값을 임계값과 비교하여 경보 상태를 결정할 연속 기간의 수입니다.

유형: 정수

유효한 값: 0보다 큰 수

기본값: 해당 사항 없음

필수 여부: 예

--metric-name VALUE

경보가 발생할 지표의 이름입니다.

유형: 인수

유효한 값: 길이가 1~ 250자인 ANSI 문자열

기본값: 해당 사항 없음

필수 여부: 예

--namespace VALUE

경보가 발생할 지표의 네임스페이스입니다. 네임스페이스에 대한 자세한 내용은 AWS 네임스페이스 단원을 참조하세요.

유형: 문자열

유효한 값: 길이가 1~ 250자인 ANSI 문자열

기본값: 해당 사항 없음

필수 여부: 예

--ok-actions VALUE1,VALUE2,VALUE3...

경보가 기타 모든 상태에서 OK 상태로 전환될 때 실행할 작업입니다(최대 5개). 각 작업은 Amazon 리소스 이름(ARN)으로 지정됩니다.

유형: 문자열

유효한 값: 유효한 ARN 식별자

기본값: 해당 사항 없음

필수 항목 여부: 아니요

--period VALUE

경보가 발생할 지표 기간(초)입니다.

유형: 인수

유효한 값: 60초의 배수인 숫자(초)

기본값: 해당 사항 없음

필수 여부: 예

--statistic VALUE

경보가 발생할 지표의 통계입니다.

유형: 열거

유효한 값: SampleCount, Average, Sum, Minimum 또는 Maximum

기본값: 해당 사항 없음

필수: --statistic 또는 --extendedstatistic을 지정해야 합니다.

--extendedstatistic VALUE

경보가 발생할 지표의 백분위수 통계입니다.

유형: 문자열

유효한 값: 소수점 이하 두 자리까지의 백분위수입니다(예: p95.45).

기본값: 해당 사항 없음

필수: --statistic 또는 --extendedstatistic을 지정해야 합니다.

--threshold VALUE

데이터 요소와 비교하여 경보 상태를 결정할 임계값입니다.

유형: Double

유효한 값: double 값. 모든 값은 1E-130과 1E130 사이의 숫자여야 합니다.

기본값: 해당 사항 없음

필수 여부: 예

--unit VALUE

경보가 발생할 지표의 단위입니다.

유형: 열거

유효한 값: 다음 중 하나입니다.

  • 초

  • 마이크로초

  • 밀리초

  • 바이트

  • KB

  • MB

  • GB

  • TB

  • 비트

  • Kbit

  • Mbit

  • Gbit

  • Tbit

  • %

  • 개수

  • 바이트/초

  • KB/s

  • MB/s

  • GB/s

  • TB/s

  • 비트/초

  • Kbit/s

  • Mbit/s

  • Gbit/s

  • Tbit/s

  • 개수/초

  • None

기본값: 해당 사항 없음

필수 항목 여부: 아니요

--insufficient-data-actions VALUE1,VALUE2,VALUE3...

경보가 기타 모든 상태에서 INSUFFICIENT_DATA 상태로 전환될 때 실행할 작업입니다(최대 5개). 각 작업은 Amazon 리소스 이름(ARN)으로 지정됩니다.

유형: 문자열

유효한 값: 유효한 ARN 식별자

기본값: 해당 사항 없음

필수 항목 여부: 아니요

일반 옵션

이름 설명

--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에 지정된 값을 사용합니다(설정된 경우).

출력

이 명령은 지정된 메트릭과 연결된 경보를 만들거나 업데이트합니다.

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

예시

요청 예제

이 예제는 연속하는 1분 기간 3개에 대해 EC2 인스턴스의 CPU 사용률이 90%를 초과하는 경우 주제에 메시지를 게시하는 경보를 만듭니다.

mon-put-metric-alarm --alarm-name my-alarm --alarm-description "some desc" \
--metric-name CPUUtilization --namespace AWS/EC2 --statistic Average  --period 60 --threshold 90 \
--comparison-operator GreaterThanThreshold  --dimensions InstanceId=i-abcdef --evaluation-periods 3  \
--unit Percent --alarm-actions arn:aws:sns:us-east-1:1234567890:my-topic

관련 주제

다운로드

관련 작업

관련 명령