Logging with AWS CloudTrail for S3 Tables - Amazon Simple Storage Service

Logging with AWS CloudTrail for S3 Tables

Amazon S3 is integrated with AWS CloudTrail, a service that provides a record of actions taken by a user, role, or an AWS service. CloudTrail captures all API calls for Amazon S3 as events. Using the information collected by CloudTrail, you can determine the request that was made to Amazon S3, the IP address from which the request was made, when it was made, and additional details. When a supported event activity occurs in Amazon S3, that activity is recorded in a CloudTrail event. You can use AWS CloudTrail trail to log management events and data events for S3 Tables. For more information, see Amazon S3 CloudTrail events and What is AWS CloudTrail? in the AWS CloudTrailUser Guide.

CloudTrail management events for S3 Tables

Management events provide information about management operations that are performed on resources in your AWS account.

By default, CloudTrail logs management events for S3 Tables. The eventsource for CloudTrail management events for S3 Tables is s3tables.amazonaws.com. When you set up your AWS account, CloudTrail management events are enabled by default. The following API actions are tracked by CloudTrail and logged as management events.

For more information on CloudTrail management events, see Logging management events in the AWS CloudTrail User Guide.

CloudTrail management events for S3 Tables maintenance

S3 logs automatic maintenance operations as TablesMaintenanceEvent management events in CloudTrail. These events occur during operations like compaction and snapshot expiration. For more information about S3 table maintenance, see Maintenance for tables.

How to identify maintenance events

You can identify S3 Tables maintenance events in CloudTrail logs by these attribute values:

  • eventSource: s3tables.amazonaws.com

  • eventType: AwsServiceEvent

  • eventName: TablesMaintenanceEvent

  • userAgent: maintenance.s3tables.amazonaws.com

  • activityType:

    • IcebergCompaction (for compaction)

    • IcebergSnapshotManagement (for snapshot expiration)

For an example of a compaction maintenance event, see Example – CloudTrail log file for a table maintenance management event.

CloudTrail data events for S3 Tables

Data events provide information about the resource operations performed on or in a resource.By default, CloudTrail trails don't log data events, but you can configure trails to log data events.

When you log data events for a trail in CloudTrail, you will choose or specify the resource type. S3 Tables has two resources types, AWS::S3Tables::Table and AWS::S3Tables::TableBucket.

The following data events are logged to CloudTrail.

For more information on CloudTrail data events, see Logging data events in the AWS CloudTrail User Guide.

For additional information about CloudTrail events for S3 Tables, see the following topics: