Using Internet Monitor with Amazon EventBridge

Health events that Internet Monitor creates for networking issues are published with Amazon EventBridge, so that you can send notifications about a degradation in end users' experience for your application. Both overall (global) health events and local health events are published to EventBridge. Global health events have an impact type of AVAILABILITY or PERFORMANCE, and local health events have an impact type of LOCAL_AVAILABILITY or LOCAL_PERFORMANCE.

To use EventBridge to work with Internet Monitor health events, follow the guidance here.

To set up a rule for Internet Monitor in EventBridge

1. In the AWS Management Console, in EventBridge, choose Rules, then enter a name and a description. Create the rule on the Default event bus.

2. In Step 2, select Other for the event source, and then, under Event pattern, match the following source.

   {
     "source": ["aws.internetmonitor"]
   }

3. In Step 3, for the target, select AWS Service and CloudWatch Logs Group, then select an existing log group or create a new one.

4. Add any desired tags, and then create the rule. This should populate your selected CloudWatch Logs Group with events from EventBridge.

Filtering health events by impact type

You can use event patterns to filter health events by impact type. This is useful if you want to receive only global health events, only local health events, or both.

Receive only global health events:

{
  "source": ["aws.internetmonitor"],
  "detail": {
    "impactType": ["AVAILABILITY", "PERFORMANCE"]
  }
}

Receive only local health events:

{
  "source": ["aws.internetmonitor"],
  "detail": {
    "impactType": ["LOCAL_AVAILABILITY", "LOCAL_PERFORMANCE"]
  }
}

Receive all health events (default):

{
  "source": ["aws.internetmonitor"]
}

For more information about how EventBridge rules work with event patterns, see Amazon EventBridge event patterns in the Amazon EventBridge User Guide.