CloudWatch アラームのミュートルールをホスト一覧から一括作成・削除するシェルスクリプトを作ってみた

CloudWatch アラームのミュートルールをホスト一覧から一括作成・削除するシェルスクリプトを作ってみた

おはようございます gio です。 1回限りのミュートルールを作成するシェルを作成しました。
2026.11.16

はじめに

メンテナンス作業のたびに対象サーバー・リソースの CloudWatch アラームを一時的に停止したい場面があります。
対象が数台であれば、コンソールからミュートルールを作れば済みますが、数十台以上になると 1 台ずつ「対象アラームを選んで、期間を入れて、保存する」作業は時間を要することがあります。
そこで、ホスト名を 1 行 1 件で書いたファイルと日付を渡すだけで、全ホスト分のミュートルールを一括で作成・削除するシェルスクリプトを作りました。
この記事では、そのスクリプトの使い方と仕組みを紹介します。

そもそもミュートルールとは

CloudWatch のアラームミュートルールは、指定した期間、指定したアラームのアクション (通知など) を一時的に止める機能です。
アラームそのものを無効化するのではなく、ルールで決めた期間だけアクションを抑止します。

ミュートルールの仕様についてはこちらをご確認ください。
https://docs.aws.amazon.com/ja_jp/AmazonCloudWatch/latest/monitoring/alarm-mute-rules-behaviour.html

今回のスクリプトでは、次の AWS CLI コマンドを使っています。

操作 コマンド
作成 aws cloudwatch put-alarm-mute-rule
削除 aws cloudwatch delete-alarm-mute-rule
一覧取得 (削除後の確認用) aws cloudwatch list-alarm-mute-rules

前提条件

必要なもの 備考
bash Linux 環境 (AWS CloudShell など) を想定
AWS CLI ミュートルールのコマンドに対応したバージョン
jq アラーム名の絞り込みに使用
GNU date 日付計算に使用。macOS 標準の date は -d オプションに対応していないため、そのままでは動きません

AWS CloudShell であれば上記がそろっているので、手軽に試せます。

必要な IAM 権限は、cloudwatch:DescribeAlarms、cloudwatch:PutAlarmMuteRule、cloudwatch:DeleteAlarmMuteRule、cloudwatch:ListAlarmMuteRules などです。
正確な権限名は、お使いの環境の公式ドキュメントで確認してください。

やってみた

先に実行例から説明します。
現在ホスト名が ******14 という CloudWatch アラームが 18 件あります。
このホスト名のアラームにミュートルールを作成して、一時的にアラーム状態になってもアラームアクションが発生させないようにミュートルールを作成します。

hosts ファイルに ******14 と記載したものを準備して、CloudShell などの環境でシェルを実行します。
今回は 2026/11/16 から 2026/11/17 までで日付を設定します。

$ cat hosts.txt 
******14
$ ./create-mute-rules.sh create 20261116 hosts.txt -E 20261117
全アラーム名を取得しています...
取得したアラーム数: 50

--- 対象の確認 (1 ホスト) ---
  ******14: 対象アラーム 18 件

==================== 実行内容の確認 ====================
操作        : ミュートルールの【作成】
対象日      : 2026/11/16
期間(JST) : 2026/11/16 00:00〜2026/11/17 23:59 (1日23時間59分 / P1DT23H59M)
対象ホスト  : 1 件 (スキップ/エラー 0 件)
ルール名の例: cm-msp-mute-rule-temp-******14-20261116
========================================================

1件のミュートルールを【作成】します。よろしいですか? [y/N]: y

=== ******14 ===
  OK: 作成 cm-msp-mute-rule-temp-******14-20261116

===== 結果 =====
成功: 1 件
失敗/スキップ: 0 件
$

実行内容として対象アラームとして 18 件が確認できており、期間も想定通りの内容です。
成功しているのでマネジメントコンソールから確認してみます。
アラームの横にある「ミュートルール」のタブから確認することができます。


ミュートルールが設定時間、対象のアラームも問題なくされているのが確認できました。

create-mute-rules.sh

今回作成したスクリプトの全容です。
詳細な説明については スクリプトの概要 をご確認ください。

#!/usr/bin/env bash
#
# CloudWatch アラームのミュートルールを、ホスト一覧ファイルをもとに一括で「作成」または「削除」します。
#
# 使い方:
#   ./create-mute-rules.sh <create|delete> [日付 YYYYMMDD] <ホスト一覧ファイル> [オプション]
#   ※日付を省略すると、当日(JST)になります
#
# オプション:
#   -s, --start HH:MM   抑止開始時刻 (JST, 既定 00:00)        ※createのみ
#   -e, --end   HH:MM   抑止終了時刻 (JST, 既定 23:59)        ※createのみ
#                       開始以前の時刻を指定すると「翌日の終了時刻」として扱います
#   -E, --end-date YYYYMMDD  抑止終了日 (終了時刻は -e、既定 23:59)  ※createのみ
#                       最長 15日。--days とは同時に指定できません
#   -d, --days  N       開始時刻から N 日間 (1〜15) 抑止する    ※createのみ
#                       -e / -E とは同時に指定できません
#   -y, --yes           実行前の確認をスキップする
#   -n, --dry-run       AWS上では何も作成・削除せず、内容の確認だけ行う
#   -h, --help          この使い方を表示する
#
# ホスト一覧ファイル: 1行1ホスト名(Nameタグから「EC2-」を除いた値)
#   空行と # で始まる行は無視します。
#   アラーム名に「-<ホスト名>-」を含むもの、または「-<ホスト名>」で終わるものを対象にします。(複合アラームは対象外)
#
# 削除(delete)は、同じ「日付」と「ホスト名」から作られるルール名
#   cm-msp-mute-rule-temp-<ホスト名>-<日付>
# を対象にします。作成時と同じ日付・ホスト一覧を指定してください。

set -uo pipefail

export AWS_REGION=ap-northeast-1   # 変更しない

# ---- 固定設定(必要に応じて変更) ----
START_TIME="00:00"                 # 抑止開始時刻 (JST)  ※-s で上書き可
END_TIME="23:59"                   # 抑止終了時刻 (JST)  ※-e で上書き可
# --------------------------------------

ASSUME_YES=false
DRY_RUN=false
TIME_SPECIFIED=false
END_SPECIFIED=false
DAYS_SPECIFIED=false
DAYS=""
END_DATE=""
END_DATE_SPECIFIED=false

usage() {
  cat >&2 <<EOF
Usage: $0 <create|delete> [YYYYMMDD] <host_list_file> [options]
  (YYYYMMDD を省略すると当日(JST)になります)

Options:
  -s, --start HH:MM   抑止開始時刻 (JST, 既定 ${START_TIME})  ※createのみ
  -e, --end   HH:MM   抑止終了時刻 (JST, 既定 ${END_TIME})  ※createのみ
  -E, --end-date YYYYMMDD  抑止終了日 (終了時刻は -e)  ※createのみ。最長15日。--days とは併用不可
  -d, --days  N       開始時刻から N 日間 (1〜15) 抑止する  ※createのみ。-e / -E とは併用不可
  -y, --yes           実行前の確認をスキップする
  -n, --dry-run       何も作成・削除せず、内容の確認だけ行う
  -h, --help          この使い方を表示する
EOF
  exit "${1:-1}"
}

# ---- 引数の解析 ----
POSITIONAL=()
while [[ $# -gt 0 ]]; do
  case "$1" in
    -s|--start) [[ $# -ge 2 ]] || { echo "ERROR: $1 には値が必要です" >&2; usage; }
                START_TIME="$2"; TIME_SPECIFIED=true; shift 2 ;;
    -e|--end)   [[ $# -ge 2 ]] || { echo "ERROR: $1 には値が必要です" >&2; usage; }
                END_TIME="$2"; TIME_SPECIFIED=true; END_SPECIFIED=true; shift 2 ;;
    -E|--end-date) [[ $# -ge 2 ]] || { echo "ERROR: $1 には値が必要です" >&2; usage; }
                END_DATE="$2"; END_DATE_SPECIFIED=true; TIME_SPECIFIED=true; shift 2 ;;
    -d|--days)  [[ $# -ge 2 ]] || { echo "ERROR: $1 には値が必要です" >&2; usage; }
                DAYS="$2"; DAYS_SPECIFIED=true; TIME_SPECIFIED=true; shift 2 ;;
    -y|--yes)     ASSUME_YES=true; shift ;;
    -n|--dry-run) DRY_RUN=true; shift ;;
    -h|--help)    usage 0 ;;
    -*) echo "ERROR: 不明なオプションです: $1" >&2; usage ;;
    *)  POSITIONAL+=("$1"); shift ;;
  esac
done

# 引数は「操作 日付 ホスト一覧」の3つ。日付を省略した「操作 ホスト一覧」の2つなら、日付は当日(JST)になる
DATE_DEFAULTED=false
case ${#POSITIONAL[@]} in
  3) MODE="${POSITIONAL[0]}"; DATE="${POSITIONAL[1]}"; HOST_FILE="${POSITIONAL[2]}" ;;
  4) MODE="${POSITIONAL[0]}"; HOST_FILE="${POSITIONAL[1]}"
     DATE="$(TZ=Asia/Tokyo date +%Y%m%d)"; DATE_DEFAULTED=true ;;
  *) usage ;;
esac

# ---- 入力チェック ----
if [[ "$MODE" != "create" && "$MODE" != "delete" ]]; then
  echo "ERROR: 1つ目の引数は create か delete を指定してください: $MODE" >&2
  exit 1
fi

if ! [[ "$DATE" =~ ^[0-9]{8}$ ]] || ! date -d "$DATE" >/dev/null 2>&1; then
  echo "ERROR: 日付は YYYYMMDD の形式で正しい日付を指定してください: $DATE" >&2
  exit 1
fi

[[ -r "$HOST_FILE" ]] || { echo "ERROR: ホスト一覧ファイルを読み込めません: $HOST_FILE" >&2; exit 1; }

DATE_ISO="$(date -d "$DATE" +%Y-%m-%d)"   # 2026-10-06
DATE_SLASH="$(date -d "$DATE" +%Y/%m/%d)" # 2026/10/06

# 時刻 (HH:MM) を「0時からの分」に変換する
to_min() {
  local h="${1%%:*}" m="${1##*:}"
  echo $((10#$h * 60 + 10#$m))
}

DURATION=""
END_LABEL=""
DUR_MIN=0
PERIOD_TITLE="時間帯(JST)"
PERIOD_LABEL=""
PAST_WARN=false

if [[ "$MODE" == "create" ]]; then
  TIME_RE='^([01][0-9]|2[0-3]):[0-5][0-9]$'
  if ! [[ "$START_TIME" =~ $TIME_RE ]]; then
    echo "ERROR: 時刻は HH:MM (00:00〜23:59) の形式で指定してください: $START_TIME" >&2
    exit 1
  fi

  if $DAYS_SPECIFIED; then
    # ---- 日数指定: 開始時刻から N 日間 ----
    if $END_SPECIFIED; then
      echo "ERROR: --days と --end は同時に指定できません" >&2
      exit 1
    fi
    if $END_DATE_SPECIFIED; then
      echo "ERROR: --days と --end-date は同時に指定できません" >&2
      exit 1
    fi
    if ! [[ "$DAYS" =~ ^[0-9]+$ ]] || [[ $((10#$DAYS)) -lt 1 || $((10#$DAYS)) -gt 15 ]]; then
      echo "ERROR: --days は 1〜15 の整数で指定してください: $DAYS" >&2
      exit 1
    fi
    DAYS=$((10#$DAYS))
    DUR_MIN=$((DAYS * 1440))
    DURATION="P${DAYS}D"
    # 終了日時 = 開始日時 + N日。日本は夏時間がないため、秒数(N×86400)の加算で正確に求まる
    START_EPOCH="$(TZ=Asia/Tokyo date -d "${DATE_ISO} ${START_TIME}" +%s)"
    END_LABEL="$(TZ=Asia/Tokyo date -d "@$((START_EPOCH + DAYS * 86400))" +'%Y/%m/%d %H:%M')"
    PERIOD_TITLE="期間(JST)"
    PERIOD_LABEL="${DATE_SLASH} ${START_TIME}〜${END_LABEL} (${DAYS}日間 / ${DURATION})"
  elif $END_DATE_SPECIFIED; then
    # ---- 終了日指定: 開始日時〜(終了日 + 終了時刻)。最長 15日 ----
    if ! [[ "$END_DATE" =~ ^[0-9]{8}$ ]] || ! date -d "$END_DATE" >/dev/null 2>&1; then
      echo "ERROR: --end-date は YYYYMMDD の形式で正しい日付を指定してください: $END_DATE" >&2
      exit 1
    fi
    if ! [[ "$END_TIME" =~ $TIME_RE ]]; then
      echo "ERROR: 時刻は HH:MM (00:00〜23:59) の形式で指定してください: $END_TIME" >&2
      exit 1
    fi
    END_ISO="$(date -d "$END_DATE" +%Y-%m-%d)"
    END_SLASH="$(date -d "$END_DATE" +%Y/%m/%d)"
    START_EPOCH="$(TZ=Asia/Tokyo date -d "${DATE_ISO} ${START_TIME}" +%s)"
    END_EPOCH="$(TZ=Asia/Tokyo date -d "${END_ISO} ${END_TIME}" +%s)"
    DUR_MIN=$(( (END_EPOCH - START_EPOCH) / 60 ))
    if [[ "$DUR_MIN" -le 0 ]]; then
      echo "ERROR: 終了日時 (${END_SLASH} ${END_TIME}) が開始日時 (${DATE_SLASH} ${START_TIME}) 以前です" >&2
      exit 1
    fi
    if [[ "$DUR_MIN" -gt 21600 ]]; then
      echo "ERROR: 抑止期間は最長 15日です (指定: ${DUR_MIN}分)" >&2
      exit 1
    fi
    DD=$((DUR_MIN / 1440)); DR=$((DUR_MIN % 1440))
    DH=$((DR / 60)); DM=$((DR % 60))
    DURATION="P"
    [[ "$DD" -gt 0 ]] && DURATION+="${DD}D"
    if [[ "$DH" -gt 0 || "$DM" -gt 0 ]]; then
      DURATION+="T"
      [[ "$DH" -gt 0 ]] && DURATION+="${DH}H"
      [[ "$DM" -gt 0 ]] && DURATION+="${DM}M"
    fi
    END_LABEL="${END_SLASH} ${END_TIME}"
    PERIOD_TITLE="期間(JST)"
    PERIOD_LABEL="${DATE_SLASH} ${START_TIME}〜${END_LABEL} (${DD}日${DH}時間${DM}分 / ${DURATION})"
  else
    # ---- 時刻指定: 開始時刻〜終了時刻(最長 23時間59分) ----
    if ! [[ "$END_TIME" =~ $TIME_RE ]]; then
      echo "ERROR: 時刻は HH:MM (00:00〜23:59) の形式で指定してください: $END_TIME" >&2
      exit 1
    fi

    S_MIN="$(to_min "$START_TIME")"
    E_MIN="$(to_min "$END_TIME")"
    if [[ "$S_MIN" -eq "$E_MIN" ]]; then
      echo "ERROR: 開始時刻と終了時刻が同じです: $START_TIME" >&2
      exit 1
    fi

    DUR_MIN=$((E_MIN - S_MIN))
    END_LABEL="$END_TIME"
    if [[ "$DUR_MIN" -lt 0 ]]; then        # 終了が開始より前 → 翌日の終了時刻
      DUR_MIN=$((DUR_MIN + 1440))
      END_LABEL="翌${END_TIME}"
    fi

    DH=$((DUR_MIN / 60))
    DM=$((DUR_MIN % 60))
    DURATION="PT"
    [[ "$DH" -gt 0 ]] && DURATION+="${DH}H"
    [[ "$DM" -gt 0 ]] && DURATION+="${DM}M"
    PERIOD_LABEL="${START_TIME}〜${END_LABEL} (${DUR_MIN}分 / ${DURATION})"
  fi

  START_EPOCH="$(TZ=Asia/Tokyo date -d "${DATE_ISO} ${START_TIME}" +%s)"
  [[ "$START_EPOCH" -le "$(date +%s)" ]] && PAST_WARN=true
elif $TIME_SPECIFIED; then
  echo "WARN: delete では開始/終了時刻・日数の指定は使いません(無視します)" >&2
fi

# ---- ホスト一覧の読み込み ----
HOSTS=()
while IFS= read -r line || [[ -n "$line" ]]; do
  h="$(printf '%s' "$line" | sed 's/\r$//; s/^[[:space:]]*//; s/[[:space:]]*$//')"
  [[ -z "$h" || "$h" == \#* ]] && continue
  HOSTS+=("$h")
done < "$HOST_FILE"

if [[ ${#HOSTS[@]} -eq 0 ]]; then
  echo "ERROR: ホスト一覧ファイルに有効なホスト名がありません: $HOST_FILE" >&2
  exit 1
fi

# rule_name() { echo "cm-msp-mute-rule-temp-$1-${DATE}"; }
rule_name() { echo "mute-rule-temp-$1-${DATE}"; }

# 削除後の確認: 一時抑止ルール(名前に -temp- を含むもの)が残っていないかを一覧で確認する。
# 今回の削除対象がまだ残っていた場合は 1 を返す。
check_remaining() {
  echo
  echo "===== 残存する一時抑止ルールの確認 ====="
  local out remain total arn name still=()
  if ! out="$(aws cloudwatch list-alarm-mute-rules --region ap-northeast-1 \
        --query 'AlarmMuteRuleSummaries[].[AlarmMuteRuleArn,Status,MuteType,ExpireDate]' \
        --output text)"; then
    echo "WARN: ミュートルール一覧の取得に失敗しました。AWS コンソールで確認してください。" >&2
    return 0
  fi

  remain="$(printf '%s\n' "$out" | grep -- '-temp-' || true)"
  if [[ -z "$remain" ]]; then
    echo "一時抑止ルールの残存はありません。"
    return 0
  fi

  total="$(printf '%s\n' "$remain" | wc -l | tr -d ' ')"
  echo "残存している一時抑止ルール: ${total} 件  (ARN / Status / MuteType / ExpireDate)"
  printf '%s\n' "$remain" | sed 's/^/  /'

  # 今回の削除対象(ルール名)が残っていないかを照合する
  for HOST in "${valid_hosts[@]}"; do
    name="$(rule_name "$HOST")"
    while IFS= read -r arn; do
      arn="${arn%%[[:space:]]*}"
      if [[ "$arn" == *"$name" ]]; then
        still+=("$name")
        break
      fi
    done <<< "$remain"
  done

  if [[ ${#still[@]} -gt 0 ]]; then
    echo
    echo "WARN: 今回の削除対象のうち ${#still[@]} 件がまだ残っています:" >&2
    printf '  - %s\n' "${still[@]}" >&2
    return 1
  fi
  echo
  echo "(上記は今回の削除対象ではない一時抑止ルールです。日付やホストが別のものが残っていないか確認してください)"
  return 0
}

TMP_DIR="$(mktemp -d)"
trap 'rm -rf "$TMP_DIR"' EXIT

valid_hosts=()
failed=()

# ============================================================
# 準備: 対象の確認(ここまでは AWS 上の何も変更しない)
# ============================================================
if [[ "$MODE" == "create" ]]; then
  # 全アラーム名を最初に1回だけ取得(ホストごとの絞り込みは jq でローカル実行)
  ALL_ALARMS="${TMP_DIR}/all-alarms.json"
  echo "全アラーム名を取得しています..."
  if ! aws cloudwatch describe-alarms \
        --query "MetricAlarms[].AlarmName" \
        --output json > "$ALL_ALARMS"; then
    echo "ERROR: アラーム一覧の取得に失敗しました" >&2
    exit 1
  fi
  echo "取得したアラーム数: $(jq 'length' "$ALL_ALARMS")"
  echo
fi

echo "--- 対象の確認 (${#HOSTS[@]} ホスト) ---"
for HOST in "${HOSTS[@]}"; do
  if [[ "$MODE" == "create" ]]; then
    TARGETS="${TMP_DIR}/targets-${HOST}.json"
    if ! jq -c --arg h "$HOST" \
          'map(select(contains("-" + $h + "-") or endswith("-" + $h)))' \
          "$ALL_ALARMS" > "$TARGETS"; then
      echo "  ERROR: ${HOST}: アラームの絞り込みに失敗しました" >&2
      failed+=("$HOST")
      continue
    fi
    COUNT="$(jq 'length' "$TARGETS")"
    if [[ "$COUNT" -eq 0 ]]; then
      echo "  WARN : ${HOST}: 対象アラームが0件のためスキップします" >&2
      failed+=("$HOST (対象アラーム0件)")
      continue
    fi
    echo "  ${HOST}: 対象アラーム ${COUNT} 件"
    $DRY_RUN && echo "    targets=$(jq -c '.' "$TARGETS")"
  else
    echo "  ${HOST}: $(rule_name "$HOST")"
  fi
  valid_hosts+=("$HOST")
done
echo

if [[ ${#valid_hosts[@]} -eq 0 ]]; then
  echo "ERROR: 処理対象のホストがありません" >&2
  exit 1
fi

# ============================================================
# 確認画面
# ============================================================
if [[ "$MODE" == "create" ]]; then
  ACTION_LABEL="作成"
else
  ACTION_LABEL="削除"
fi

echo "==================== 実行内容の確認 ===================="
echo "操作        : ミュートルールの【${ACTION_LABEL}】"
echo "対象日      : ${DATE_SLASH}$($DATE_DEFAULTED && echo ' (日付の指定なし → 当日)')"
if [[ "$MODE" == "create" ]]; then
  echo "${PERIOD_TITLE} : ${PERIOD_LABEL}"
fi
echo "対象ホスト  : ${#valid_hosts[@]} 件 (スキップ/エラー ${#failed[@]} 件)"
echo "ルール名の例: $(rule_name "${valid_hosts[0]}")"
echo "========================================================"
if [[ "$MODE" == "create" ]] && $PAST_WARN; then
  echo "WARN: 開始日時 (${DATE_SLASH} ${START_TIME}) はすでに過去です。抑止されない可能性があります。" >&2
fi
if [[ "$MODE" == "delete" ]]; then
  echo "注意: 削除すると、ミュート中のアラームは直ちにミュート解除されます。"
  echo "      ALARM 状態のアラームは、設定済みのアクション(通知など)が実行されます。"
fi

if $DRY_RUN; then
  echo
  echo "[DRY-RUN] 実際の${ACTION_LABEL}は行いません。"
  echo "===== 結果 (dry-run) ====="
  echo "${ACTION_LABEL}対象: ${#valid_hosts[@]} 件"
  echo "失敗/スキップ: ${#failed[@]} 件"
  if [[ ${#failed[@]} -gt 0 ]]; then
    printf '  - %s\n' "${failed[@]}"
    exit 1
  fi
  exit 0
fi

if ! $ASSUME_YES; then
  echo
  printf '%s件のミュートルールを【%s】します。よろしいですか? [y/N]: ' "${#valid_hosts[@]}" "$ACTION_LABEL"
  ans=""
  read -r ans || true
  case "$ans" in
    y|Y|yes|YES) ;;
    *) echo "中止しました。何も${ACTION_LABEL}していません。"; exit 0 ;;
  esac
fi
echo

# ============================================================
# 実行
# ============================================================
success=()
for HOST in "${valid_hosts[@]}"; do
  RULE_NAME="$(rule_name "$HOST")"
  echo "=== ${HOST} ==="

  if [[ "$MODE" == "create" ]]; then
    TARGETS="${TMP_DIR}/targets-${HOST}.json"
    DESCRIPTION="一時抑止 ${DATE_SLASH} ${START_TIME}〜${END_LABEL}"
    RULE_JSON="{\"Schedule\":{\"Expression\":\"at(${DATE_ISO}T${START_TIME})\",\"Duration\":\"${DURATION}\",\"Timezone\":\"Asia/Tokyo\"}}"
    MUTE_TARGETS="$(jq -c '{AlarmNames: .}' "$TARGETS")"

    if aws cloudwatch put-alarm-mute-rule \
          --name "$RULE_NAME" \
          --description "$DESCRIPTION" \
          --rule "$RULE_JSON" \
          --mute-targets "$MUTE_TARGETS" \
          --tags Key=CmMspManaged,Value=True \
                 Key=CmBillingGroup,Value=ClassmethodManagedService \
                 Key=aws-apn-id,Value=pc:esmao2dmxldtaklxhevh1g4o1; then
      echo "  OK: 作成 ${RULE_NAME}"
      success+=("$HOST")
    else
      echo "  ERROR: ミュートルールの作成に失敗しました" >&2
      failed+=("$HOST")
    fi
  else
    if aws cloudwatch delete-alarm-mute-rule --alarm-mute-rule-name "$RULE_NAME"; then
      echo "  OK: 削除 ${RULE_NAME}"
      success+=("$HOST")
    else
      echo "  ERROR: ミュートルールの削除に失敗しました" >&2
      failed+=("$HOST")
    fi
  fi
done

echo
echo "===== 結果 ====="
echo "成功: ${#success[@]} 件"
echo "失敗/スキップ: ${#failed[@]} 件"
if [[ ${#failed[@]} -gt 0 ]]; then
  printf '  - %s\n' "${failed[@]}"
fi

# 削除のときは、最後に一時抑止ルールの残存を確認する
RC=0
if [[ "$MODE" == "delete" ]]; then
  check_remaining || RC=1
fi

if [[ ${#failed[@]} -gt 0 ]]; then
  RC=1
fi
exit "$RC"

スクリプトの概要

スクリプトは create と delete の 2 つの操作を持ちます。

操作 内容
create ホストごとに、対象アラームをまとめたミュートルールを 1 つ作る
delete 作成時と同じ名前のミュートルールを削除する

主な特長は次のとおりです。

  • ホスト名の一覧ファイルと日付を渡すだけで、全ホスト分を一括処理できる
  • 実行前に確認画面を表示し、y と答えるまで何も実行しない
  • --dry-run で、AWS 上に何も作らずに対象アラームや期間を確認できる
  • 抑止期間を、時刻・日数・終了日のいずれかで指定できる
  • 削除後に、一時抑止ルールが残っていないかを自動で確認する

詳細な使い方

ホスト一覧ファイル

1 行に 1 ホスト名を書きます。空行と # で始まる行は無視されます。

web01
web02
# この行はコメントです
db01

基本の書式

./create-mute-rules.sh <create|delete> [日付 YYYYMMDD] <ホスト一覧ファイル> [オプション]

日付は抑止を始める日です。省略すると、実行した日 (JST) になります。

オプション 内容 既定値
-s HH:MM 抑止開始時刻 (JST) 00:00
-e HH:MM 抑止終了時刻 (JST) 23:59
-E YYYYMMDD 抑止終了日 (最長 15 日) 指定なし
-d N 開始から N 日間 (1〜15) 指定なし
-y 確認をスキップ 確認する
-n 何も作成・削除せず内容だけ確認 本番実行

-d は -e / -E と同時に指定できません。終了時刻が開始時刻より前の場合は、翌日のその時刻までとして扱います。

実行の流れ

まず --dry-run で内容を確認します。

./create-mute-rules.sh create YYYYMMDD hosts.txt --dry-run

問題がなければ、--dry-run を外して本番実行します。

./create-mute-rules.sh create YYYYMMDD hosts.txt

期間を変えたい場合の例です。

# 22:00 から翌 02:00 まで
./create-mute-rules.sh create YYYYMMDD hosts.txt -s 22:00 -e 02:00

# 開始日の 0:00 から 7日間
./create-mute-rules.sh create YYYYMMDD hosts.txt -s 00:00 --days 7

# 開始日の 0:00 から終了日の 23:55 まで
./create-mute-rules.sh create 開始日 hosts.txt -E 終了日 -e 23:55

作業が終わったら、作成時と同じ日付とホスト一覧で削除します。

./create-mute-rules.sh delete YYYYMMDD hosts.txt

仕組み

対象アラームをホスト名から絞り込む

アラーム名の中に -<ホスト名>- を含むものと、-<ホスト名> で終わるものを、そのホストの対象にします。

jq -c --arg h "$HOST" \
  'map(select(contains("-" + $h + "-") or endswith("-" + $h)))' \
  "$ALL_ALARMS"

ホスト名の前後を - で区切って判定しているので、web01 を指定しても web011 のアラームは拾いません。

この絞り込みは、アラーム名が <任意の文字>-<ホスト名>-<任意の文字> という命名規則であることが前提です。名前の先頭がホスト名のものや、区切りが - 以外のものは対象になりません。自分の環境のアラーム名に合っているか、--dry-run で必ず確認してください。

なお、対象にするのは通常のメトリクスアラームだけです。複合アラーム (Composite Alarm) は対象外です。

アラーム一覧は最初に 1 回だけ取得する

ホストが多いと、ホストごとに AWS へアラーム一覧を問い合わせる方式では、API の呼び出しが増えます。そこで、実行の最初に全アラーム名を 1 回だけ取得し、ホストごとの絞り込みは手元の jq で行っています。

aws cloudwatch describe-alarms \
  --query "MetricAlarms[].AlarmName" \
  --output json > "$ALL_ALARMS"

--dry-run でも AWS への問い合わせは、この一覧取得の 1 回だけです。

抑止期間の計算

抑止時間は、指定された開始・終了 (または日数) から自動で計算します。AWS に渡す形式は ISO 8601 の期間表記です。

指定 抑止時間
指定なし (00:00〜23:59) PT23H59M
-s 22:00 -e 02:00 PT4H
-d 7 P7D

開始日時と終了日時を別々に指定するのではなく、片方から計算するようにしたので、「説明文の終了時刻と実際の抑止時間がずれる」ミスを防げます。

ミュートルールの作成

作成は、スケジュールと対象アラームを JSON で渡します。

aws cloudwatch put-alarm-mute-rule \
  --name "$RULE_NAME" \
  --description "$DESCRIPTION" \
  --rule '{"Schedule":{"Expression":"at(2026-10-06T00:00)","Duration":"PT23H59M","Timezone":"Asia/Tokyo"}}' \
  --mute-targets '{"AlarmNames":["web01-cpu","web01-disk"]}'

ルール名は mute-rule-temp-<ホスト名>-<日付> のように、ホスト名と日付から組み立てます。作成と削除で同じ関数を使うため、名前が食い違う心配がありません。

削除と残存確認

削除は、ルール名を指定して delete-alarm-mute-rule を実行します。削除が終わると、list-alarm-mute-rules で一時抑止ルールが残っていないかを一覧で確認します。

注意点

  • 必ず --dry-run で事前確認してください。 本番実行すると、ミュートルールが実際に作成・削除されます。
  • 存在しないルール名を指定して削除しても、エラーにならずに成功と表示される場合があります。 日付やホスト名を間違えても、削除時のエラーでは気づけません。最後の残存確認の一覧で、消したいルールが残っていないかを確認してください。
  • 1 つのルールで抑止できる期間は最長 15 日です。それより長い期間は、分けて作成する必要があります。
  • 抑止期間が終わった時点でアラームが ALARM 状態のままだと、期間終了後にアクションが実行される可能性があります。
  • describe-alarms で取得した一覧は、実行開始時点の状態です。実行中に増減したアラームは反映されません。

参考リンク

おわりに

ホスト一覧と日付を渡すだけで、複数ホストのミュートルールをまとめて作成・削除できるようにしました。メンテナンス前に --dry-run で対象を確認できるので、「どのアラームが止まるか分からない」という不安も減らせます。

アラーム名の命名規則が異なる環境では、絞り込みの条件を調整する必要があります。今回のスクリプトを参考に、自分の環境に合わせて改造してみてください。この記事が運用の助けになれば幸いです。

この記事をシェアする

AWSのお困り事はクラスメソッドへ

関連記事