Skip to main content

Data Events

Data events provide visibility into data plane operations performed on or within AWS resources. Unlike management events that track resource-level changes, data events track the operations performed on the data itself.

What Are Data Events?

Data events (also called data plane events) capture API activity that reads or modifies the data within AWS resources. They answer the question: "Who accessed or modified data in this resource, and when?"

Examples of Data Events

AWS ServiceResource TypeExample API Calls
Amazon S3AWS::S3::ObjectGetObject, PutObject, DeleteObject
AWS LambdaAWS::Lambda::FunctionInvoke
Amazon DynamoDBAWS::DynamoDB::TableGetItem, PutItem, Query, Scan
info

Data events are not enabled by default because they can generate very high volumes of log data. You must explicitly add data event selectors to capture them.

Supported Resource Types

The Prism CloudTrail supports three resource types for data event logging:

Resource TypeDescription
AWS::S3::ObjectOperations on objects in S3 buckets (reads, writes, deletes)
AWS::Lambda::FunctionLambda function invocations
AWS::DynamoDB::TableOperations on items in DynamoDB tables

Configuring Data Event Selectors

Each data event selector defines which resource type and operations to capture.

Adding a Selector

In the Event Configuration step or Edit Trail page:

  1. Click Add Data Event Selector
  2. Choose a Resource Type from the dropdown
  3. Set the Read/Write filter
  4. Optionally specify Resource ARNs to narrow the scope

Selector Fields

FieldRequiredDescription
Resource TypeYesThe AWS resource type to monitor (see table above).
Read/WriteYesWhich operations to capture: All (default), ReadOnly, or WriteOnly.
Resource ARNsNoComma-separated list of specific resource ARNs to monitor. Leave empty to capture events for all resources of the selected type.

Read/Write Filtering

OptionWhat It CapturesExamples
AllBoth read and write data operationsGetObject, PutObject, Invoke, GetItem, PutItem
ReadOnlyOperations that read data without modifying itGetObject, GetItem, Query, Scan
WriteOnlyOperations that create, modify, or delete dataPutObject, DeleteObject, PutItem

Filtering by Resource ARN

You can optionally restrict a data event selector to specific resources by providing their ARNs. This is useful for monitoring only sensitive or critical resources.

Examples:

  • Monitor a specific S3 bucket: arn:aws:s3:::my-sensitive-bucket/
  • Monitor a specific Lambda function: arn:aws:lambda:us-east-1:123456789012:function:my-function
  • Monitor a specific DynamoDB table: arn:aws:dynamodb:us-east-1:123456789012:table/my-table

Enter multiple ARNs as a comma-separated list.

tip

When no ARNs are specified, the selector captures events for all resources of the selected type across all accounts in the trail. Use ARN filters to reduce log volume and focus on resources that require auditing.

Multiple Selectors

You can add multiple data event selectors to a single trail. Each selector operates independently. For example, you might have:

  • One selector for AWS::S3::Object filtered to WriteOnly operations on a specific bucket
  • Another selector for AWS::Lambda::Function capturing All operations
  • A third selector for AWS::DynamoDB::Table capturing ReadOnly operations

To remove a selector, click the remove button on the selector.

Volume and Cost Considerations

warning

Data events can generate extremely high log volumes depending on the resources being monitored. A frequently accessed S3 bucket or a heavily invoked Lambda function can produce millions of events per day. Consider the following strategies to manage volume:

  • Use WriteOnly filtering if you only need change tracking
  • Specify Resource ARNs to limit monitoring to specific resources
  • Start with critical resources and expand coverage gradually

Best Practices

  1. Start small -- Begin by monitoring only your most sensitive or critical resources
  2. Use ARN filters -- Avoid logging all data events for high-traffic resource types like S3
  3. Filter by write operations -- If you only care about data modifications, use WriteOnly to reduce volume
  4. Monitor costs -- Review your CloudTrail billing after enabling data events to ensure costs are within expectations
  5. Combine with management events -- Data events complement management events for a complete audit picture