在 Amazon 中使用警報動作 CloudWatch - AWS SDK for JavaScript

我們宣布了即將推 end-of-support 出的 AWS SDK for JavaScript v2。我們建議您移轉至 AWS SDK for JavaScript v3。有關日期,其他詳細信息以及如何遷移的信息,請參閱鏈接的公告。

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

在 Amazon 中使用警報動作 CloudWatch

JavaScript code example that applies to Node.js execution

這個 Node.js 程式碼範例會說明:

  • 如何根據 CloudWatch 警示自動變更 Amazon EC2 執行個體的狀態。

使用案例

您可以使用警示動作建立自動停止、終止、重新開機或復原 Amazon EC2 執行個體的警示。當執行個體不再需要執行,您可以使用停止或終止動作。您可以使用重新啟動和恢復動作來自動重新啟動這些執行個體。

在此範例中,使用一系列 Node.js 模組來定義警示動作,以觸 CloudWatch 發 Amazon EC2 執行個體的重新開機。Node.js 模組會使用用CloudWatch戶端類別的下列方法 JavaScript 來管理 Amazon EC2 執行個體的開發套件:

如需 CloudWatch 警示動作的詳細資訊,請參閱 Amazon CloudWatch 使用者指南中的建立警示以停止、終止、重新開機或復原執行個體

先決條件任務

若要設定和執行此範例,您必須先完成這些任務:

您可以使用下列角色政策來建立 IAM 角色。

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "cloudwatch:Describe*", "ec2:Describe*", "ec2:RebootInstances", "ec2:StopInstances*", "ec2:TerminateInstances" ], "Resource": [ "*" ] } ] }

JavaScript 通過創建全局配置對象,然後為代碼設置區域來配置 SDK。在此範例中,區域會設為 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 模組。請務必依前述的內容來設定軟體開發套件。若要存取 CloudWatch,請建立AWS.CloudWatch服務物件。

建立 JSON 物件來保留用於建立警示的參數,指定 ActionsEnabledtrue,和一系列將觸發警示的動作的 ARN。呼叫 AWS.CloudWatch 服務物件的 putMetricAlarm 方法,它會在警示不存在時建立警示,若警示存在則會更新。

在的回呼函數中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。

停用警示上的動作

以檔名 cw_disablealarmactions.js 建立一個 Node.js 模組。請務必依前述的內容來設定軟體開發套件。若要存取 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。