Try it now and let us know what you think. Switch to the new look >>
You can return to the original look by selecting English in the language selector above.
Viewing CloudTrail Events in the CloudTrail Console
You can use the CloudTrail console to view the last 90 days of recorded API activity and events in an AWS Region. You can also download a file with that information, or a subset of information based on the filter and time range you choose. You can customize your view of Event history by selecting which columns are displayed in the console. You can also look up and filter events by the resource types available for a particular service.
CloudTrail logging varies between AWS services. While most AWS services support CloudTrail logging of all events, some services only support logging a subset of APIs and events, and a few services are unsupported. You can learn more about the specifics of how CloudTrail logs events for a specific service by consulting the documentation for that service. For more information, see CloudTrail Supported Services and Integrations.
Note
For an ongoing record of activity and events, create a trail. Creating a trail also enables you to take advantage of the following integrations:
-
Analyze your AWS service activity with queries in Amazon Athena. For more information, see Creating a Table for CloudTrail Logs in the CloudTrail Console in the Amazon Athena User Guide, or simply choose the option to create a table directly from Event history in the CloudTrail console.
-
Monitor your trail logs and be notified when specific activity occurs with Amazon CloudWatch Logs. For more information, see Monitoring CloudTrail Log Files with Amazon CloudWatch Logs.
To view CloudTrail events
-
Sign in to the AWS Management Console and open the CloudTrail console at https://console.aws.amazon.com/cloudtrail/home/.
-
In the navigation pane, choose Event history.
A filtered list of events appears in the content pane with the latest event first. Scroll down to see more events.
The default view of events in Event history has a filter applied so that it does not display read-only events. To remove this filter, or to apply other filters, change the filter settings. For more information, see Filtering CloudTrail Events.
Contents
Displaying CloudTrail Events
You can customize the display of Event history by selecting which columns to display in the CloudTrail console. By default, the following columns are displayed:
-
Event time
-
User name
-
Event name
-
Resource type
-
Resource name
You cannot change the order of the columns.
To customize the columns displayed in Event history
-
Sign in to the AWS Management Console and open the CloudTrail console at https://console.aws.amazon.com/cloudtrail/home/.
-
In the navigation pane, choose Event history.
-
Choose the gear icon.
-
In Show/Hide Columns, select the columns you want to display. Clear the columns you do not want to display. When you have finished, choose Save.
Filtering CloudTrail Events
The default display of events in Event history uses an attribute filter to exclude read-only events from the list of displayed events. This attribute filter is named Read only, and it is set to false. You can remove this filter to display both read and write events. If you want to view only the read events, you can change the filter value to true. You can also filter events by other attributes. You can additionally filter by time range.
Note
You can only apply one attribute filter and a time range filter. You cannot apply multiple attribute filters.
- AWS access key
-
The AWS access key ID that was used to sign the request. If the request was made with temporary security credentials, this is the access key ID of the temporary credentials.
- Event ID
-
The CloudTrail ID of the event. Each event has a unique ID.
- Event name
-
The name of the event. For example, you can filter on IAM events, such as
CreatePolicy, or Amazon EC2 events, such asRunInstances. - Event source
-
The AWS service to which the request was made, such as
iam.amazonaws.comors3.amazonaws.com. You can scroll through a list of event sources after you choose the Event source filter. - Read only
-
The read type of the event. Events are categorized as read events or write events. If set to false, read events are not included in the list of displayed events. By default, this attribute filter is applied and the value is set to false.
- Resource name
-
The name or ID of the resource referenced by the event. For example, the resource name might be "auto-scaling-test-group" for an Auto Scaling group or "i-1234567" for an EC2 instance.
- Resource type
-
The type of resource referenced by the event. For example, a resource type can be
Instancefor EC2 orDBInstancefor RDS. Resource types vary for each AWS service. - Time range
-
The time range in which you want to filter events. You can filter events for the last 90 days.
- User name
-
The identity of the user referenced by the event. For example, this can be an IAM user, an IAM role name, or a service role.
If there are no events logged for the attribute or time that you choose, the results list is empty. You can apply only one attribute filter in addition to the time range. If you choose a different attribute filter, your specified time range is preserved.
The following steps describe how to filter by attribute.
To filter by attribute
-
To filter the results by an attribute, choose Select attribute, and then type or choose a value in the Enter lookup value box.
-
To remove an attribute filter, choose the X on the right of the attribute filter box.
The following steps describe how to filter by a start and end date and time.
To filter by a start and end date and time
-
To narrow the time range for the events that you want to see, choose Select time range.
-
To remove a time range filter, choose the calendar icon on the right of the Time range box, and then choose Remove.
Viewing Details for an Event
-
Choose an event in the results list to show its details.
-
If the event referenced more than one resource, the additional resources are listed at the bottom of the details pane.
-
Some referenced resources have links. Choose the link to open the console for that resource.
-
Choose View Event in the details pane to view the event in JSON format.
-
Choose the event again to close the details pane.
Downloading Events
You can download recorded event history as a file in CSV or JSON format. Use filters and time ranges to reduce the size of the file you download.
Note
CloudTrail event history files are data files that contain information (such as resource names) that can be configured by individual users. Some data can potentially be interpreted as commands in programs used to read and analyze this data (CSV injection). For example, when CloudTrail events are exported to CSV and imported to a spreadsheet program, that program might warn you about security concerns. You should choose to disable this content to keep your system secure. Always disable links or macros from downloaded event history files.
-
Specify the filter and time range for events you want to download. For example, you can specify the event name,
StartInstances, and specify a time range for the last three days of activity. -
Choose the
and then choose Export to CSV or
Export to JSON. The download starts immediately.
Note
Your download might take some time to complete. For faster results, before you start the download process, use a more specific filter or a shorter time range to narrow the results.
-
After your download is complete, open the file to view the events that you specified.
-
To cancel your download, choose Cancel download.
Viewing Resources Referenced with AWS Config
AWS Config records configuration details, relationships, and changes to your AWS resources.
On the Resources Referenced pane, choose the
in the Config timeline column to view the
resource in the AWS Config console.
If the
icon is gray, AWS Config is not turned on, or it's not recording the
resource type. Choose the icon to go to the AWS Config console to turn on the service
or start
recording that resource type. For more information, see Set Up AWS Config Using the Console in the
AWS Config Developer Guide.
If Link not available appears in the column, the resource can't be viewed for one of the following reasons:
-
AWS Config doesn't support the resource type. For more information, see Supported Resources, Configuration Items, and Relationships in the AWS Config Developer Guide.
-
AWS Config recently added support for the resource type, but it's not yet available from the CloudTrail console. You can look up the resource in the AWS Config console to see the timeline for the resource.
-
The resource is owned by another AWS account.
-
The resource is owned by another AWS service, such as a managed IAM policy.
-
The resource was created and then deleted immediately.
-
The resource was recently created or updated.
Example
-
You configure AWS Config to record IAM resources.
-
You create an IAM user, Bob-user. The Event history page shows the
CreateUserevent and Bob-user as an IAM resource. You can choose the AWS Config icon to view this IAM resource in the AWS Config timeline. -
You update the user name to Bob-admin.
-
The Event history page shows the
UpdateUserevent and Bob-admin as the updated IAM resource. -
You can choose the icon to view the Bob-admin IAM resource in the timeline. However, you can't choose the icon for Bob-user, because the resource name changed. AWS Config is now recording the updated resource.
To grant users read-only permission to view resources in the AWS Config console, see Granting Permission to View AWS Config Information on the CloudTrail Console.
For more information about AWS Config, see the AWS Config Developer Guide.


