AWS CloudWatch – アラーム設定

概要

put-metric-alarmコマンドを使用して、アラーム設定をコマンドラインから登録する手順について記載。

例：「CPU使用率90%以上が3分間の平均で上回った場合」のアラームを登録するコマンド

aws cloudwatch put-metric-alarm
--alarm-name '[SITE-A] [Critical] InstanceId_CPUUtilization_sv1' 
--dimensions Name=InstanceId,Value=**********
--alarm-description '[SITE-A] [Critical] InstanceId_CPUUtilization_sv1' 
--alarm-actions "arn:aws:sns:ap-northeast-1:**********:critical" 
--namespace AWS/EC2 
--metric-name CPUUtilization 
--period 60 
--statistic Average 
--evaluation-periods 3 
--comparison-operator GreaterThanOrEqualToThreshold 
--threshold 90.0 
--unit Percent 
--treat-missing-data=notBreaching

※コマンドは一行で実行します。
「 Value=****** 」や「 sns:ap-northeast-1:******:critical 」は環境によって異なります。

解説

aws cloudwatch put-metric-alarm / メトリックアラームの登録用のコマンド

先頭にコマンドを指定します。

alarm-name / 名前

--alarm-name '[SITE-A] [Critical] InstanceId_CPUUtilization_sv1' 

アラームの名称。通知の件名として使用されます。

dimensions / インスタンスIDの指定

--dimensions Name=InstanceId,Value=**********

メトリクスをフィルタするために使用できる名前と値のペアを設定します。

Name=InstanceId

Value=%instanceid%　※インスタンスIDを設定します。

alarm-description / 説明

--alarm-description '[SITE-A] [Critical] InstanceId_CPUUtilization_sv1'

任意。

alarm-actions / アクション

通知

--alarm-actions "arn:aws:sns:ap-northeast-1:**********:critical" 

EC2アクション – インスタンスの再起動

--alarm-actions "arn:aws:swf:ap-northeast-1:**********:action/actions/AWS_EC2.InstanceId.Reboot/1.0"

EC2アクション – インスタンスの停止

--alarm-actions "arn:aws:swf:ap-northeast-1:**********:action/actions/AWS_EC2.InstanceId.Stop/1.0"

EC2アクション – インスタンスの終了

--alarm-actions "arn:aws:swf:ap-northeast-1:**********:action/actions/AWS_EC2.InstanceId.Terminate/1.0"

EC2アクション – インスタンスの復元

--alarm-actions "arn:aws:automate:ap-northeast-1:ec2:recover"

アクションを指定します。

arn:aws:swf

※アクションを複数登録する場合は、””で囲み、スペースで区切って記載する

namespace / 名前空間　※一部抜粋

--namespace AWS/EC2 

名前空間を指定します。

参照：AWSの名前空間

metric-name / メトリクス名　※一部抜粋

--metric-name CPUUtilization 

対象となるメトリクス名を設定します。

period / 期間

--period 60 

値を秒数で設定します。

statistic / 統計

--statistic Average 

統計の種類を設定します。

evaluation-periods / 評価

--evaluation-periods 3 

「統計」として使用する「期間」を継続する評価回数を設定します。

comparison-operator / 比較演算子

--comparison-operator GreaterThanOrEqualToThreshold 

比較演算子を設定します。

threshold / しきい値

--threshold 90.0 

しきい値となる値を設定します。

unit / 単位

--unit Percent

単位を設定します。

treat-missing-data / 欠損データの処理方法

--treat-missing-data=notBreaching

欠損データの処理方法を設定します。

補足

登録されている情報の詳細を確認するには以下のコマンドを実行します。

aws cloudwatch describe-alarms

「myalarm」の詳細情報だけを表示する場合は以下のコマンドを実行します。

aws cloudwatch describe-alarms --alarm-names "myalarm"