Manage and optimize usage for Data Cache
Learn how to understand the different charts in the Vercel dashboard, how usage relates to billing, and how to optimize your usage of Data Cache.The Vercel Data Cache that was introduced with the App Router, is still in public beta and not being charged until generally available.
The Data Cache section shows the following charts:
Reads and writes to the data cache are measured in 8 KB units:
- Read unit: One read unit equals 8 KB of data read from the cache
- Write unit: One write unit equals 8 KB of data written to the cache
You are charged based on the volume of data read from and written to the Data Cache, and the regions where reads and writes occur. To optimize Data Cache reads and writes, consider the following strategies.
- For content that rarely changes, set a longer revalidation interval
- This minimizes the frequency of both Data Cache reads and writes
View a time-based revalidation example.
- If you have events that trigger data updates, use on-demand revalidation
- This will help you avoid unnecessary Data Cache reads and writes
View a on-demand revalidation example.
The Data Cache overview chart shows the usage from fetch requests divided by:
- Hits: Percentage of fetch requests to cache that result in a cache hit
- Misses: Percentage of fetch requests to cache that result in a cache miss
- Requests: Number of requests to any unique path
- Bandwidth: Amount of data transferred from any unique path
You get charged based on the amount of data read from your Data Cache and the region(s) in which the reads happen.
When viewing your Data Cache read units chart, you can group by:
- Origin: To see the number of reads from either the Vercel Data Cache, or Incremental Static Regeneration (ISR)
- Projects: To see the number of read units for each project
- Region: To see the number of read units for each region
You get charged based on the amount of Data Cache write units written to your Data Cache and the region(s) in which the writes happen.
When viewing your Data Cache writes chart, you can group by sum of units to see a total of all writes across your team's projects.
- Origin: To see the number of writes to either the Vercel Data Cache, or Incremental Static Regeneration (ISR)
- Projects: To see the number of write units for each project
- Region: To see the number of write units for each region
Consider the following methods to optimize your Data Cache writes:
- Use a higher revalidate value: Selecting a higher
revalidate
value can reduce the number of writes because the data will be marked as stale less frequently, reducing the need for new writes - Use on-demand revalidation: Moving to on-demand revalidation can also help reduce the number of writes. This allows you to manually control when certain data is revalidated, reducing unnecessary writes
The bandwidth chart shows the amount of data the Vercel Data Cache has received and sent for your projects. You can group by:
- Ratio: To see the amount of data transferred and written by the Data Cache
- Projects: To see the amount of data transferred and written for each project, and a percentage of the total
The revalidation chart shows the number of revalidation requests made to the Data Cache. You can group by:
- Ratio: To see the number of revalidation requests made to the Data Cache
- Projects: To see the number of revalidation requests for each project
Was this helpful?