Overview
Datadog’s integration with Amazon EventBridge offers the following features:
- Create custom event buses across your integrated AWS accounts
- Send Datadog alert notification events into the event buses of your choice
- Within AWS, set up triggers on your event buses with services like Kinesis, Lambda, and more
- Use the information within the alert event to execute auto-remediation pipelines and runbooks, run analytics queries, etc.
Setup
If you haven’t already, set up the Amazon Web Services integration first.
Installation
- Ensure that the main AWS integration is installed for each AWS account that receives alert notifications.
- Ensure the following exists in the permissions policy for Datadog AWS Role(s):
events:CreateEventBus - The AWS EventBridge integration is automatically installed with the main AWS integration.
Configuration
events:CreateEventBus and events:PutPartnerEvents permissions are required to send alert notifications to your event buses. If you do not have this permission set, see to the Datadog IAM permissions docs to enable permissions prior to further configuration.
- Navigate to the Datadog - Amazon EventBridge integration tile to see a list of AWS accounts integrated in Datadog where you can create Event Bridges.
- Within the AWS account of choice, create a new event bus by providing a name and selecting the region where you want it to exist.
- Within Datadog alerts, use the
@awseventbridge-<MY_EVENT_BUS> syntax to send alert notifications to your event buses. - Within AWS, connect your event buses to targets such as Lambda, Kinesis, and many other services to create event-driven workflows.
Note: Examples of Datadog use cases can be found on Datadog’s partner page in the AWS Console.
- After setting up an event bus in Datadog, navigate to the Amazon EventBridge console and select
Rules in the navigation pane. - Select
Create Rule and add a name and description for your rule. - Under Define Pattern, select
Event Pattern. Select Predefined by service as the event matching pattern. For service provider, select Service partners. For service name, select Datadog. This populates the event buses that are in Datadog. Add any additional information for your rule., then Save the rule. - To disconnect an event bus in Datadog, hover over the event bus of your choice and press the trash icon.
Note: This action disconnects the event bus from AWS, but does not delete the event bus itself within AWS.
Note: EventBridge rules are not imported into Datadog unless the rule is active and has been triggered.
Automated actions
Set up new outbound notification channels for monitors and snapshots from Datadog with the AWS EventBridge integration. With automated actions, you can configure your AWS resources to:
- Restart a process if process ends for live process monitoring
- Prompt EC2 reboots
- Prompt ECS Task (kick off another task when one task ends)
- Apply an Ansible Playbook (make any change on hosts)
- Run remote patches
- Run remote SSH scripts
- Run Windows Updates or install applications
The full list of resources you can target is available on the AWS website.
Find below an example of how to send a snapshot to trigger this process. Once triggered, you can specify the actions receipt in AWS.
Data Collected
Metrics
The Amazon EventBridge integration does not include any metrics.
Events
The Amazon EventBridge integration does not include any events.
Service Checks
The Amazon EventBridge integration does not include any service checks.
Troubleshooting
Need help? Contact Datadog support.
