A newer version of this documentation is available.

View Latest

key

Provides information on keys.

Syntax

Request syntax:

cbstats [hostname]:11210 key [keyname] [vbid]

Description

The following key information is available.

Stat Description K/V

key_cas

The keys current cas value.

KV

key_data_age

How long the key has waited for its value to be persisted (0 if clean).

KV

key_exptime

Expiration time from the epoch.

KV

key_flags

Flags for this key.

KV

key_is_dirty

If the value is not yet persisted.

KV

key_valid

See description below*.

V

key_vb_state

The vbucket state of this key.

KV

*key_valid= can have the following responses:

  • this_is_a_bug: Some case we didn’t take care of.

  • dirty:The value in memory has not been persisted yet.

  • length_mismatch: The key length in memory doesn’t match the length on the disk.

  • data_mismatch: The data in memory doesn’t match the data on disk.

  • flags_mismatch: The flags in memory don’t match the flags on disk.

  • valid: The key is both on disk and in memory

  • ram_but_not_disk: The value doesn’t exist yet on disk.

  • item_deleted: The item has been deleted.

Options

Table 1. key options
Option Description

KEYNAME

Name of the key.

VBID

vBucket ID.

Example

Request

cbstats 10.5.2.54:11210 key foo 115

Response

Example response for the key foo:

 key_cas: 41206791218746
 key_exptime: 0
 key_flags: 0
 key_is_dirty: 0