Working with AWS CloudTrail Lake - AWS CloudTrail

Working with AWS CloudTrail Lake

AWS CloudTrail Lake lets you run SQL-based queries on your events. Events are aggregated into event data stores, which are immutable collections of events based on criteria that you select by applying advanced event selectors. You can keep the event data in an event data store for up to seven years, or 2555 days. By default, event data is retained for the maximum period, 2555 days. The selectors that you apply to an event data store control which events persist and are available for you to query. CloudTrail Lake is an auditing solution that can complement your compliance stack, and assist you with near real-time troubleshooting.

CloudTrail Lake queries offer a deeper and more customizable view of events than simple key and value lookups in Event history, or running LookupEvents. An Event history search is limited to a single AWS account, only returns events from a single region, and cannot query multiple attributes. By contrast, CloudTrail Lake users can run complex Standard Query Language (SQL) queries across multiple fields in a CloudTrail event. CloudTrail Lake can aggregate information from your enterprise into a single, searchable event data store, and search across all regions at once. For a full list of supported SQL operators, see CloudTrail Lake SQL constraints.

You can save Lake queries for future use, and view results of queries for up to seven days. CloudTrail Lake can also store events from an organization in AWS Organizations in an event data store, including events from multiple regions and accounts.

Though CloudTrail does not support authorization based on tags for trails, you can control access to actions on event data stores by using authorization based on tags. For more information and examples, see Examples: Denying access to create or delete event data stores based on tags in this guide.

CloudTrail Lake event data stores and queries incur CloudTrail charges. For more information about CloudTrail Lake pricing, see AWS CloudTrail Pricing.


CloudTrail typically delivers logs within an average of about 15 minutes of an API call. This time is not guaranteed.