Alerts Page

On this page Carat arrow pointing down

The Alerts page allows you to enable email alerts, send test alerts, and view the email recipients and alert history for your CockroachDB Cloud organization. To view the Alerts page, log in and click Alerts.

Note:

The Alerts page is applicable for CockroachDB Dedicated clusters in your CockroachDB Cloud organization. For CockroachDB Serverless clusters in your organization, all Org Administrators automatically receive email alerts when your cluster reaches 50%, 75%, and 100% of your resource limits.

If alerts are enabled, CockroachDB Cloud sends alerts to specified email recipients when the following usage metrics are detected:

Cluster Maintenance:

  • When a cluster is scheduled for maintenance or a patch upgrade that could temporarily impact the cluster's performance.
  • When a cluster's CockroachDB version is nearing end of life and must be upgraded to maintain support.

Storage Utilization:

  • Cluster-wide available disk capacity is 20% or less.
  • Node-level available disk capacity is 10% or less.

CPU Utilization:

  • Cluster-wide CPU usage is 80% or greater on average for at least 60 minutes.
  • Node-level CPU usage is 90% or greater on average for at least 90 minutes.

Memory Utilization:

  • Cluster-wide available memory is 20% or less on average for at least 60 minutes.
  • Node-level available memory is 10% or less on average for at least 90 minutes.

CMEK:

  • Cluster node unable to start due to CMEK key access failure.

If you receive an alert repeatedly, you may need to optimize your workload or scale your CockroachDB Cloud cluster.

Org Administrators also receive email alerts when your cluster undergoes an automatic patch version upgrade.

Configure alerts

To enable alerts:

  1. Under Configure CockroachDB Cloud alerts, toggle the Alerts are on switch.
  2. Under Add Email Recipients, add at least one email address and click Add.

Alerts are enabled for all CockroachDB Dedicated clusters in your Organization.

Tip:

You can use an email alias to send alerts to a monitoring tool such as Alertmanager or PagerDuty.

Send a test alert

To send a test alert:

  1. Under Send test email, select a cluster and an alert type.
  2. Add at least one email address and click Add.
  3. Click Send test email.

Repeated alerts

If the condition triggering an alert does not change, the alert will repeat at a specific cadence:

Storage Utilization:

  • Cluster-wide alerts: every 60 minutes
  • Node-level alerts: every 60 minutes

CPU Utilization:

  • Cluster-wide alerts: every 60 minutes
  • Node-level alerts: every 90 minutes

Memory Utilization:

  • Cluster-wide alerts: every 60 minutes
  • Node-level alerts: every 90 minutes

Yes No
On this page

Yes No