View Clusters Page
After logging in to the CockroachDB Cloud Console, the Clusters page displays all clusters in your organization. For each cluster, you can see:- Cluster name and status
- Plan type (Basic, Standard, or Advanced)
- Cloud provider and regions
- Version of CockroachDB
- Creation date
- Resource usage
View Cluster Overview
The Overview page provides detailed information about your cluster:- Health Status: Current cluster state and any alerts
- Connection Info: Quick access to connection strings
- Cluster Configuration: Cloud provider, regions, and capacity
- Resource Usage: CPU, storage, and request units
- Recent Activity: Backups, upgrades, and changes
Manage Cluster Regions
Add a Region
You can add regions to increase availability and bring data closer to users.Navigate to Cluster Settings
- Go to your cluster’s Overview page
- In the Cluster settings section, click the pencil icon next to Regions
Select New Region
- Click Add Region
- Select the desired region from the dropdown
- Review the updated cost estimate
Scale Cluster Capacity
Scaling options vary by cluster plan.Scale Standard Cluster Capacity
Access Capacity Settings
- Navigate to cluster’s Overview page
- In the Capacity section, click Update capacity
Adjust Capacity
Use the slider or enter a value to set vCPUs:
- Minimum: 4 vCPUs
- Recommended: 40% above peak workload
- You can increase anytime
- You can decrease 3 times per 7 days
Scale Advanced Cluster
For Advanced clusters, you can scale nodes and storage independently. Add Nodes:Add Nodes
- Click Add nodes
- Select region(s) to add nodes
- Specify number of nodes per region
- Review cost impact
Increase Storage
- Enter new storage amount (per node)
- You can only increase, not decrease
- Review cost estimate
Basic clusters scale automatically based on usage. No manual scaling needed.
Manage Cluster Upgrades
CockroachDB Cloud regularly releases new versions with improvements and fixes.Automatic Major Version Upgrades
By default, clusters automatically upgrade to new major versions. How it works:- Clusters upgrade to early production patches (e.g.,
vXX.Y.1) - You receive advance notification via email and Console banner
- Upgrades are finalized immediately (cannot be rolled back)
- Cluster remains operational during upgrade
Manual Major Version Upgrades
You can opt for manual control over major version upgrades.Enable Manual Upgrades
- Navigate to cluster’s Overview page
- Click Actions > Manual upgrade settings
- Toggle Manual upgrades to On
- Click Apply
Upgrade When Ready
When a new version is available:
- Go to cluster Overview page
- Click Upgrade button
- Select target version
- Review upgrade notes
- Click Start upgrade
Patch Version Upgrades
Patch versions (e.g.,v23.1.12 to v23.1.13) are applied automatically:
- No action required
- Applied during maintenance windows
- Typically no downtime
- Notifications sent before and after
Configure Maintenance Windows
Control when cluster maintenance occurs.Set Window
- Select day of week
- Select start time (in your timezone)
- Maintenance window is 6 hours long
Change Cluster Plan
You can migrate between plans under certain conditions.Upgrade from Basic to Standard
Upgrade from Standard/Basic to Advanced
Migrating to Advanced requires creating a new cluster and migrating data. Contact Support for assistance.
Enable Deletion Protection
Prevent accidental cluster deletion.
Clusters with deletion protection enabled cannot be deleted until protection is disabled.
Delete a Cluster
For Standard clusters, you’re only billed while the cluster is running. Delete clusters when not in use to avoid charges.
Organize with Labels
Use labels to organize and track clusters.
Labels appear in:
- Cluster lists
- Billing reports
- API responses
- Audit logs
Use Folders
Organize clusters into folders (Preview feature).
Benefits:
- Organized cluster management
- Grouped billing
- Inherited permissions
- Hierarchical structure
Backup and Restore
All CockroachDB Cloud clusters have automatic managed backups.- Basic: Daily backups, 30-day retention
- Standard: Configurable frequency and retention
- Advanced: Configurable frequency, retention, and self-managed options
For more details, see Backup and Restore.
Monitor Cluster Health
Monitor your cluster’s health and performance:- Overview Page: Quick health status
- Metrics: Detailed performance charts
- SQL Activity: Query performance and insights
- Alerts: Automatic notifications for issues
Troubleshooting
Cluster Not Responding
- Check cluster status on Overview page
- Verify network connectivity
- Review recent changes or upgrades
- Check IP allowlist configuration
- Contact Support if issue persists
Performance Issues
- Review Metrics page for resource utilization
- Check for slow queries in SQL Activity
- Consider scaling capacity
- Review Insights for optimization recommendations
Upgrade Failures
- Check upgrade status on Overview page
- Review error messages
- Roll back if within 72-hour window (manual upgrades)
- Contact Support for assistance
Next Steps
Scaling Guide
Learn how to scale your cluster
Monitoring
Set up cluster monitoring
Backup & Restore
Configure backups
Performance
Optimize performance