ハンズオン(簡易版): CloudWatch基礎 カスタムメトリクス

4.5. CloudWatchアラームの履歴取得 (handson-cli-cloudwatch-custom-alarm)

目的

CloudWatchアラーム"handson-cli-cloudwatch-custom-alarm"の履歴を取得します。

パラメータの指定

作業に必要なパラメータを変数に格納をします。

0. リージョンの指定

リージョンを指定します。

環境変数の設定

export AWS_DEFAULT_REGION='ap-northeast-1'

1. CloudWatchアラーム名

CloudWatchアラーム名を指定します。

変数の設定:

CLOUDWATCH_ALARM_NAME='handson-cli-cloudwatch-custom-alarm'

2. CloudWatchアラームのヒストリ最大数

CloudWatchアラームのヒストリ最大数を指定します。

CloudWatchアラームのヒストリ最大数を指定します。

変数の設定:

CLOUDWATCH_ALARM_HISTORY_MAX_ITEMS='2'

各変数に正しいパラメータ値が格納されていることを確認します。

変数の確認:

cat << END

  # 0. AWS_DEFAULT_REGION:"ap-northeast-1"
       AWS_DEFAULT_REGION="${AWS_DEFAULT_REGION}"

  # 1. CLOUDWATCH_ALARM_NAME:"handson-cli-cloudwatch-custom-alarm"
       CLOUDWATCH_ALARM_NAME="${CLOUDWATCH_ALARM_NAME}"
  # 2. CLOUDWATCH_ALARM_HISTORY_MAX_ITEMS:"2"
       CLOUDWATCH_ALARM_HISTORY_MAX_ITEMS="${CLOUDWATCH_ALARM_HISTORY_MAX_ITEMS}"

END

手順

CloudWatchアラームの履歴を取得します。

コマンド:

aws cloudwatch describe-alarm-history \
  --alarm-name ${CLOUDWATCH_ALARM_NAME} \
  --max-items ${CLOUDWATCH_ALARM_HISTORY_MAX_ITEMS} \
  --query "AlarmHistoryItems[].[join(\`\`,[Timestamp,\`: \`,HistoryItemType,\`: \`,HistorySummary])]" \
  --output text

結果(例):

2020-08-27T10:23:53.078Z: Action: Successfully executed action arn:aws:sns:ap-northeast-1:XXXXXXXXXXXX:handson-cli-cloudwatch-topic
2020-08-27T10:23:52.990Z: StateUpdate: Alarm updated from INSUFFICIENT_DATA to ALARM
None

完了確認

「CloudWatchアラーム"handson-cli-cloudwatch-custom-alarm"の履歴を取得している。」ことを確認します。