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.