-
Notifications
You must be signed in to change notification settings - Fork 2
Cache Inspector
The Cache Inspector provides a read-only, point-in-time view of a cache's statistics and entries.
Select a cache definition row in the settings panel and click Inspect.
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.
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) |
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.
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)").
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").
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.
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.
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.