AWS SDK for JavaScript v2가 지원 종료에 도달했습니다. [AWS SDK for JavaScript v3](https://docs.aws.amazon.com//sdk-for-javascript/v3/developer-guide/)로 마이그레이션하실 것을 권장합니다. 마이그레이션 방법에 대한 자세한 내용은 해당 [공지 사항](https://aws.amazon.com/blogs//developer/announcing-end-of-support-for-aws-sdk-for-javascript-v2/)을 참조하세요.
# Amazon CloudWatch 경보 작업 사용
![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/ko_kr/sdk-for-javascript/v2/developer-guide/images/nodeicon.png)
**이 Node.js 코드 예제는 다음을 보여 줍니다.**
+ CloudWatch 경보를 기반으로 Amazon EC2 인스턴스의 상태를 자동으로 변경하는 방법
## 시나리오
경보 작업을 사용하면 Amazon EC2 인스턴스를 자동으로 중지, 종료, 재부팅 또는 복구하는 경보를 만들 수 있습니다. 인스턴스를 더는 실행할 필요가 없을 때 중지 또는 종료 작업을 사용할 수 있습니다. 재부팅 및 복구 작업을 사용하여 인스턴스를 자동으로 재부팅할 수 있습니다.
이 예제에서는 Amazon EC2 인스턴스의 재부팅을 트리거하는 CloudWatch의 경보 작업을 정의하는 데 일련의 Node.js 모듈이 사용됩니다. Node.js 모듈은 SDK for JavaScript로 `CloudWatch` 클라이언트 클래스의 다음 메서드를 사용하여 Amazon EC2 인스턴스를 관리합니다.
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/CloudWatch.html#enableAlarmActions-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/CloudWatch.html#enableAlarmActions-property)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/CloudWatch.html#disableAlarmActions-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/CloudWatch.html#disableAlarmActions-property)
CloudWatch 경보 작업에 대한 자세한 내용을 알아보려면 *Amazon CloudWatch 사용 설명서*의 [인스턴스를 중지, 종료, 재부팅 또는 복구하는 경보 생성](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UsingAlarmActions.html)을 참조하세요.
## 사전 필수 작업
이 예제를 설정하고 실행하려면 먼저 이러한 작업들을 완료해야 합니다.
+ Node.js를 설치합니다. Node.js 설치에 대한 자세한 내용은 [Node.js 웹 사이트](http://nodejs.org)를 참조하세요.
+ 사용자 자격 증명을 사용하여 공유 구성 파일을 생성합니다. 공유 자격 증명 파일 제공에 대한 자세한 내용은 [공유 인증 자격 증명 파일에서 Node.js에 인증 자격 증명 로드](loading-node-credentials-shared.md) 섹션을 참조하세요.
+ Amazon EC2 인스턴스를 설명, 재부팅, 중지 또는 종료할 권한을 부여하는 정책이 있는 IAM 역할을 생성합니다. IAM 역할 생성에 관한 자세한 내용은 *IAM 사용 설명서*의 [AWS 서비스에 대한 권한을 위임할 역할 생성](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html) 섹션을 참조하세요.
IAM 역할을 생성할 때 다음 역할 정책을 사용합니다.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"cloudwatch:Describe*",
"ec2:Describe*",
"ec2:RebootInstances",
"ec2:StopInstances*",
"ec2:TerminateInstances"
],
"Resource": [
"*"
]
}
]
}
```
------
##
글로벌 구성 객체를 생성한 후 코드에 대한 리전을 설정하여 SDK for JavaScript를 구성합니다. 이 예제에서 리전이 `us-west-2`로 설정되어 있습니다.
```
// Load the SDK for JavaScript
var AWS = require('aws-sdk');
// Set the Region
AWS.config.update({region: 'us-west-2'});
```
## 경보 작업 생성 및 활성화
파일 이름이 `cw_enablealarmactions.js`인 Node.js 모듈을 생성합니다. 위와 같이 SDK를 구성해야 합니다. CloudWatch에 액세스하려면 `AWS.CloudWatch` 서비스 객체를 생성합니다.
경보를 생성하기 위한 파라미터를 담을 JSON 객체를 생성하여 `ActionsEnabled`를 `true`로 지정하고 경보가 트리거할 작업에 대한 ARN 배열을 지정합니다. 경보가 없으면 생성하거나 경보가 있으면 업데이트하는 `putMetricAlarm` 서비스 객체의 `AWS.CloudWatch` 메서드를 호출합니다.
`putMetricAlarm`에 대한 콜백 함수가 성공적으로 완료되면 CloudWatch 경보의 이름이 포함된 JSON 객체를 생성합니다. `enableAlarmActions` 메서드를 호출하여 경보 작업을 활성화합니다.
```
// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });
// Create CloudWatch service object
var cw = new AWS.CloudWatch({ apiVersion: "2010-08-01" });
var params = {
AlarmName: "Web_Server_CPU_Utilization",
ComparisonOperator: "GreaterThanThreshold",
EvaluationPeriods: 1,
MetricName: "CPUUtilization",
Namespace: "AWS/EC2",
Period: 60,
Statistic: "Average",
Threshold: 70.0,
ActionsEnabled: true,
AlarmActions: ["ACTION_ARN"],
AlarmDescription: "Alarm when server CPU exceeds 70%",
Dimensions: [
{
Name: "InstanceId",
Value: "INSTANCE_ID",
},
],
Unit: "Percent",
};
cw.putMetricAlarm(params, function (err, data) {
if (err) {
console.log("Error", err);
} else {
console.log("Alarm action added", data);
var paramsEnableAlarmAction = {
AlarmNames: [params.AlarmName],
};
cw.enableAlarmActions(paramsEnableAlarmAction, function (err, data) {
if (err) {
console.log("Error", err);
} else {
console.log("Alarm action enabled", data);
}
});
}
});
```
예제를 실행하려면 명령줄에서 다음을 입력합니다.
```
node cw_enablealarmactions.js
```
이 샘플 코드는 [GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/cloudwatch/cw_enablealarmactions.js)에서 찾을 수 있습니다.
## 경보 작업 비활성화
파일 이름이 `cw_disablealarmactions.js`인 Node.js 모듈을 생성합니다. 위와 같이 SDK를 구성해야 합니다. CloudWatch에 액세스하려면 `AWS.CloudWatch` 서비스 객체를 생성합니다. CloudWatch 경보의 이름을 포함하는 JSON 객체를 생성합니다. `disableAlarmActions` 메서드를 호출하여 이 경보에 대한 작업을 비활성화합니다.
```
// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });
// Create CloudWatch service object
var cw = new AWS.CloudWatch({ apiVersion: "2010-08-01" });
cw.disableAlarmActions(
{ AlarmNames: ["Web_Server_CPU_Utilization"] },
function (err, data) {
if (err) {
console.log("Error", err);
} else {
console.log("Success", data);
}
}
);
```
예제를 실행하려면 명령줄에서 다음을 입력합니다.
```
node cw_disablealarmactions.js
```
이 샘플 코드는 [GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/cloudwatch/cw_disablealarmactions.js)에서 찾을 수 있습니다.