cache list

March 26, 2020 Contributors

Name

cache list — list all caches along with their associated attributes

Synopsis

cache list [ attribute …]

Description

**Configuration Change. ** This feature is available starting from Momentum 3.0.26.

This command lists caches and related statistics. When specific parameters such as the query rate are passed in, this command displays usage by cache.

20:02:48 /tmp/2025> cache list
 alerting_data
 scpt_root
 core:bounce_classify
 core:pcre
 config:match

 5 caches listed.
20:02:49 /tmp/2025> cache stat core:bounce_classify
Name          : core:bounce_classify
Capacity      : 16384
Entries       : 10238
Utilization   :  62.49%
Query Rate    : 1271 q/s
Loads         : 20476
  Hits        : 1527
  Misses      : 18949
  Pending     : 0
Stores        : 18949
Invalidations : 8711
  Forced      : 0
  Expired     : 0
  Capacity    : 8711
Hit Rate      :   7.46%
Workload (R/W):  51.94%
  Reads       : 20476
  Writes      : 18949
20:03:17 /tmp/2025> cache list entries workload
     10179  80.45% alerting_data
        22  99.97% scpt_root
     10238  51.94% core:bounce_classify
         0   0.00% core:pcre
         0   0.00% config:match

 5 caches listed.
20:03:20 /tmp/2025> cache list query-rate
       501 alerting_data
       792 scpt_root
       379 core:bounce_classify
         0 core:pcre
         0 config:match

 5 caches listed.
20:03:29 /tmp/2025> cache list xxx
Valid attributes are [capacity,entries,utilization,loads,stores,hits,misses,
 forced,expired,lru,hit-rate,workload,query-rate]

The cache list command is useful for determining the cache names to use with the cache stat command.

The optional cache attribute parameters are:

  • capacity

  • entries

  • utilization

  • loads

  • stores

  • hits

  • misses

  • forced

  • expired

  • lru (least recently used)

  • hit-rate

  • workload

  • query-rate

As of version 3.0.26 the optional cache attribute parameters are:

  • all

  • summary

  • capacity

  • entries

  • used

  • loads

  • stores

  • hits

  • misses

  • forced

  • expired

  • lru (least recently used)

  • replaced

  • hitratio

  • workload

  • queryrate

The all parameter shows all attributes. The summary parameter displays the following output:

07:07:00 /tmp/2025> cache list summary
CAPACITY    ENTRIES     USED    HT/TL   RD/WR CACHE
1048576       3507     0.33%   93.72%  57.82% core:named_throttles
1024          1        0.10%   99.75%  99.75% ds_core:ecdb
1024          0        0.00%    0.00%   0.00% ds_core:adaptivedb
16            0        0.00%    0.00%   0.00% 0x2aaabb19f858
16384         312      1.90%   99.96%  99.98% adaptive_lookup:retry_fuzz
16384         16384  100.00%   96.53%  98.30% adaptive_lookup:blackhole
16384         16384  100.00%   99.34%  99.67% adaptive_lookup:max_retry_interval
16384         16384  100.00%   97.62%  98.82% adaptive_lookup:idle_timeout
16384         16384  100.00%   95.67%  97.88% adaptive_lookup:max_resident_active_queue
16384         16384  100.00%   88.47%  94.55% adaptive_lookup:mailfrom_timeout
16384         16384  100.00%   88.47%  94.55% adaptive_lookup:max_recipients_per_batch
16384         16384  100.00%   92.33%  96.31% adaptive_lookup:max_recipients_per_connection
16384         16384  100.00%   96.77%  98.41% adaptive_lookup:outbound_throttle_messages
16384         16384  100.00%   86.54%  93.69% adaptive_lookup:ehlo_timeout
16384         16384  100.00%   98.64%  99.32% adaptive_lookup:max_retries
16384         16384  100.00%   96.96%  98.50% adaptive_lookup:max_outbound_connections
16384         16384  100.00%   97.01%  98.53% adaptive_lookup:suspend_delivery
16384         16384  100.00%   98.63%  99.32% adaptive_lookup:retry_interval
16384         16384  100.00%   87.58%  94.15% adaptive_lookup:body_timeout
16384         16384  100.00%   87.13%  93.95% adaptive_lookup:max_deliveries_per_connection
16384         16384  100.00%   86.27%  93.58% adaptive_lookup:rcptto_timeout
16384         2761    16.85%   95.82%  97.95% adaptive_lookup:rset_timeout
262144        65179   24.86%   98.33%  70.61% alerting_data
2048          653     31.88%   99.96%  99.96% 0x2b59ee386588
4294967295    17       0.00%  100.00% 100.00% scpt_root
256           2        0.78%  100.00% 100.00% core:sieve_scripts
16384         16384  100.00%   15.89%  54.32% core:bounce_classify
128           0        0.00%    0.00%   0.00% core:pcre
4294967295    390289   0.01%   99.93%  99.93% config:match
65536         374      0.57%   99.99%  99.99% retry_state

  30 caches listed.

See Also

cache stat, cache stats, match_cache_life