Search:

Search all manuals
Search this manual
Manual
Couchbase Server Manual 2.0
Community Wiki and Resources
Download Couchbase Server 2.0
Couchbase Developer Guide 2.0
Client Libraries
Couchbase Server Forum
Additional Resources
Community Wiki
Community Forums
Couchbase SDKs
Parent Section
6.4 Viewing Bucket and Cluster Statistics
Chapter Sections
Chapters

6.4.1. Individual Bucket Monitoring

6.4.1.1. Bucket Monitoring — Summary Statistics
6.4.1.2. Monitoring vBucket Resources
6.4.1.3. Monitoring Disk Queues
6.4.1.4. Monitoring TAP Queues
6.4.1.5. Bucket Memcached Buckets
6.4.1.6. Monitoring Outgoing XDCR
6.4.1.7. Monitoring Incoming XDCR
6.4.1.8. Monitoring View Statistics

Bucket monitoring within the Couchbase Web Console has been updated to show additional detailed information. The following statistic groups are available for Couchbase bucket types.

For Memcached bucket types, the Memcached statistic summary is provided. See Section 6.4.1.5, “Bucket Memcached Buckets”.

6.4.1.1. Bucket Monitoring — Summary Statistics

The summary section is designed to provide a quick overview of the cluster activity. Each graph (or selected graph) shows information based on the currently selected bucket.

Figure 6.14. Web Console — Summary Statistics

Web Console — Summary statistics

The following graph types are available:

  • ops per second

    The total number of operations per second on this bucket.

  • cache miss ratio

    Ratio of reads per second to this bucket which required a read from disk rather than RAM.

  • creates per second

    Number of new items created in this bucket per second.

  • updates per second

    Number of existing items updated in this bucket per second.

  • XDCR ops per sec

    Number of XDCR related operations per second for this bucket.

  • disk reads per sec

    Number of reads per second from disk for this bucket.

  • temp OOM per sec

    Number of temporary out of memory conditions per second.

  • gets per second

    Number of get operations per second.

  • sets per second

    Number of set operations per second.

  • deletes per second

    Number of delete operations per second.

  • items

    Number of items (documents) stored in the bucket.

  • disk write queue

    Size of the disk write queue.

  • docs data size

    Size of the stored document data.

  • docs total disk size

    Size of the persisted stored document data on disk.

  • doc fragmentation %

    Document fragmentation of persisted data as stored on disk.

  • XDC replication queue

    Size of the XDCR replication queue.

  • total disk size

    Total size of the information for this bucket as stored on disk, including persisted and view index data.

  • views data size

    Size of the view data information.

  • views total disk size

    Size of the view index information as stored on disk.

  • views fragmentation %

    Percentage of fragmentation for a given view index.

  • view reads per second

    Number of view reads per second.

  • memory used

    Amount of memory used for storing the information in this bucket.

  • high water mark

    High water mark for this bucket (based on the configured bucket RAM quota).

  • low water mark

    Low water mark for this bucket (based on the configured bucket RAM quota).

  • disk update time

    Time required to update data on disk.

6.4.1.2. Monitoring vBucket Resources

The vBucket statistics provide information for all vBucket types within the cluster across three different states. Within the statistic display the table of statistics is organized in four columns, showing the Active, Replica and Pending states for each individual statistic. The final column provides the total value for each statistic.

Figure 6.15. Web Console — vBucket Resources statistics

Web Console — vBucket Resources statistics

The Active column displays the information for vBuckets within the Active state. The Replica column displays the statistics for vBuckets within the Replica state (i.e. currently being replicated). The Pending columns shows statistics for vBuckets in the Pending state, i.e. while data is being exchanged during rebalancing.

These states are shared across all the following statistics. For example, the graph new items per sec within the Active state column displays the number of new items per second created within the vBuckets that are in the active state.

The individual statistics, one for each state, shown are:

  • vBuckets

    The number of vBuckets within the specified state.

  • items

    Number of items within the vBucket of the specified state.

  • resident %

    Percentage of items within the vBuckets of the specified state that are resident (in RAM).

  • new items per sec.

    Number of new items created in vBuckets within the specified state. Note that new items per second is not valid for the Pending state.

  • ejections per second

    Number of items ejected per second within the vBuckets of the specified state.

  • user data in RAM

    Size of user data within vBuckets of the specified state that are resident in RAM.

  • metadata in RAM

    Size of item metadata within the vBuckets of the specified state that are resident in RAM.

6.4.1.3. Monitoring Disk Queues

The Disk Queues statistics section displays the information for data being placed into the disk queue. Disk queues are used within Couchbase Server to store the information written to RAM on disk for persistence. Information is displayed for each of the disk queue states, Active, Replica and Pending.

Figure 6.16. Web Console — Disk Queue Statistics

Web Console — Disk Queue statistics

The Active column displays the information for the Disk Queues within the Active state. The Replica column displays the statistics for the Disk Queues within the Replica state (i.e. currently being replicated). The Pending columns shows statistics for the disk Queues in the Pending state, i.e. while data is being exchanged during rebalancing.

These states are shared across all the following statistics. For example, the graph fill rate within the Replica state column displays the number of items being put into the replica disk queue for the selected bucket.

The displayed statistics are:

  • items

    The number of items waiting to be written to disk for this bucket for this state.

  • fill rate

    The number of items per second being added to the disk queue for the corresponding state.

  • drain rate

    Number of items actually written to disk from the disk queue for the corresponding state.

  • average age

    The average age of items (in seconds) within the disk queue for the specified state.

6.4.1.4. Monitoring TAP Queues

The TAP queues statistics are designed to show information about the TAP queue activity, both internally, between cluster nodes and clients. The statistics information is therefore organized as a table with columns showing the statistics for TAP queues used for replication, rebalancing and clients.

Figure 6.17. Web Console — TAP Queue Statistics

Web Console — TAP Queue statistics

The statistics in this section are detailed below:

  • TAP senders

    Number of TAP queues in this bucket for internal (replica), rebalancing or client connections.

  • items

    Number of items in the corresponding TAP queue for this bucket.

  • drain rate

    Number of items per second being sent over the corresponding TAP queue connections to this bucket.

  • back-off rate

    Number of back-offs per second sent when sending data through the corresponding TAP connection to this bucket.

  • backfill remaining

    Number of items in the backfill queue for the corresponding TAP connection for this bucket.

  • remaining on disk

    Number of items still on disk that need to be loaded in order to service the TAP connection to this bucket.

6.4.1.5. Bucket Memcached Buckets

For Memcached buckets, Web Console displays a separate group of statistics:

Figure 6.18. Web Console — Memcached Statistics

Web Console — Memcached statistics

The Memcached statistics are:

  • Operations per sec.

    Total operations per second serviced by this bucket

  • Hit Ratio %

    Percentage of get requests served with data from this bucket

  • Memory bytes used

    Total amount of RAM used by this bucket

  • Items count

    Number of items stored in this bucket

  • RAM evictions per sec.

    Number of items per second evicted from this bucket

  • Sets per sec.

    Number of set operations serviced by this bucket

  • Gets per sec.

    Number of get operations serviced by this bucket

  • Net. bytes TX per sec

    Number of bytes per second sent from this bucket

  • Net. bytes RX per sec.

    Number of bytes per second sent into this bucket

  • Get hits per sec.

    Number of get operations per second for data that this bucket contains

  • Delete hits per sec.

    Number of delete operations per second for data that this bucket contains

  • Incr hits per sec.

    Number of increment operations per second for data that this bucket contains

  • Decr hits per sec.

    Number of decrement operations per second for data that this bucket contains

  • Delete misses per sec.

    Number of delete operations per second for data that this bucket does not contain

  • Decr misses per sec.

    Number of decr operations per second for data that this bucket does not contain

  • Get Misses per sec.

    Number of get operations per second for data that this bucket does not contain

  • Incr misses per sec.

    Number of increment operations per second for data that this bucket does not contain

  • CAS hits per sec.

    Number of CAS operations per second for data that this bucket contains

  • CAS badval per sec.

    Number of CAS operations per second using an incorrect CAS ID for data that this bucket contains

  • CAS misses per sec.

    Number of CAS operations per second for data that this bucket does not contain

6.4.1.6. Monitoring Outgoing XDCR

The Outgoing XDCR shows the XDCR operations that are supporting cross datacenter replication from the current cluster to a destination cluster. For more information on XDCR, see Section 5.8, “Cross Datacenter Replication (XDCR)”.

You can monitor the current status for all active replications in the Ongoing Replications section under the XDCR tab:

Figure 6.19. Couchbase Web Console - Ongoing Replications

Couchbase Web Console - Ongoing Replications

The Ongoing Replications section shows the following information:

ColumnDescription
BucketThe source bucket on the current cluster that is being replicated.
FromSource cluster name.
ToDestination cluster name.
StatusCurrent status of replications.
WhenIndicates when replication occurs.

The Status column indicates the current state of the replication configuration. Possible include:

  • Starting Up

    The replication process has just started, and the clusters are determining what data needs to be sent from the originatin cluster to the destination cluster.

  • Replicating

    The bucket is currently being replicated and changes to the data stored on the originating cluster are being sent to the destination cluster.

  • Failed

    Replication to the destination cluster has failed. The destination cluster cannot be reached. The replication configuration may need to be deleted and recreated.

Under the Data Buckets tab you can click on a named Couchbase bucket and find more statistics about replication for that bucket. Couchbase Web Console displays statistics for the particular bucket; on this page you can find two drop-down areas called in the Outgoing XDCR and Incoming XDCR Operations. Both provides statistics about ongoing replication for the particular bucket. Under the Outgoing XDCR panel if you have multiple replication streams you will see statistics for each stream.

Under the Outbound XDCR section, you will see information about replication from this source bucket to a destination bucket:

Figure 6.20. Couchbase Web Console - Outbound XDCR

Couchbase Web Console - Outbound XDCR

Here are the meanings for the outgoing XDCR statistics:

  • mutations to replicate: shows the items on this source bucket that are awaiting replication.

  • mutations checked: shows the number of documents that have been persisted and checked for replication.

  • mutations replicated: number of documents that have been replicated to the destination bucket.

  • data replicated: size of all item replicated

  • active vb reps: number of active replicators which are currently working

  • waiting vb reps: number of replicators waiting for items to replicate

  • secs in replicating: time spent by replicators checking items and waiting

  • secs in checkpointing: time spent by replicators checkpointing and committing items to a destination cluster

  • checkpoints issued: number of checkpoints that have been issued. This is updated every 30 minutes.

  • checkpoints failed: number of failed checkpoints. These are checkpoints which have been issued by the server but have failed.

  • mutations in queue: number of document mutations that are in the replication queue for XDCR

  • queue size: size of all documents that are in the XDCR replication queue.

6.4.1.7. Monitoring Incoming XDCR

The Incoming XDCR section shows the XDCR operations that are coming into to the current cluster from a remote cluster. For more information on XDCR, see Section 5.8, “Cross Datacenter Replication (XDCR)”.

If a cluster is a destination cluster, you will also see this information in Couchbase Web Console for the specific bucket. When you use XDCR,

Figure 6.21. Couchbase Web Console - XDCR Incoming Replications

Couchbase Web Console - XDCR Incoming Replications

  • gets per sec: shows the number of items on a destination cluster which are being read by a source cluster.

  • sets per sec: shows the number of items on a destination cluster which are being creating or changed by a source cluster.

  • deletes per sec: number of items that have been deleted from a destination bucket by a source cluster.

  • total ops per sec: total gets, sets, or deletes on a destination cluster by a source cluster.

6.4.1.8. Monitoring View Statistics

The View statistics show information about individual design documents within the selected bucket. One block of stats will be shown for each production-level design document. For more information on Views, see Chapter 9, Views and Indexes.

Figure 6.22. Web Console — Views Statistics

Web Console — Views Statistics

The statistics shown are:

  • data size

    Size of the data required for this design document.

  • disk size

    Size of the stored index as stored on disk.

  • view reads per sec.

    Number of read operations per second for this view.