The feature helps identify heavily accessed and throttled keys that can create uneven traffic distribution, partition hotspots, and throughput bottlenecks.
For engineers diagnosing DynamoDB performance problems, it is often the fastest way to identify the exact keys responsible.
But Contributor Insights is not free.
Many teams enable it during a production incident and later discover recurring CloudWatch charges without fully understanding how billing works. Pricing depends on the number of rules DynamoDB creates, the number of matched events processed, the monitoring mode selected, and the table schema.
This guide explains exactly how DynamoDB Contributor Insights pricing works, how AWS counts billable events, and how Contributor Insights fits into broader DynamoDB cost optimization.
The Short Answer
In US East (N. Virginia), Contributor Insights includes:- One Contributor Insights rule per month at no charge
- One million matched events per month at no charge
- Additional rules cost $0.50 per rule-month
- Additional matched events cost $0.02 per million matched events
Your total bill depends on:
- Which Contributor Insights mode you use
- How many rules DynamoDB creates
- Whether tables or indexes include sort keys
- The number of matched events generated
- Whether throttling occurs
What Is DynamoDB Contributor Insights?
AWS describes Contributor Insights for DynamoDB as a diagnostic tool that helps identify:- Most accessed items
- Most throttled items
- Hot partitions
- Uneven traffic distribution
- Keys responsible for throughput consumption
AWS states that Contributor Insights is designed to have no performance impact on DynamoDB tables.
Also read: The DynamoDB Gospel: Everything About On-Demand Pricing
How DynamoDB Contributor Insights Billing Works
Contributor Insights pricing has two components.1. Rule Charges
Each Contributor Insights rule incurs a monthly charge after the free allowance.The important detail is that DynamoDB automatically creates rules on your behalf. The number of rules depends on:
- Monitoring mode
- Table schema
- Presence of sort keys
- Whether GSIs are monitored
In reality, a single table can create multiple Contributor Insights rules depending on the selected mode and key structure.
2. Matched Event Charges
AWS also charges for matched events processed by Contributor Insights.For most production workloads, event-processing charges become the primary cost driver because event volume scales with application activity.
How AWS Counts Billable Events
Billing is item-based, not simply request-based.According to the Contributor Insights billing documentation:
- Each item read or written through a supported data-plane operation generates one event.
- If the table or index includes a sort key, each item generates two events because DynamoDB tracks both partition-key and partition-plus-sort-key dimensions.
- A Query operation always generates one event regardless of the number of items returned.
- In throttled-keys mode, only qualifying throttled requests generate events, except that a Query operation always generates one event regardless of mode or the number of items returned.
Batch Operation Example
Assume an application performs:- One GetItem
- One PutItem
- One BatchWriteItem containing five items
- A partition-key-only table generates 7 events.
- A partition-and-sort-key table generates 14 events.
- Only throttled requests generate events.
- If only the PutItem is throttled, the table generates 1 event without a sort key or 2 events with a sort key.
Accessed-and-Throttled Mode vs Throttled-Keys Mode
AWS introduced throttled-keys mode for DynamoDB Contributor Insights to provide a lower-cost monitoring option focused exclusively on throttling events.| Feature | Accessed and Throttled Keys Mode | Throttled Keys Mode |
|---|---|---|
| Tracks successful requests | Yes | No |
| Tracks throttled requests | Yes | Yes |
| Most accessed items reports | Yes | No |
| Most throttled items reports | Yes | Yes |
| Event volume | High | Usually much lower |
| Continuous monitoring cost | Higher | Usually lower |
| Best use case | Traffic analysis and troubleshooting | Always-on throttling visibility |
One exception is the Query operation, which always generates one Contributor Insights event regardless of the selected monitoring mode. As a result, throttled-keys mode can often remain enabled continuously with minimal cost impact.
How Many Rules Does DynamoDB Create?
Rule count depends on the selected monitoring mode and table schema.| Configuration | Rules Created |
|---|---|
| Accessed-and-throttled mode, partition key only | 2 |
| Accessed-and-throttled mode, partition key + sort key | 4 |
| Throttled-keys mode, partition key only | 1 |
| Throttled-keys mode, partition key + sort key | 2 |
- Most accessed partition keys
- Most throttled partition keys
- Most accessed partition-and-sort-key pairs
- Most throttled partition-and-sort-key pairs
Pricing Example 1: Accessed-and-Throttled Mode
Let’s assume the following:- One DynamoDB table
- Partition key only
- No GSIs
- Accessed-and-throttled mode enabled
- 500 million matched events during the month
- No other Contributor Insights rules or matched events in the account
| Component | Cost |
|---|---|
| First rule | Free |
| Second rule | $0.50 |
| First 1 million events | Free |
| Remaining 499 million events | $9.98 |
| Total monthly cost | $10.48 |
Total monthly cost: $9.98 + $0.50 = $10.48/month
For high-volume tables running full monitoring mode, matched-event charges typically represent the majority of Contributor Insights costs.
Pricing Example 2: Throttled-Keys Mode
Let’s assume the following:
- One DynamoDB table
- Partition key only
- No GSIs
- Throttled-keys mode enabled
- 2 million throttled events during the month
- No other Contributor Insights rules or matched events consume the account’s free allowance
For this configuration, DynamoDB creates one throttling rule.
| Component | Cost |
|---|---|
| Rule | Free |
| First 1 million events | Free |
| Remaining 1 million events | $0.02 |
| Total monthly cost | $0.02 |
Successful GetItem and BatchWriteItem operations generate no billable events in this mode, while a Query operation always generates one event regardless of mode.
When Is Contributor Insights Worth the Cost?
Contributor Insights is typically most valuable when diagnosing problems that standard CloudWatch metrics cannot easily explain.Hot Partitions
Contributor Insights helps identify specific partition keys generating disproportionate traffic. This is often the fastest way to confirm a hot-key problem.Capacity Planning
Access-pattern visibility can reveal:- Read concentration
- Write concentration
- Skewed traffic distribution
- Uneven key usage
Throttling Investigations
AWS specifically recommends Contributor Insights as part of the broader DynamoDB throttling diagnosis workflow when investigating partition-level throttling.Also read: DynamoDB Transactions Pricing Explained
Security and Permissions Checklist Before Enabling Contributor Insights
Before enabling Contributor Insights broadly, review the following considerations documented in the Contributor Insights security guidance.| Check | Why It Matters |
|---|---|
| Sensitive partition keys | Frequently accessed key values may appear in reports |
| CloudWatch IAM permissions | Users with CloudWatch access may see key information |
| DAX usage | DAX cache hits are not visible in Contributor Insights |
| PartiQL workloads | Contributor Insights does not support PartiQL requests |
| Compliance requirements | Validate whether key exposure aligns with organizational policy |
Contributor Insights and DynamoDB Commitments
Contributor Insights does not directly reduce DynamoDB costs.Instead, it helps teams understand whether throttling originates from:
- Key-design problems
- Traffic concentration
- Capacity shortages
- Scaling configuration issues
DynamoDB Commitment Options
DynamoDB currently offers two primary commitment mechanisms.| Option | Best For | Maximum Advertised Savings |
|---|---|---|
| Database Savings Plans | Customers seeking flexibility across eligible AWS database services | Up to 18% on eligible on-demand throughput and up to 12% on eligible provisioned throughput |
| Reserved Provisioned Capacity | Stable provisioned-capacity workloads in one Region using the Standard table class | Up to 77% with a three-year commitment |
Before purchasing commitments, it is generally worth determining whether throttling is caused by workload-design issues rather than insufficient capacity.
Also read: AWS Database Savings Plans: The Complete Guide
How Usage.ai Fits
Contributor Insights helps teams identify hot partitions, throttled keys, and uneven access patterns before making long-term cost decisions. Once a DynamoDB workload is properly optimized, organizations can evaluate whether stable AWS usage is a good candidate for commitment-based discounts.At Usage.ai, we continuously analyze AWS usage across your cloud environment to identify commitment opportunities and optimize coverage as workloads evolve.
With Flex Insured Commitments, teams can get the up to 57% savings of a 3-year AWS commitment with none of the commitment.
If a commitment ever costs more than the equivalent On-Demand usage, our Cashback Protection covers the difference, helping organizations maximize savings while retaining flexibility as workloads evolve.
Usage.ai locks in up to 57% savings on your DynamoDB and EC2 spend — with cashback protection if utilization drops. No long-term risk.
Frequently asked questions
Is DynamoDB Contributor Insights free?
Partially. In US East (N. Virginia), AWS includes one Contributor Insights rule and one million matched events each month at no charge. Additional usage is billed according to CloudWatch Contributor Insights pricing.
Why is throttled-keys mode cheaper?
Because, except for Query operations, it generates events only when throttling occurs. Successful GetItem and BatchWriteItem operations do not create billable events in this mode.
Does a table with a sort key cost more to monitor?
Potentially. Tables with sort keys can generate additional Contributor Insights rules and additional events because DynamoDB tracks both partition keys and partition-plus-sort-key pairs.
Does Contributor Insights support PartiQL?
No. AWS documentation states that Contributor Insights does not support PartiQL requests.
Can Database Savings Plans reduce Contributor Insights charges?
No. Contributor Insights charges are CloudWatch monitoring costs. Database Savings Plans and Reserved Provisioned Capacity apply to eligible DynamoDB usage, not Contributor Insights monitoring charges.