# mon-put-metric-alarm ## 설명 경보를 생성 또는 업데이트하고 이를 지정된 CloudWatch 지표와 연결합니다 또한 이 명령을 사용하여 하나 이상의 Amazon Simple Notification Service(Amazon SNS) 리소스를 경보와 연결할 수도 있습니다. 이 작업이 경보를 만들면 해당 경보 상태는 바로 INSUFFICIENT\$1DATA로 설정됩니다. 경보가 평가되고 경보의 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` | 경보 상태 변경 시 작업을 실행해야 할지 여부를 지정합니다. 유형: Boolean 유효한 값: 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 사용 설명서*의 [권한 및 정책](https://docs.aws.amazon.com/IAM/latest/UserGuide/PermissionsAndPolicies.html) 단원을 참조하세요. 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\$1 255자인 모든 Unicode 문자열 기본값: 해당 사항 없음 필수 여부: 아니요 | | `--comparison-operator` `VALUE` | 데이터 포인트와 임계값을 비교하는 데 사용되는 비교 연산자입니다. 유형: 열거 유효한 값: GreaterThanOrEqualToThreshold, GreaterThanThreshold, LessThanThreshold 또는 LessThanOrEqualToThreshold 중 하나 기본값: 해당 사항 없음 필수 여부: 예 | | `--dimensions` `"key1=value1,key2=value2..."` | 경보를 생성하려는 지표의 차원입니다. 다음과 같이 차원을 두 가지 방식으로 지정할 수 있으며 형식을 결합하거나 서로 바꿔서 사용할 수 있습니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/AmazonCloudWatch/latest/cli/cli-mon-put-metric-alarm.html) 유형: 맵 유효한 값: name=value 형식의 문자열. 여기서 키는 차원의 이름이고 값은 차원의 값입니다. 차원 이름 및 값은 길이가 1\$1250자인 ANSI 문자열이어야 합니다. 허용되는 최대 차원 수는 10개입니다. 기본값: 해당 사항 없음 필수 여부: 아니요 | | `--evaluation-periods` `VALUE` | 지표 값을 임계값과 비교하여 경보 상태를 결정할 연속 기간의 수입니다. 유형: 정수 유효한 값: 0보다 큰 수 기본값: 해당 사항 없음 필수 여부: 예 | | `--metric-name` `VALUE` | 경보가 발생할 지표의 이름입니다. 유형: 인수 유효한 값: 길이가 1\$1 250자인 ANSI 문자열 기본값: 해당 사항 없음 필수 여부: 예 | | `--namespace` `VALUE` | 경보가 발생할 지표의 네임스페이스입니다. 네임스페이스에 대한 자세한 내용은 [AWS 네임스페이스](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/aws-namespaces.html) 단원을 참조하세요. 유형: 문자열 유효한 값: 길이가 1\$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` | 경보가 발생할 지표의 단위입니다. 유형: 열거 유효한 값: 다음 중 하나입니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/AmazonCloudWatch/latest/cli/cli-mon-put-metric-alarm.html) 기본값: 해당 사항 없음 필수 여부: 아니요 | | `--insufficient-data-actions` `VALUE1,VALUE2,VALUE3...` | 경보가 기타 모든 상태에서 INSUFFICIENT\$1DATA 상태로 전환될 때 실행할 작업입니다(최대 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 ``` ## 관련 주제 ### 다운로드 + [명령줄 인터페이스 설정](SetupCLI.md) ### 관련 작업 + [PutMetricAlarm](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html) ### 관련 명령 + [mon-put-data](cli-mon-put-data.md)