Changefeeds Dashboard

On this page Carat arrow pointing down

The Changefeeds dashboard in the DB Console lets you monitor the changefeeds created across your cluster.

To view this dashboard, access the DB Console, click Metrics on the left-hand navigation bar, and then select Dashboard > Changefeeds.


For more general recommendations on metrics and tooling options for change data capture monitoring, refer to the Monitor and Debug Changefeeds page.

Dashboard navigation

Use the Graph menu to display metrics for your entire cluster or for a specific node.

To the right of the Graph and Dashboard menus, a time interval selector allows you to filter the view for a predefined or custom time interval. Use the navigation buttons to move to the previous, next, or current time interval. When you select a time interval, the same interval is selected in the SQL Activity pages. However, if you select 10 or 30 minutes, the interval defaults to 1 hour in SQL Activity pages.

When viewing graphs, two perpendicular lines will appear at your mouse cursor providing further insight into the data. The metric values are displayed in the legend under the graph. Click anywhere within the graph to pin the values in place, decoupling the values from your mouse movements. Click anywhere within the graph to cause the values to change with your mouse movements once more.

Hovering your mouse cursor over the graph title will display a tooltip with a description and the metrics used to create the graph.

The Changefeeds dashboard displays the following time series graphs:

Changefeed Status

New in v23.2: This graph displays the status of all running changefeeds.

DB Console Changefeed Status graph showing running, paused, and failed changefeeds.

Metric Description
Running The number of changefeeds running.
Paused The number of paused changefeeds.
Failed The number of changefeeds that have failed.

Refer to RESUME JOB and PAUSE JOB to manage a changefeed.

In the case of a failed changefeed, you may want to use the cursor option to restart the changefeed. Refer to the Start a new changefeed where the previous failed example.

Commit Latency

New in v23.2: This graph displays the 99th, 90th, and 50th percentile of commit latency for running changefeeds. This is the difference between an event's MVCC timestamp and the time it was acknowledged as received by the downstream sink.

DB Console Commit Latency graph showing the 99th, 90th, and 50th percentile of commit latency.

If the sink batches events, then the difference between the oldest event in the batch and acknowledgement is recorded. Latency during backfill is excluded.

Emitted Bytes

This graph shows the number of bytes emitted by CockroachDB into the changefeed's downstream sink.


In v23.1 and earlier, the Emitted Bytes graph was named Sink Byte Traffic. If you want to customize charts, including how metrics are named, use the Custom Chart debug page.

DB Console Emitted Bytes Graph showing the time and emitted bites

Metric Description
Emitted Bytes The number of bytes emitted by CockroachDB into the configured changefeed sinks.

Sink Counts

This graph displays data relating to the number of messages and flushes at the changefeed sink.

  • The number of messages that CockroachDB sent to the sink.
  • The number of flushes that the sink performed for changefeeds.

DB Console Sink Counts graph

Metric Description
Messages The number of messages that CockroachDB sent to the downstream sink.
Flushes The total number of flushes to the sink.

Max Checkpoint Latency

This graph displays the most any changefeed's persisted checkpoint is behind the present time. Larger values indicate issues with successfully ingesting or emitting changes. If errors cause a changefeed to restart, or the changefeed is paused and unpaused, emitted data up to the last checkpoint may be re-emitted.


In v23.1 and earlier, the Max Checkpoint Latency graph was named Max Changefeed Latency. If you want to customize charts, including how metrics are named, use the Custom Chart debug page.

DB Console Max Checkpoint Latency graph


The maximum checkpoint latency is distinct from, and slower than, the commit latency for individual change messages. For more information about resolved timestamps, refer to the Changefeed Messages page.

Changefeed Restarts

This graph displays the number of times changefeeds restarted due to retryable errors.

DB Console Changefeed Restarts graph

Metric Description
Retryable Errors The number of retryable errors that changefeeds are encountering. That is, an error the changefeed will automatically retry.

Oldest Protected Timestamp

New in v23.2: This graph displays the oldest protected timestamp of any running changefeed on the cluster.

DB Console Oldest Protected Timestamp graph

Metric Description
Protected Timestamp Age The age of the oldest protected timestamp (of any changefeed) that is protecting data from being garbage collected.

Backfill Pending Ranges

New in v23.2: This graph displays the number of ranges being backfilled that are yet to enter the changefeed pipeline. An initial scan or schema change can cause a backfill.

DB Console Backfill Pending Ranges graph

Metric Description
Backfill Pending Ranges The number of ranges in the backfill process that have not yet entered the changefeed stream.

Schema Registry Registrations

New in v23.2: This graph displays the rate of schema registration requests made by CockroachDB nodes to a configured schema registry endpoint. For example, a Kafka sink pointing to a Confluent Schema Registry.

DB Console Schema Registry Registrations graph

Metric Description
Schema Registry Registrations The number of registrations to a downstream schema registry.

Ranges in catchup mode

This graph displays the total number of ranges with an active rangefeed that is performing a catchup scan.

DB Console Ranges in Catchup Mode graph

Metric Description
Ranges The number of ranges that are performing a catchup scan.

Rangefeed Catchup Scans Duration

This graph displays the duration of catchup scans that changefeeds are performing.

DB Console Rangefeed Catchup Scans Duration graph

Metric Description
(Node Hostname) The duration of the catchup scan displayed per node.

Summary and events

Summary panel

A Summary panel of key metrics is displayed to the right of the timeseries graphs.

Metric Description
Total Nodes The total number of nodes in the cluster. Decommissioned nodes are not included in this count.
Capacity Used The storage capacity used as a percentage of usable capacity allocated across all nodes.
Unavailable Ranges The number of unavailable ranges in the cluster. A non-zero number indicates an unstable cluster.
Queries per second The total number of SELECT, UPDATE, INSERT, and DELETE queries executed per second across the cluster.
P99 Latency The 99th percentile of service latency.

If you are testing your deployment locally with multiple CockroachDB nodes running on a single machine (this is not recommended in production), you must explicitly set the store size per node in order to display the correct capacity. Otherwise, the machine's actual disk capacity will be counted as a separate store for each node, thus inflating the computed capacity.

Events panel

Underneath the Summary panel, the Events panel lists the 5 most recent events logged for all nodes across the cluster. To list all events, click View all events.

DB Console Events

The following types of events are listed:

  • Database created
  • Database dropped
  • Table created
  • Table dropped
  • Table altered
  • Index created
  • Index dropped
  • View created
  • View dropped
  • Schema change reversed
  • Schema change finished
  • Node joined
  • Node decommissioned
  • Node restarted
  • Cluster setting changed

See also

Yes No
On this page

Yes No