Cache Page

Learn more about Sentry's Cache page where you can get an overview of your cache performance and catch potential cache performance issues.

The Caches page gives an overview of cache performance across all endpoints for currently selected backend projects with summary graphs for Miss Rate and Requests Per Minute (throughput). You can use these as a starting point to see if there are any potential cache performance issues, for example, a higher than expected Miss Rate percentage.

If you see an anomaly or want to investigate a time range further, click and drag to select a range directly in the graph and you'll see data for that specific time range only.

The transaction table shows a list of endpoints that contain at least one cache.get span along with:

  • Its average value size (the bytes being fetched from cache)
  • Throughput
  • Average transaction duration
  • Miss rate percentage (how often did a lookup from cache fail)
  • Time spent (total time your application spent on a given transaction)

By default, this table is sorted by most time spent. This means that endpoints at the top are usually really slow, requested very frequently, or both. You can change the sort order to view top transactions by throughput, miss rate percentage, average value size, or average transaction duration.

To investigate a specific endpoint, click on it to open a sidebar showing some sample events and additional duration metrics.

To be able to compare the performances of cache hits (found a value in the cache) versus misses (failed to find a value in the cache corresponding to the key) over time, Sentry automatically looks for samples of both for the timeframe selected from the Caches page.

These sample events are shown as triangles in the average duration graphs above. If you click on a transaction, you'll be able to view this list of samples. The table shows a sample list of spans, their key, transaction duration, and whether or not all cache lookups within the transaction either hit or missed.

From the sample list, you can drill down to specific good, average, or bad examples of cache performance within an endpoint. To view the detailed trace that contained the span operation, click on a Span ID.

Help improve this content
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) or suggesting an update ("yeah, this would be better").