A newer version of this documentation is available.

View Latest

hash

  • reference
    +
    Provides information about the vBucket hash tables.

    Syntax

    Request syntax:

    cbstats [hostname]:11210 hash
    cbstats [hostname]:11210 hash detail

    Description

    Requesting these stats does affect performance, so don’t do it too regularly, but it’s useful for debugging certain types of performance issues. For example, if your hash table is tuned to have too few buckets for the data load within it, the max_depth will be too large, and performance will suffer.

    It is also possible to get more detailed hash tables stats by using ‘hash detail’. This prints per-vbucket stats. Each stat is prefixed with vb_ followed by a number, a colon, then the individual stat name. For example, the stat representing the size of the hash table for vbucket 0 is vb_0:size=.

    Options

    None

    Examples

    Hash request

    cbstats 10.5.2.54:11210 hash

    Hash response

     avg_count:    0
     avg_max:      0
     avg_min:      0
     largest_max:  0
     largest_min:  0
     max_count:    0
     min_count:    0
     total_counts: 0
    Table 1. Hash response stats
    Stat Description

    avg_count

    The average number of items per vbucket.

    avg_max

    The average max depth of a vbucket hash table.

    avg_min

    The average min depth of a vbucket hash table.

    largest_max

    The largest hash table depth of in all vbuckets.

    largest_min

    The largest minimum hash table depth of all vbuckets.

    max_count

    The largest number of items in a vbucket.

    min_count

    The smallest number of items in a vbucket.

    total_counts

    The total number of items in all vbuckets.

    Hash detail

    cbstats 10.5.2.54:11210 hash detail

    Hash detail response

     avg_count:                0
     avg_max:                  0
     avg_min:                  0
     largest_max:              0
     largest_min:              0
     max_count:                0
     min_count:                0
     total_counts:             0
     vb_0:counted:             0
     vb_0:locks:               5
     vb_0:max_depth:           0
     vb_0:mem_size:            0
     vb_0:mem_size_counted:    0
     vb_0:min_depth:           0
     vb_0:reported:            0
     vb_0:resized:             0
     vb_0:size:                3079
     vb_0:state:               replica
     ...
    Table 2. Hash detail response stats
    Stat Description

    state

    The current state of this vbucket.

    size

    Number of hash buckets.

    locks

    Number of locks covering hash table operations.

    min_depth

    Minimum number of items found in a bucket.

    max_depth

    Maximum number of items found in a bucket.

    reported

    Number of items this hash table reports having.

    counted

    Number of items found while walking the table.

    resized

    Number of times the hash table resized.

    mem_size

    Running sum of memory used by each item.

    mem_size_counted

    Counted sum of current memory used by each item.