CockroachDB

Search CockroachDB pages

Integrations

CockroachDB

Monitor CockroachDB CPU, memory, storage, network, cluster, SQL, and transaction performance metrics.

Guides

Guides overview 1 page

CockroachDB Operations Guides

Practical guides for running, troubleshooting, and monitoring CockroachDB in production.

CockroachDB Operations Guides 30 pages

Open the CockroachDB Operations Guides hub

CockroachDB Backup Job Failures: How To Fix Them

How to detect, diagnose, and fix CockroachDB backup failures before they breach your RPO, including stuck jobs and growing backup durations.

CockroachDB certificate expired: TLS handshake failures and online rotation

Detect, diagnose, and recover from expired CockroachDB TLS certificates using online rotation via SIGHUP.

CockroachDB changefeed lag: changefeed_max_behind_nanos and the GC time bomb

Diagnose and fix CockroachDB changefeed lag before protected timestamps block MVCC garbage collection and fill your disk.

CockroachDB clock skew cascade: how shared NTP drift causes quorum loss

Diagnose and resolve CockroachDB clock skew cascades where shared NTP drift causes multiple node self-terminations and quorum loss.

CockroachDB clock synchronization error: this node is more than 500ms away from at least half of the known nodes

Diagnose and fix the CockroachDB clock synchronization error that causes nodes to self-terminate when clock drift exceeds the max-offset threshold.

CockroachDB clock_offset_meannanos high: catching clock drift before self-termination

How to diagnose and prevent high clock_offset_meannanos in CockroachDB before clock drift causes node self-termination and quorum loss.

CockroachDB compaction backlog growing: when Pebble can't keep pace with writes

Diagnose a growing Pebble compaction backlog in CockroachDB before it triggers write stalls, and learn how to restore balance between write ingestion and compaction throughput.

CockroachDB connection storm after failover: reconnect stampedes and surviving-node overload

Diagnose and mitigate reconnect stampedes that overload surviving CockroachDB nodes after failover, with metrics, quick checks, and client pool tuning.

CockroachDB consistency check failed: checksum mismatches and confirmed corruption

Operational reference for diagnosing and responding to CockroachDB consistency check failures, checksum mismatches, and confirmed data corruption.

CockroachDB context deadline exceeded: timeouts, slow ranges, and overload

Diagnose CockroachDB context deadline exceeded errors by tracing KV exec latency, round-trip latency, L0 sublevels, and admission control queues to find the slow layer.

CockroachDB CPU saturation: Raft ticking, SQL execution, and the per-node ceiling

Diagnose CockroachDB CPU saturation by separating Raft tick overhead, SQL execution, GC pressure, and I/O-bound system time from cluster-wide averages.

CockroachDB detecting hot ranges: per-range QPS, CPU asymmetry, and the Hot Ranges page

How to detect hot ranges in CockroachDB using per-node CPU asymmetry and the DB Console Hot Ranges/Top Ranges page.

CockroachDB disk stall detected: storage_disk_stalled and node self-termination

Diagnose and resolve CockroachDB storage_disk_stalled alerts before the node self-terminates to prevent data inconsistency.

CockroachDB error 53200: SQL memory budget exhausted and query rejection

Diagnose and fix CockroachDB error 53200 when per-node SQL memory budget exhaustion causes query rejection or disk spills.

CockroachDB LSM compaction death spiral: L0 sublevels, read amplification, and write stalls

Diagnose and break the LSM compaction death spiral in CockroachDB by monitoring L0 sublevels, read amplification, and write stalls before nodes lose leases.

CockroachDB memory pressure, GC thrashing, and Raft liveness failure

Diagnose and resolve the cycle where Go heap growth triggers long GC pauses, node liveness loss, and oscillating cluster availability.

CockroachDB monitoring checklist: the signals every production cluster needs

A production monitoring reference for CockroachDB covering the signals every cluster needs, organized by maturity level from survival to expert.

CockroachDB node liveness failure: heartbeats, lease redistribution, and flapping

Diagnose and fix CockroachDB node liveness failures, from disk stalls and GC pauses to network partitions and flapping availability.

CockroachDB out of memory: sys_rss, --cache, --max-sql-memory, and the OOM killer

Diagnose CockroachDB OOM kills by tracking sys_rss, CGo allocations, SQL memory budget, and the sizing relationship between --cache, --max-sql-memory, and container limits.

CockroachDB Pebble write stalls: when the storage engine refuses writes

Diagnose and resolve CockroachDB Pebble write stalls when the storage engine pauses writes due to LSM compaction debt.

CockroachDB ReadWithinUncertaintyInterval restarts: the near-diagnostic signal of clock skew

Diagnose and resolve ReadWithinUncertaintyInterval restarts in CockroachDB, the near-diagnostic signal of clock skew between nodes.

CockroachDB replica unavailable: lost quorum and stuck Raft groups

Diagnose and resolve CockroachDB replica unavailable errors, lost Raft quorum, and stuck Raft groups causing range unavailability.

CockroachDB result is ambiguous: ambiguous commit errors and how to handle them

Diagnose and handle CockroachDB result is ambiguous errors (code 40003), from leaseholder changes to network timeouts, with practical retry and idempotency guidance.

CockroachDB RETRY_WRITE_TOO_OLD: the most common contention restart and how to kill it

Diagnose and eliminate CockroachDB writetooold transaction restarts caused by hot keys, sequential writes, and wide transactions under SERIALIZABLE isolation.

CockroachDB SQL error rate: XX000 internal errors and error-code triage

Triage CockroachDB SQL error rates by PostgreSQL error code, distinguish XX000 internal errors from retriable failures, and know when to page.

CockroachDB store is full: emergency disk recovery and why deletes don't free space

Emergency recovery procedures when CockroachDB stores run out of disk space, and why SQL DELETE operations do not immediately reclaim space.

CockroachDB too many connections: sql_conns, pooling, and goroutine pressure

Diagnose and resolve connection pressure in CockroachDB using sql_conns, goroutine counts, and file descriptor metrics before they cascade into node failure.

CockroachDB TransactionRetryWithProtoRefreshError: RETRY_SERIALIZABLE causes and fixes

Diagnose and fix CockroachDB RETRY_SERIALIZABLE errors by distinguishing writetooold, readwithinuncertainty, and txnpush causes and implementing proper retry logic.

CockroachDB under-replicated ranges: ranges_underreplicated and the healing margin

Diagnosing CockroachDB under-replicated ranges, understanding the healing margin, and configuring alerting that separates expected recovery from dangerous fault tolerance loss.

How To Fix CockroachDB Admission Control Throttling

Diagnose CockroachDB admission control throttling across its five queues, correlate store-write depth with LSM health, and determine when queuing is protective versus capacity-limiting.

Academy

CockroachDB Monitoring

Learn everything about monitoring & troubleshooting CockroachDB, what metrics are important to monitor and why, and how to monitor CockroachDB with Netdata.

Resources

The 10 Best CockroachDB Monitoring Tools for 2026

Compare the 10 best CockroachDB monitoring tools for 2026: Netdata, Datadog, Grafana, Prometheus, DBmarlin and more, ranked on depth, alerting and pricing.

Blog

Database Performance Monitoring: 14+ DBs Supported

Slow queries, running operations, deadlocks, and errors for PostgreSQL, MySQL, MongoDB, SQL Server, Oracle, and more.

Why Netdata picked VerneMQ

Choosing Scalability and Reliability for Messaging Needs

Release 1.20: Kernel Monitoring & Infra-Wide Labels

Expanding Features for More Efficient System Observability