kakakakakku blog

Weekly Tech Blog: Keep Learning!

Terraform で CloudWatch Alarm「ミュートルール」を設定する

2026年4月15日にリリースされた Terraform AWS Provider v6.41.0 で Amazon CloudWatch Alarm の「ミュートルール (Mute Rules)」を管理するリソース aws_cloudwatch_alarm_mute_rule がサポートされた💡

github.com

最近までは Terraform で「ミュートルール」を設定するためには AWS Cloud Control Provider (awscc) を使う必要があった.awscc の awscc_cloudwatch_alarm_mute_rule に関しては以下の記事にまとめてある.

kakakakakku.hatenablog.com

さっそく試す \( 'ω')/

今回は「1回限り」を試す.他には「定期的なスケジュール」という設定もある🕐️

Amazon CloudWatch Alarm をデプロイする

まずは検証用の Amazon CloudWatch Alarm と Amazon SNS トピックをデプロイする.Amazon CloudWatch Alarm のメトリクスは適当に設定しておく😀

resource "aws_sns_topic" "alarms" {
  name = "sandbox-alarms"
}

resource "aws_sns_topic_subscription" "mail" {
  topic_arn = aws_sns_topic.alarms.arn
  protocol  = "email"
  endpoint  = "y.yoshida22@gmail.com"
}

resource "aws_cloudwatch_metric_alarm" "sandbox" {
  alarm_name          = "sandbox-for-mute"
  comparison_operator = "GreaterThanThreshold"
  evaluation_periods  = 1
  namespace           = "Sandbox"
  metric_name         = "DummyMetric"
  period              = 300
  statistic           = "Sum"
  threshold           = 1
  treat_missing_data  = "notBreaching"
  alarm_actions       = [aws_sns_topic.alarms.arn]
  ok_actions          = [aws_sns_topic.alarms.arn]
}

Amazon CloudWatch Alarm を発火させる

デプロイした Amazon CloudWatch Alarm の動作確認をするために aws cloudwatch set-alarm-state コマンドを使って一時的に ALARM に変更してアラートを発火する🔥

docs.aws.amazon.com

$ aws cloudwatch set-alarm-state \
  --alarm-name sandbox-for-mute \
  --state-value ALARM \
  --state-reason 'Testing alarm action without mute'

すると ALARM: "sandbox-for-mute" in Asia Pacific (Tokyo) というメールが届いた📩

Terraform AWS Provider でミュートルールをデプロイする

Terraform AWS Provider の aws_cloudwatch_alarm_mute_rule リソースを使ってミュートルールをデプロイする.schedule で開始時刻と期間を指定できる.今回は検証として 9:15 - 9:30 の時間帯でアラートを抑制する🕐️ 実装イメージとしては AWS Cloud Control Provider (awscc) の awscc_cloudwatch_alarm_mute_rule とほとんど同じかなという印象 \( 'ω')/

resource "aws_cloudwatch_alarm_mute_rule" "maintenance" {
  name        = "maintenance"
  description = "Maintenance schedule for mute"

  rule {
    schedule {
      expression = "at(2026-04-17T09:15)"
      duration   = "PT15M"
      timezone   = "Asia/Tokyo"
    }
  }

  mute_targets {
    alarm_names = [aws_cloudwatch_metric_alarm.sandbox.alarm_name]
  }
}

期待通りにミュートルールをデプロイできた👌

もう一度 Amazon CloudWatch Alarm を発火させる

今度は設定した時間帯でアラートを発火する🔥

$ aws cloudwatch set-alarm-state \
  --alarm-name sandbox-for-mute \
  --state-value ALARM \
  --state-reason 'Testing alarm action with mute'

すると今度はメールは届かず,マネジメントコンソールでも「アラーム状態」と「ミュート時間帯」が重なるようになっていた.

ちなみに「アクション履歴」を見たら以下のようなメッセージが出ていた💡

Successfully muted the alarm action arn:aws:sns:ap-northeast-1:000000000000:sandbox-alarms with the one-time alarm mute arn:aws:cloudwatch:ap-northeast-1:000000000000:alarm-mute-rule:maintenance.

X ポスト

関連記事

kakakakakku.hatenablog.com