Repository navigation
[Enhancement]: Support alarm tag propagation in CloudWatch alarm action and event payloads #50590
Description
Description
Amazon CloudWatch now supports including alarm tags in SNS notifications, Lambda invocations, and EventBridge alarm state change events.
Please add support for configuring this feature on CloudWatch alarm resources through the ActionConfiguration.AlarmTagsPropagation API field, including:
- Enabled: Enable or disable tag propagation.
- IncludedTagKeys: Propagate only the specified tag keys.
- ExcludedTagKeys: Propagate all tags except the specified tag keys.
IncludedTagKeys and ExcludedTagKeys are mutually exclusive. When propagation is enabled and neither list is specified, CloudWatch includes all eligible alarm tags.
Affected Resource(s) or Data Source(s)
aws_cloudwatch_metric_alarmaws_cloudwatch_composite_alarm
Potential Terraform Configuration
resource "aws_cloudwatch_metric_alarm" "example" {
alarm_name = "backend-errors"
alarm_description = "Backend error count exceeded the threshold."
namespace = "Application"
metric_name = "ErrorCount"
comparison_operator = "GreaterThanOrEqualToThreshold"
evaluation_periods = 1
period = 300
statistic = "Sum"
threshold = 1
treat_missing_data = "notBreaching"
alarm_actions = [aws_sns_topic.alerts.arn]
tags = {
Environment = "production"
Service = "backend"
Team = "platform"
}
action_configuration {
alarm_tags_propagation {
enabled = true
included_tag_keys = ["Environment", "Service", "Team"]
# Alternatively, use excluded_tag_keys instead.
# Omit both lists to propagate all eligible tags.
}
}
}References
AWS announcement:
https://aws.amazon.com/de/about-aws/whats-new/2026/10/amazon-cloudwatch-tags-on-alarm-actions-payload/
CloudWatch user guide, including API configuration and prerequisites:
https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/alarm-tags-in-notifications.html
PutMetricAlarm API:
https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html
PutCompositeAlarm API:
https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutCompositeAlarm.html
Would you like to implement the enhancement?
No
Activity
github-actions commentedon Oct 22, 2026
Community Guidelines
This comment is added to every new Issue to provide quick reference to how the Terraform AWS Provider is maintained. Please review the information below, and thank you for contributing to the community that keeps the provider thriving! 🚀
Voting for Prioritization
Volunteering to Work on This Issue