Couchbase Server Manual 1.8 - Chapter 7. Command-line Interface for Administration

7.3.1. Retrieving Bucket Statistics
Prev	7.3. Using cbstats	Next

7.3.1. Retrieving Bucket Statistics

Use the all command to get information about a named bucket:

./cbstats 10.4.2.5:11220 all newbucket password | grep -E 'uptime|bytes_read|bytes_written'

The types of bucket statistics returned by all include:

Connection information for the bucket including attempted connections, rejections and port information.
Hits and Misses: hits are the number of requests made for bucket information and misses are requests made for keys that cannot be found. Both hit- and miss- statistics are grouped by operation.
Memory quota and usage.

Couchbase Server will return these statistics about a memcached or Couchbase bucket. In the case of memcached buckets, statistics about persistence do not apply and therefore do not appear:

Table 7.5. cbstats Output for all

Name	Description
`accepting_conns`	Connections accepted by a node.
`auth_cmds`	Number of authentication commands handled with success or failure.
`auth_errors`	Number of failed authentications.
`bucket_active_conns`	Active connection to bucket.
`bucket_conns`
`bytes_read`	Total number of bytes read by this node from network.
`bytes_written`	Total number of bytes sent by this node to network.
`cas_badval`	Total number of CAS commands that failed to modify a value due to a bad CAS id.
`cas_hits`	Number of successful CAS requests.
`cas_misses`	Number of CAS requests against missing keys.
`cmd_flush`
`Cumulative number of flush requests for bucket.`
`cmd_get`	Cumulative number of get requests for node.
`cmd_set`	Cumulative number of set requests for node.
`conn_yields`	Number of times any connection yielded to another one due to hitting the -R limit.
`connection_structures`	Number of connection structures allocated by node.
`curr_connections`	Number of open connections
`curr_connections`	Number of open connections
`curr_items`	Current number of items stored.
`curr_items_tot`	Number of current items including those not active (replica, dead and pending states.)
`daemon_connections`	Number of connection structures used by this node internally.
`decr_hits`	Number of successful decrement requests.
`decr_misses`	Number of decrement requests against missing keys.
`delete_hits`	Number of deletion requests against missing keys.
`delete_misses`	Number of deletion requests against missing keys.
`ep_bg_fetched`	Number of items fetched from disk.
`ep_commit_num`	Total number of write commits.
`ep_commit_time`	Number of seconds transpired for most recent commit.
`ep_commit_time_total`	Cumulative seconds spent committing.
`ep_data_age`	Age of data that has been persisted to disk.
`ep_data_age_highwat`	Oldest age of data that has been persisted to disk
`ep_db_cleaner_status`	Status of database maintenance process that removes invalid items with old vBucket versions.
`ep_db_strategy`	SQLite db strategy.
`ep_dbinit`	Number of seconds to initialize DB.
`ep_dbshards`	Number of shards for db store
`ep_diskqueue_drain`	Total items in queue to be persisted that have been stored on disk.
`ep_diskqueue_fill`	Total items waiting in queue to be stored on disk.
`ep_diskqueue_items`	Total items in disk queue.
`ep_diskqueue_memory`	Total memory used in disk queue.
`ep_diskqueue_pending`	Total bytes of pending disk writes.
`ep_exp_pager_stime`	Interval set for regular maintenance process that removes expired items from node. In seconds.
`ep_expired`	Number of times any item was expired for a node/bucket.
`ep_flush_all`	Boolean that is set to true if disk flush_all is scheduled.
`ep_flush_all`	Boolean that is set to true if disk flush_all is scheduled.
`ep_flush_duration`	Number of seconds duration of most recent flush.
`ep_flush_duration_highwat`	Longest duration required to flush data.
`ep_flush_duration_total`	Cumulative seconds spent flushing data.
`ep_flush_preempts`	Number of flush early exits for read requests.
`ep_flusher_deduplication`
`ep_flusher_state`	Current state of the flusher thread.
`ep_flusher_todo`	Number of items remaining to be written to disk.
`ep_inconsistent_slave_chk`	Flag indicating whether we allow a “downstream” master to receive checkpoint messages.
`ep_io_num_read`	Number of io read operations.
`ep_io_num_write`	Number of io write operations.
`ep_io_read_bytes`	Number of bytes read (key + values)
`ep_io_write_bytes`	Number of bytes written (key + values).
`ep_item_begin_failed`	Number of times a transaction failed to start due to storage errors.
`ep_item_commit_failed`	Number of times a transaction failed to commit data due to storage errors.
`ep_item_flush_expired`	Number of times an item is not flushed due to the expiry of the item.
`ep_item_flush_failed`	Number of times an item failed to flush due to storage errors.
`ep_items_rm_from_checkpoints`	Number of items removed from closed unreferenced checkpoints.
`ep_keep_closed_checkpoints`	Boolean indicating a checkpoint status retained or deleted.
`ep_kv_size`	Memory used to store item metadata, keys and values, regardless of a vBucket state. If Couchbase Server ejects a value, it decrements this number by the size of the value.
`ep_latency_arith_cmd`	The total elapsed time for increment and decrement requests.
`ep_latency_get_cmd`	The total elapsed time for get requests for bucket/node.
`ep_latency_store_cmd`	The total elapsed time for store requests.
`ep_max_data_size`	Maximum amount of data allowed in memory.
`ep_max_txn_size`	Max number of updates per transaction.
`ep_mem_high_wat`	High water mark for auto-evictions.
`ep_mem_low_wat`	Low water mark for auto-evictions.
`ep_mem_tracker_enabled`
`ep_min_data_age`	Minimum age for data before it can be persisted.
`ep_num_active_non_resident`	Number of non-resident items in active vBuckets. Non-resident items have their values ejected onto disk.
`ep_num_checkpoint_remover_runs`	Number of times Couchbase Server ran checkpoint remover to remove closed unreferenced checkpoints.
`ep_num_eject_failures`	Number of values that could not be ejected from RAM to disk.
`ep_num_eject_replicas`	Number of times Couchbase Server ejected replica values from memory to disk.
`ep_num_expiry_pager_runs`	Number of times Couchbase Server ran maintenance processes to purge expired items from memory/disk.
`ep_num_non_resident`	The number of non-resident items. Non-resident items are keys that have the key and metadata stored in RAM, but the value is ejected onto disk.
`ep_num_not_my_vbuckets`	Number of times a 'Not My VBucket' exception has occurred for a node. This exception occurs when a request comes for data stored in another vBucket associated with a node.
`ep_num_pager_runs`	Number of times this node has run the maintenance process to free additional memory.
`ep_onlineupdate`	Returns true if engine is in online updated mode.
`ep_onlineupdate_revert_add`	Number of reverted newly added items.
`ep_onlineupdate_revert_delete`	Number of reverted deleted items.
`ep_onlineupdate_revert_update`	Number of reverted updated items.
`ep_oom_errors`	Number of times an unrecoverable out of memory error occurred while this node processed requests.
`ep_overhead`	Extra memory used by transient data, such as persistence queue, replication queues, checkpoints, and so forth.
`ep_pending_ops`	Number of operations awaiting pending vBuckets.
`ep_pending_ops_max`	Maximum operations awaiting 1 pending vBucket.
`ep_pending_ops_max_duration`	Maximum time used waiting on pending vBuckets.
`ep_pending_ops_total`	Total blocked pending operations.
`ep_queue_age_cap`	Queue age cap setting.
`ep_queue_size`	Number of items queued for storage.
`ep_storage_age`	How long an item has been waiting in queue to be persisted to disk.
`ep_storage_age_highwat`	The longest an item has been waiting in queue to be persisted to disk.
`ep_storage_type`	Indicates whether disk storage is SQLite or Couchstore.
`ep_store_max_concurrency`	Maximum allowed concurrency at the storage level.
`ep_store_max_readers`	Maximum number of concurrent read-only storage threads allowed for this node.
`ep_store_max_readwrite`	Maximum number of concurrent read-write storage threads allowed for this node.
`ep_tap_bg_fetch_requeued`	Number of times a TAP background fetch task is requeued.
`ep_tap_bg_fetched`	Number of TAP background fetches from disk.
`ep_tap_keepalive`	How long to maintain existing TAP connection state after a client disconnect.
`ep_tmp_oom_errors`	Number of times temporary out of memory errors have occurred for this node while processing requests.
`ep_too_old`	Number of times an object was stored on disk after being stale for too long.
`ep_too_young`	Number of times an object is not stored on disk because it is too new.
`ep_total_cache_size`	Total size of all items for this node, regardless of vBucket state, or whether or not the value for an item is ejected into RAM.
`ep_total_del_items`	Total number of items flagged for deletion that are persisted on disk.
`ep_total_enqueued`	Total number of items waiting in queue to be persisted on disk.
`ep_total_new_items`	Total new keys for a node that have been persisted.
`ep_total_persisted`	Total number of items for node that have been persisted.
`ep_uncommitted_items`	Items that are new or updated but are not yet persisted.
`ep_value_size`	Memory used to store values for resident keys. These are items which are stored on both RAM and disk in entirety.
`ep_vb_total`	Total number of vBuckets.
`ep_vbucket_del`	Number of deletions that have occurred for a vBucket.
`ep_vbucket_del_fail`	Number of deletions that have failed for a vBucket.
`ep_version`	Version number of underlying Couchbase Server component, ep_engine.
`ep_warmed_up`	Number of items warmed up.
`ep_warmup`	True if node is ready to accept new writes and reads.
`ep_warmup_dups`	Duplicates encountered during node warmup.
`ep_warmup_oom`	Out of memory errors encountered during warmup.
`ep_warmup_thread`	Indicates complete if the node is done with its initialization phase.
`ep_warmup_time`	Time (µs) spent by warming data.
`get_hits`	Number of keys that have been requested and found.
`get_misses`	Number of items that have been requested but not found.
`incr_hits`	Number of successful increment requests.
`incr_misses`	Number of increment requests made for keys that cannot be found.
`libevent`	Maximum number of bytes this node is allowed to use for storage.
`limit_maxbytes`	Total number of items for node that have been persisted.
`listen_disabled_num`	Occurs if there are too many simultaneous connections. Incremented when Couchbase Server rejects a connection request.
`max_conns_on_port_`	Maximum number of connections allowed on specified port.
`mem_used`	Total memory used by Couchbase Server component, ep_engine.
`pid`	ID for this server process.
`pointer_size`	Default size of pointers on the host OS; typically 32- or 64- bit.
`rejected_conns`	Connection requests rejected by this node.
`rusage_system`	Accumulated system time for this process, in form for seconds:microseconds.
`rusage_user`	Accumulated user time for this process, in form for seconds:microseconds.
`threads`	Number of worker threads requested.
`time`	Current UNIX time according to the node.
`uptime`	Number of seconds since this node initially started
`vb_active_curr_items`	Number of items in RAM.
`vb_active_eject`	Number of times this node ejected values from RAM onto disk.
`vb_active_ht_memory`	Memory used to store keys and values
`vb_active_itm_memory`	Total items in memory.
`vb_active_num`	Number of active vBuckets
`vb_active_num_non_resident`	Number of non-resident items; non-resident items are those with keys and metadata in RAM, but the values are stored on disk to conserve resources.
`vb_active_ops_create`	Number of create requests made on node.
`vb_active_ops_delete`	Number of delete requests made on node.
`vb_active_ops_reject`	Number of requests made on node but rejected by node.
`vb_active_ops_update`	Number of update requests made on node.
`vb_active_perc_mem_resident`	Percentage of memory taken up by resident data. This is data where the key, metadata and value all reside in RAM.
`vb_active_queue_age`	Total of all ages for items in disk queue. In milliseconds.
`vb_active_queue_drain`	Total number of keys that have been drained from a disk-write queue.
`vb_pending_queue_fill`	Total items waiting in queue for disk write.
`vb_pending_queue_memory`	Total memory used by queue for disk writes.
`vb_pending_queue_pending`	Total bytes used by items awaiting disk persistence.
`vb_pending_queue_size`	Pending items in disk-write queue.
`vb_replica_curr_items`	Number of items for vBuckets in replica state.
`vb_replica_eject`	Number of times the value for a key has been ejected from RAM to disk.
`vb_replica_ht_memory`	Memory used to store keys and values.
`vb_replica_itm_memory`	Total bytes taken up by items memory.
`vb_replica_num`	Number of replica vBuckets for this node.
`vb_replica_num_non_resident`	Number of non-resident items; these are keys and associated metadata in RAM, while the associated value for the keys are stored on disk.
`vb_replica_ops_create`	Number of create requests made for replica-state vBuckets.
`vb_replica_ops_delete`	Number of delete requests made for replica-state vBuckets..
`vb_replica_ops_reject`	Number of rejected requests made for replica-state vBuckets.
`vb_replica_ops_update`	Number of update requests made for replica-state vBuckets.
`vb_replica_perc_mem_resident`	Percentage of resident memory. Resident data are items stored entirely in RAM and disk, including keys, values, and metadata.
`vb_replica_queue_age`	Total age in milliseconds of items waiting in queue to be stored to disk.
`vb_replica_queue_drain`	Total items from this vBucket drained from the disk-write queue.
`vb_replica_queue_fill`	Total items awaiting disk persistence from this vBucket.
`vb_replica_queue_memory`	Memory used for disk queue for this vBucket.
`vb_replica_queue_pending`	Total bytes of disk-queue items for this vBucket
`vb_replica_queue_size`	Replica items in disk queue.
`version`	Version number of ep_engine component.