AWS Security ChangesHomeSearch

AWS wellarchitected documentation change

Service: wellarchitected · 2025-05-19 · Documentation low

File: wellarchitected/2025-02-25/framework/ops_event_response_process_per_alert.md

Summary

Updated AWS Health integration guidance with expanded notification configuration details, ITSM tool integration examples, and organizational aggregation instructions

Security assessment

Changes focus on improving operational incident response processes and monitoring integration capabilities. While AWS Health events may include security-related incidents, the documentation updates are general operational improvements rather than addressing specific security vulnerabilities or introducing new security features.

Diff

diff --git a/wellarchitected/2025-02-25/framework/ops_event_response_process_per_alert.md b/wellarchitected/2025-02-25/framework/ops_event_response_process_per_alert.md
index 2fc0822ae..4bf9d0138 100644
--- a//wellarchitected/2025-02-25/framework/ops_event_response_process_per_alert.md
+++ b//wellarchitected/2025-02-25/framework/ops_event_response_process_per_alert.md
@@ -55 +55 @@ The following diagram illustrates the incident management workflow within [AWS S
-  2. **Monitor[AWS Health events with Amazon EventBridge rules](https://docs.aws.amazon.com/health/latest/ug/cloudwatch-events-health.html):** Monitor or integrate programatically with the AWS Health API to automate actions when you receive AWS Health events. These can be general actions, such as sending all planned lifecycle event messages to a chat interface, or specific actions, such as the initiation of a workflow in an IT service management tool. 
+  2. **Stay informed with[AWS Health](https://docs.aws.amazon.com/health/latest/ug/what-is-aws-health.html):** AWS Health is the authoritative source of information about the health of your AWS Cloud resources. Use AWS Health to visualize and get notified of any current service events and upcoming changes, such as planned lifecycle events, so you can take steps to mitigate impacts. 
@@ -57 +57,5 @@ The following diagram illustrates the incident management workflow within [AWS S
-    1. [ Configure AWS User Notifications for AWS Health](https://docs.aws.amazon.com/health/latest/ug/user-notifications.html)
+    1. [Create purpose-fit AWS Health event notifications](https://docs.aws.amazon.com/health/latest/ug/user-notifications.html) to e-mail and chat channels through [AWS User Notifications](https://docs.aws.amazon.com/notifications/latest/userguide/what-is-service.html), and integrate programatically with [your monitoring and alerting tools through Amazon EventBridge](https://docs.aws.amazon.com/health/latest/ug/cloudwatch-events-health.html) or the [AWS Health API](https://docs.aws.amazon.com/health/latest/APIReference/Welcome.html). 
+
+    2. Plan and track progress on health events that require action by integrating with change management or ITSM tools (like [Jira](https://docs.aws.amazon.com/smc/latest/ag/cloud-sys-health.html) or [ServiceNow](https://docs.aws.amazon.com/smc/latest/ag/sn-aws-health.html)) that you may already use through Amazon EventBridge or the AWS Health API. 
+
+    3. If you use AWS Organizations, enable [organization view for AWS Health](https://docs.aws.amazon.com/health/latest/ug/aggregate-events.html) to aggregate AWS Health events across accounts.