A newer version of this documentation is available.

View Latest

vbucket-details

Provides details for vBuckets.

Syntax

Request syntax:

cbstats host:11210 [common options] vbucket-details [vbid]

Description

This command provides details for the specified vBucket, or for each vBucket if none is specified.

The identifier for each vBucket statistic begins with the string vb_ followed by the vBucket ID and a colon. For example, for vBucket 1023, the identifier for the uuid statistic is vb_1023:uuid.

Table 1. vBucket statistics
Name Description

num_items

Number of items in this vBucket.

num_tmp_items

Number of temporary items in memory.

num_non_resident

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

vb_pending_perc_mem_resident

% memory resident.

vb_pending_eject

Number of times item values got ejected.

vb_pending_expired

Number of times an item was expired.

ht_memory

Memory overhead of the hashtable.

ht_item_memory

Total item memory.

ht_cache_size

Total size of cache — includes non-resident items.

num_ejects

Number of times an item was ejected from memory.

ops_create

Number of create operations.

ops_update

Number of update operations.

ops_delete

Number of delete operations.

ops_reject

Number of rejected operations.

queue_size

Pending items in disk queue.

backfill_queue_size

Items in backfill queue.

queue_memory

Memory used for disk queue.

queue_age

Sum of disk queue item age in milliseconds.

queue_fill

Total enqueued items.

queue_drain

Total drained items.

pending writes

Total bytes of pending writes.

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 uncompacted stale data), measured in bytes.

high_seqno

The last seqno assigned by this vBucket.

purge_seqno

The last seqno purged by the compactor.

bloom_filter

Status of the vBucket’s bloom filter.

bloom_filter_size

Size of the bloom filter bit array.

bloom_filter_key_count

Number of keys inserted into the bloom filter. Considers overlapped items as one, so this may not be accurate at times.

uuid

The current vBucket uuid.

rollback_item_count

Number of items rolled back.

hp_vb_req_size

Number of asynchronous high priority requests.

max_cas

Maximum CAS of all items in the vBucket. This is a hybrid logical clock value in nanoseconds.

max_cas_str

The vBucket’s current maximum hybrid logical clock (HLC) 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_abs_drift

The accumulated absolute drift for this vBucket’s hybrid logical clock in microseconds. Drift is always accumulated as an absolute value.

total_abs_drift_count

The number of updates applied to total_abs_drift, for the purpose of average or rate calculations.

drift_ahead_threshold_exceeded

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

drift_ahead_threshold

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

drift_behind_threshold_exceeded

How many mutations have been observed with a drift below the drift_behind_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.

logical_clock_ticks

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

might_contain_xattrs

True if the vBucket might contain xattrs. True means that xattrs were stored to the vBucket. Note that the flag does not clear itself if all xattrs were removed.

Table 2. Additional vBucket statistics for ephemeral buckets
Name Description

seqlist_count

Number of documents in this vBucket’s sequence list.

seqlist_deleted_count

Count of deleted documents in this vBucket’s sequence list.

seqlist_high_seqno

High sequence number in sequence list for this vBucket.

seqlist_highest_deduped_seqno

Highest de-duplicated sequence number in sequence list for this vBucket.

seqlist_read_range_begin

Starting sequence number for this vBucket’s sequence list read range. Marks the lower bound of possible stale documents in the sequence list.

seqlist_read_range_end

Ending sequence number for this vBucket’s sequence list read range. Marks the upper bound of possible stale documents in the sequence list.

seqlist_read_range_count

Count of elements for this vBucket’s sequence list read range, i.e. end - begin.

seqlist_stale_count

Count of stale documents in this vBucket’s sequence list.

seqlist_stale_value_bytes

Number of bytes of stale values in this vBucket’s sequence list.

seqlist_stale_metadata_bytes

Number of bytes of stale metadata (key + fixed metadata) in this vBucket’s sequence list.

Options

Table 3. vbucket-details 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.

For common cbstats options, see cbstats.

Example

Request

cbstats localhost:11210 -u Administrator -p password -b beer-sample vbucket-details 1023

Response

 vb_1023:                                 active
 vb_1023:backfill_queue_size:             0
 vb_1023:bloom_filter:                    DOESN'T EXIST
 vb_1023:bloom_filter_key_count:          0
 vb_1023:bloom_filter_size:               0
 vb_1023:db_data_size:                    4541
 vb_1023:db_file_size:                    41051
 vb_1023:drift_ahead_threshold:           5000000000
 vb_1023:drift_ahead_threshold_exceeded:  0
 vb_1023:drift_behind_threshold:          5000000000
 vb_1023:drift_behind_threshold_exceeded: 0
 vb_1023:high_seqno:                      10
 vb_1023:hp_vb_req_size:                  0
 vb_1023:ht_cache_size:                   3910
 vb_1023:ht_item_memory:                  3910
 vb_1023:ht_item_memory_uncompressed:     4077
 vb_1023:ht_memory:                       2576
 vb_1023:ht_size:                         47
 vb_1023:logical_clock_ticks:             0
 vb_1023:max_cas:                         1532081263385051136
 vb_1023:max_cas_str:                     2018-07-20T10:07:43.385051136
 vb_1023:max_deleted_revid:               0
 vb_1023:might_contain_xattrs:            false
 vb_1023:num_ejects:                      0
 vb_1023:num_items:                       10
 vb_1023:num_non_resident:                0
 vb_1023:num_temp_items:                  0
 vb_1023:ops_create:                      0
 vb_1023:ops_delete:                      0
 vb_1023:ops_reject:                      0
 vb_1023:ops_update:                      0
 vb_1023:pending_writes:                  0
 vb_1023:purge_seqno:                     0
 vb_1023:queue_age:                       0
 vb_1023:queue_drain:                     1
 vb_1023:queue_fill:                      1
 vb_1023:queue_memory:                    0
 vb_1023:queue_size:                      0
 vb_1023:rollback_item_count:             0
 vb_1023:total_abs_drift:                 0
 vb_1023:total_abs_drift_count:           0
 vb_1023:uuid:                            66069026212209