Comment on page
This guide will walk through connecting Census to an Amazon EventBridge instance as a data destination.
EventBridge is an Event Stream style destination. Census will send changes in the source data as a series of events that can then be consumed by a number of destinations, typically other applications or microservices in your infrastructure.
To connect to EventBridge, Census needs to know the AWS Region your instance is hosted in and the role to use to connect to it. Census uses AWS's recommended Cross-account Role-based Access for authentication.
Creating an IAM Role with the necessary permissions requires a few steps in the AWS Console.
- Open your AWS Console in a separate tab and browse to the IAM service. Click Roles and Create role.
- When creating the role choose AWS Account for Trusted Entity Type and the Another AWS Account radio button.
- Ask your Census account representative for the Census AWS account to use.
- Select the policy
- You can also use any custom policy that includes the
- Save your new role.
When done, click on your role and copy its ARN. Go back to the tab where you're editing the Census EventBridge destination and enter the Role ARN. Click Connect. Confirm the connection test is successful and you're ready to go.
Events in EventBridge are JSON object with a default set of properties, as well as a
detailssub object. You can use Census to set the values of of the default properties, and then add any additional properties you like.
- Sync Key / Event ID - This field is used to identify unique records but is not by default sent to EventBridge. If you'd like to send it, explicitly include it as an additional custom mapping.
- Detail Type - This is functionally the event name, and Detail Types of the same type should have the same Detail structure.
- Source - Identifies the source that generated the event
- Event Bus Name - The target event bus name. If you're using a global endpoint with a custom bus, you must enter the name, not the ARN, of the event bus.
Optional System Fields
- Resources (Array) - Amazon Web Services resources, identified by Amazon Resource Name (ARN), which the event primarily concerns or is targeted at.
- Time - The timestamp of the event. If no time stamp is # provided, the time stamp of the PutEvents call is used.
- Trace Header (Object) - An X-Ray trace header, which is an http header (X-Amzn-Trace-Id) that contains the trace-id associated with the event
Any other property mappings you include will be included in the Detail nested object. Census will also automatically include an Operation property indicating whether the record change was added, updated, or removed. You may modify the names of the operations Census uses in the advanced configuration.