Archiving Amazon EventBridge events - Amazon EventBridge
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

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 Amazon owned CMK, which helps secure your data from unauthorized access.

Note

Expired events are usually deducted from the EventCount and SizeBytes values of the DescribeArchive operation every 24 hours. Therefore, recently expired events may not be reflected in these values.

To create an archive for all events

  1. Open the Amazon EventBridge console at https://console.amazonaws.cn/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. Under Event pattern, choose No event filtering.

  10. Choose Create archive.

To create an archive with an event pattern

  1. Open the Amazon EventBridge console at https://console.amazonaws.cn/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. Under Event pattern, choose Filtering events by event pattern matching.

  10. Do one of the following:

    • Select Pattern builder, then choose the Service provider. If you choose Amazon, also select the Amazon 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.

  11. 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.