box.slab.stats()

box.slab.stats()¶

Show a detailed memory usage report (in bytes) for the slab allocator. The report is broken down into groups by data item size as well as by slab size (64-byte, 136-byte, etc). The report includes the memory allocated for storing both tuples and indexes.

return:

mem_free is the allocated, but currently unused memory;

mem_used is the memory used for storing data items (tuples and indexes);

item_count is the number of stored items;

item_size is the size of each data item;

slab_count is the number of slabs allocated;

slab_size is the size of each allocated slab.

rtype:
table

Example:

Here is a sample report for the first group:
tarantool> box.slab.stats()[1]
---
- mem_free: 16232
  mem_used: 48
  item_count: 2
  item_size: 24
  slab_count: 1
  slab_size: 16384
...
This report is saying that there are 2 data items (item_count = 2) stored in one (slab_count = 1) 24-byte slab (item_size = 24), so mem_used = 2 * 24 = 48 bytes. Also, slab_size is 16384 bytes, of which 16384 - 48 = 16232 bytes are free (mem_free).

A complete report would show memory usage statistics for all groups:
tarantool> box.slab.stats()
---
- - mem_free: 16232
    mem_used: 48
    item_count: 2
    item_size: 24
    slab_count: 1
    slab_size: 16384
  - mem_free: 15720
    mem_used: 560
    item_count: 14
    item_size: 40
    slab_count: 1
    slab_size: 16384
  <...>
  - mem_free: 32472
    mem_used: 192
    item_count: 1
    item_size: 192
    slab_count: 1
    slab_size: 32768
  - mem_free: 1097624
    mem_used: 999424
    item_count: 61
    item_size: 16384
    slab_count: 1
    slab_size: 2097152
  ...

return:	`mem_free` is the allocated, but currently unused memory; `mem_used` is the memory used for storing data items (tuples and indexes); `item_count` is the number of stored items; `item_size` is the size of each data item; `slab_count` is the number of slabs allocated; `slab_size` is the size of each allocated slab.
rtype:	table

The total mem_used for all groups in this report equals arena_used in box.slab.info() report.

Version:

box.slab.stats()