Skip to content

Cache Inspector

Finnegan's Owner edited this page Feb 20, 2026 · 6 revisions

Cache Inspector

The Cache Inspector provides a read-only, point-in-time view of a cache's statistics and entries.

Opening the Inspector

Select a cache definition row in the settings panel and click Inspect.

Cache Inspector showing statistics and entries

Statistics

The top section displays eight statistics:

Statistic Description
Entries Number of key-value pairs currently in the cache
Hit Rate Percentage of lookups served from cache without a database call
Avg Load Average time per database round-trip on a cache miss
Hits Total lookups served from cache (no database call)
Misses Total lookups that required a database call to load the value
Evictions Entries removed due to max size or expiration
Total DB Time Cumulative time spent waiting on database loads (cache misses only)
Est. Without Cache Approximate total time that would have been spent on database calls if every lookup had been a cache miss. Calculated as Avg Load × total lookups. This is a rough estimate — actual database performance may vary under different load conditions

Click the ? button in the top-right corner to display these descriptions in a help dialog.

Cache Statistics Help dialog

Entries Table

Below the statistics, a table shows the cache entries with server-side sorting, filtering, and pagination:

Column Description
Key The cache key
Value The cached value, truncated to 100 characters. Hover over the cell to see the full value in a tooltip
Loaded At Timestamp when the entry was loaded from the database (yyyy-MM-dd HH:mm:ss)
Accesses Number of times this specific entry has been looked up (hits and misses that returned this key)

Sorting

Click any column header to sort by that column. Click again to reverse the sort direction. Sorting is performed server-side across the full cache, not just the visible page.

Filtering

Use the filter bar above the entries table to search for entries:

  • Select a scope from the dropdown: Key, Value, or Both
  • Type your search text and press Enter or click Apply
  • Check Regex to treat the search text as a regular expression

Filtering is case-insensitive and is performed server-side across the full cache. The status bar shows how many entries matched (e.g., "1–1,000 of 3,200 matches (48,321 total)").

Pagination

Results are returned in pages of 1,000 entries. Use the and buttons at the bottom of the dialog to page through results. The status bar shows the current range (e.g., "1,001–2,000 of 10,000 entries").

Entry Detail

Double-click any row to open the Entry Detail dialog, which shows the full key, value, loaded-at timestamp, and access count. The value is displayed in a scrollable, word-wrapping text area. Right-click the value area to toggle word wrap.

Entry Detail dialog showing full key and value

Refreshing the Snapshot

Click Refresh at the bottom of the dialog to reload the statistics and entries from the server. The snapshot is point-in-time — it does not auto-update.

Usage Hint

The bottom of the dialog shows the lookup call for this cache:

$g('cache-name').lookup(key)

This is a non-editable reference showing the exact syntax to use in channel code.


← Managing Caches | Next: Using Caches in Channels →

Clone this wiki locally