Please use the form below to provide your feedback. Because your feedback is valuable to us, the information you submit in this form is recorded in our issue tracking system (JIRA), which is publicly available. You can track the status of your feedback using the ticket number displayed in the dialog once you submit the form.

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