A newer version of this documentation is available.

View Latest


    Provides detailed statistics on a per vbucket granularity.


    Request syntax for vBucket:

    cbstats [host]:11210 vbucket
    cbstats [host]:11210 vbucket-details [vbid]
    cbstats [host]:11210 vbucket-seqno [vbid]

    These commands are used as follows:

    • vbucket: Lists all available vBuckets and provides information about their type: active, replica, pending or dead.

    • vbucket-details: Uses the option vbid to provide statistics for a specific vBucket.

    • vbucket-seqno: Uses the option vbid to provide details connected to the vBucket’s sequence number.


    The vbucket command shows whether a vBucket is an active, replica, pending or dead vBucket.

    Table 1. Notable vBucket-details stats
    Stat Description


    Total size of useful data in the database file on disk, measured in bytes.


    Total size of the database file on disk (including un-compacted stale data), measured in bytes.


    Threshold at which positive drift will trigger an update to drift_ahead_exceeded, measured in nanoseconds.


    How many mutations have been observed with a drift above the drift_ahead_threshold.


    The threshold at which positive drift will trigger an update to drift_behind_exceeded. The value is displayed in nanoseconds as a positive value, but is converted to a negative value for actual exception checks.


    How many mutations have been observed with a drift below the drift_behind_threshold.


    How many times the hybrid logical clock has had to increment the logical clock.


    The vBucket’s current maximum hybrid logical clock timestamp. In general, this statistic shows the value issued to the last mutation or in certain cases the largest timestamp the vBucket has received (when the received timestamp is ahead of the local clock). Displayed as a human readable ISO-8601 timestamp (UTC).


    Total number of items in the vbucket.


    Total number of items which are not resident in memory for this vbucket.


    Accumulated drift observed by the vBucket. Drift is always accumulated as an absolute value.


    How many updates have been applied to total_abs_drift, for the purpose of average or rate calculations.


    Table 2. vbucket options
    Option Description


    vBucket ID (in a standard system this will be between 0 and 1023). If not provided as part of the command then details for all vBuckets are shown.



    cbstats vbucket
    cbstats vbucket-details 115
    cbstats vbucket-seqno 115


    Example response for vbucket:

     vb_0:    replica
     vb_1:    replica
     vb_10:   replica
     vb_100:  active
     vb_1000: replica
     vb_1001: replica
     vb_1002: replica
     vb_1003: replica
     vb_1004: replica
     vb_1005: replica

    Example response for vbucket-details 115:

     vb_115:                                 active
     vb_115:bloom_filter:                    ENABLED
     vb_115:bloom_filter_key_count:          0
     vb_115:bloom_filter_size:               95851
     vb_115:db_data_size:                    28473
     vb_115:db_file_size:                    98395
     vb_115:drift_ahead_threshold:           5000000000
     vb_115:drift_ahead_threshold_exceeded:  0
     vb_115:drift_behind_threshold:          5000000000
     vb_115:drift_behind_threshold_exceeded: 0
     vb_115:high_seqno:                      31
     vb_115:ht_cache_size:                   44546
     vb_115:ht_item_memory:                  44546
     vb_115:ht_memory:                       26656
     vb_115:logical_clock_ticks:             9
     vb_115:max_cas:                         1484657322073980930
     vb_115:max_cas_str:                     2017-01-17T12:48:42.73980930
     vb_115:num_ejects:                      4
     vb_115:num_items:                       31
     vb_115:num_non_resident:                4
     vb_115:num_temp_items:                  0
     vb_115:ops_create:                      31
     vb_115:ops_delete:                      0
     vb_115:ops_reject:                      0
     vb_115:ops_update:                      0
     vb_115:pending_writes:                  0
     vb_115:purge_seqno:                     0
     vb_115:queue_age:                       0
     vb_115:queue_drain:                     32
     vb_115:queue_fill:                      32
     vb_115:queue_memory:                    0
     vb_115:queue_size:                      0
     vb_115:rollback_item_count:             0
     vb_115:total_abs_drift:                 0
     vb_115:total_abs_drift_count:           0
     vb_115:uuid:                            265143847629643

    Example response for vbucket-seqno 115:

     vb_115:abs_high_seqno:            31
     vb_115:high_seqno:                31
     vb_115:last_persisted_seqno:      31
     vb_115:last_persisted_snap_end:   31
     vb_115:last_persisted_snap_start: 31
     vb_115:purge_seqno:               0
     vb_115:uuid:                      265143847629643