reviewing-cluster-health

Diagnose CockroachDB cluster health with read-only crdb_internal queries.

3|3|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/cockroachdb/claude-plugin --skill reviewing-cluster-health
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reviewing-cluster-health
Source: https://github.com/cockroachdb/claude-plugin/tree/main/skills/operations-and-lifecycle/reviewing-cluster-health
Command: npx skills add https://github.com/cockroachdb/claude-plugin --skill reviewing-cluster-health

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Performs a comprehensive health check of a CockroachDB cluster by gathering deployment context and applying tier-appropriate diagnostics to surface actionable insights.

Core Features & Use Cases

  • Tier-aware health checks across Self-Hosted, Advanced, BYOC, Standard, and Basic deployments.
  • SQL-based validation using crdb_internal views to assess node liveness, version consistency, storage, and replication health.
  • Generates a prioritized diagnostic report with remediation guidance for production readiness and post-incident verification.

Quick Start

Run the health check against your connected CockroachDB cluster to receive a tier-aware health report.

Frequently Asked Questions about reviewing-cluster-health

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check CockroachDB cluster health for production readiness?▼

Check CockroachDB cluster health by running read-only SQL diagnostics against crdb_internal views to assess node liveness, version consistency, storage, and replication health, generating a prioritized diagnostic report with remediation guidance.

Does CockroachDB health checking work across different deployment tiers like BYOC and Self-Hosted?▼

CockroachDB health checking applies tier-aware diagnostics across Self-Hosted, Advanced, BYOC, Standard, and Basic deployments to tailor health checks for node visibility, cloud environment, and workload characteristics.

What is the best way to diagnose node liveness and replication issues in CockroachDB?▼

Diagnose CockroachDB node liveness and replication issues using SQL-based validation against crdb_internal views, reviewing cluster settings to surface actionable insights and prioritized remediation steps.

Can I use SQL queries to verify CockroachDB cluster settings without causing downtime?▼

Yes, verify CockroachDB cluster settings using read-only health queries against crdb_internal views, ensuring your health checks gather deployment context and assess production readiness without causing downtime.

Why does my CockroachDB cluster need tier-aware diagnostics for post-incident verification?▼

CockroachDB clusters need tier-aware diagnostics for post-incident verification to accurately assess node visibility, storage, and replication health based on the specific cloud environment and workload characteristics of your deployment tier.

What cluster settings and crdb_internal views are reviewed during a CockroachDB health check?▼

A CockroachDB health check reviews cluster settings and queries crdb_internal views to validate node liveness, version consistency, storage capacity, and replication health, returning a prioritized diagnostic report with remediation guidance.