Archiving Amazon EventBridge events

When you create an archive in EventBridge, you can determine which events are sent to the archive by specifying an event pattern. EventBridge sends events that match the event pattern to the archive. You also set the retention period to store events in the archive before they are discarded.

By default, EventBridge encrypts event data in an archive using 256-bit Advanced Encryption Standard (AES-256) under an AWS owned CMK, which helps secure your data from unauthorized access.

Note

The EventCount and SizeBytes values of the DescribeArchive operation have a reconciliation period of 24 hours. Therefore, any recently-expired or newly-archived events may not be immediately reflected in these values.

To create an archive

1. Open the Amazon EventBridge console at https://console.aws.amazon.com/events/.

2. In the left navigation pane, choose Archives.

3. Choose Create archive.

4. Under Archive detail, enter a Name for the archive. The name must be unique to your account in the selected Region.

   You can't change the name after you create the archive.

5. (Optional) Enter a Description for the archive.

6. For Source, select the event bus that emits the events to send to the archive.

7. For Retention period, do one of the following:

   • Choose Indefinite to retain the events in the archive and not ever delete them.

   • Enter the number of days to retain the events. After the number of days specified, EventBridge deletes the events from the archive.

8. Choose Next.

9. For Event pattern, do one of the following:

   • To archive all events, choose No event filtering.

   • To archive specific events, specify an event pattern:

     1. Choose Filtering events by event pattern matching

     2. Do one of the following:

        • Select Pattern builder, then choose the Service provider. If you choose AWS, also select the AWS service name and Event type to use in the pattern.

        • Select JSON editor to create a pattern manually. You can also copy the pattern from a rule and then paste it into the JSON editor.

10. Choose Create archive.

To confirm that events are successfully sent to the archive, you can use the DescribeArchive operation of the EventBridge API to see if the EventCount reflects the number of events in the archive. If it is 0, there are no events in the archive.