vbucket

vbucket

Provides detailed statistics on a per vbucket granularity.

Syntax

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.

Description

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

Table 1. Notable vBucket-details stats
Stat Description
db_data_size Total size of useful data in the database file on disk, measured in bytes.
db_file_size Total size of the database file on disk (including un-compacted stale data), measured in bytes.
drift_ahead_threshold Threshold at which positive drift will trigger an update to drift_ahead_exceeded, measured in nanoseconds.
drift_ahead_threshold_exceeded How many mutations have been observed with a drift above the drift_ahead_threshold.
drift_behind_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.
drift_behind_threshold_exceeded How many mutations have been observed with a drift below the drift_behind_threshold.
logical_clock_ticks How many times the hybrid logical clock has had to increment the logical clock.
max_cas_str 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).
num_items Total number of items in the vbucket.
num_non_resident Total number of items which are not resident in memory for this vbucket.
total_abs_drift Accumulated drift observed by the vBucket. Drift is always accumulated as an absolute value.
total_abs_drift_count How many updates have been applied to total_abs_drift, for the purpose of average or rate calculations.

Options

Table 2. vbucket options
Option Description
vbid 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.

Examples

Requests
cbstats 192.0.2.1:11210 vbucket
cbstats 192.0.2.1:11210 vbucket-details 115
cbstats 192.0.2.1:11210 vbucket-seqno 115

Responses

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