Couchbase monitoring

Couchbase server monitoring in Dynatrace provides a high-level overview of all Couchbase components in your cluster.


  • Linux OS or Windows
  • Couchbase version 4.3+

Enabling Couchbase monitoring globally

With Couchbase monitoring enabled globally, Dynatrace automatically collects Couchbase metrics whenever a new host running Couchbase is detected in your environment.

  1. In the navigation menu, select Settings.
  2. Select Monitoring > Monitored technologies.
  3. On the Supported technologies tab, find the Couchbase entry and click in the Edit column to expand the row.
  4. Set the User and Password.
    The credentials have to work for all Couchbase hosts that you want to monitor.
  5. Set the Port.
    The default port is 8091.
  6. Click Save.
  7. Set the Global monitoring switch for Couchbase to the On position.
    Couchbase monitoring is enabled globally.

Enabling Couchbase monitoring for individual hosts

Dynatrace provides the option of enabling Couchbase monitoring for specific hosts rather than globally.

  1. If global Couchbase monitoring is currently switched on, switch it off: go to Settings > Monitoring > Monitored technologies and set the Couchbase switch to the Off position.
  2. In the navigation menu, select Hosts.
  3. Find the host you want to configure.
    Use the filter at the top of the list to help you locate the host.
  4. Click the host to open the host page.
  5. In the host menu (""), select Settings to open the Host settings page.
  6. In the Monitored technologies list, find the Couchbase row and set the Monitoring switch to the On position.
    Couchbase monitoring is enabled for the selected host.

Monitoring Couchbase clusters

  1. In the navigation menu, select Technologies.

  2. Click the Couchbase tile.

  3. To view cluster metrics, expand the Details section of the Couchbase process group.

  4. Click the Process group details button.

  5. On the Process group details page, select the Technology-specific metrics tab to view relevant cluster charts and metrics.

    • Couchbase cluster (process group) overview pages provide an overview of Couchbase cluster health and performance.
    • This page is also helpful for identifying problematic nodes. Just select a relevant time interval for the timeline, select a node metric from the metric drop list, and compare the values of all nodes in the sortable table.
  6. Further down the page, you’ll find a number of other cluster-specific charts.

Couchbase cluster charts

Chart Contents


Number of nodes per status (healthy, unhealthy, warmup)

Out of memory

Number of OOM and temporary OOM per sec


Number of operations

Disk fetches

Disk fetches for memcached buckets

RAM overview

Overview of cluster memory

Disk overview

Overview of cluster disk usage

Swap usage

Cluster swap usage

Cache miss rate

Percent of requests not found in the cache

Number of ejected items

Number of times that item values were ejected from memory to disk

Current items

Number of documents stored on the cluster


Numbers of buckets per type

Couchbase node monitoring

To access valuable Couchbase node metrics:

  1. On your Couchbase Process group details page, select a node from the Process list at the bottom of the page.
  2. Click the Couchbase metrics tab.
    Charts available on the node level include Node status, Operations, Disk fetches, RAM usage, Swap usage, and Current items.