CockroachDB Cluster Throttled: License Expired or No Telemetry

How to fix it

// try these in order, the most common fix is first

1. FIX 1Check license status

   1. 01Run SHOW CLUSTER SETTING enterprise.license; and check the seconds_until_enterprise_license_expiry metric (0 = no license, negative = expired)
   Did this fix it? Yes No

2. FIX 2Renew or obtain a license

   Copy steps
   1. 01Enterprise Free: re-request a license on the Cockroach Labs site and set it with SET CLUSTER SETTING enterprise.license
   2. 02Enterprise: contact Cockroach Labs sales for a renewal key
   3. 03Set the telemetry/organization settings as the license requires
   Did this fix it? Yes No

3. FIX 3Restore telemetry

   Copy steps
   1. 01Allow outbound HTTPS from nodes to Cockroach Labs telemetry endpoints
   2. 02If your network is air-gapped, you need a paid Enterprise license (it never throttles)
   Did this fix it? Yes No

4. FIX 4Not eligible for Enterprise Free?

   Copy steps
   1. 01Companies over $10M annual revenue (including affiliates), governments, and hosted offerings for outside users need paid Enterprise
   2. 02Consider a Postgres-compatible open source alternative such as YugabyteDB
   Did this fix it? Yes No

Symptoms

Queries queue or time out; only about 5 open transactions allowed; license or telemetry warnings in logs and DB Console.

Why it happens

• C-01Enterprise Free license expired and was not renewed (throttles 30 days after expiry)
• C-02Trial license expired (throttles 7 days after expiry)
• C-03Cluster cannot send telemetry (firewall or air-gapped network); throttled after 7 days
• C-04Upgraded from an old Core version to 24.3 or later without applying a license (30-day grace after a patch upgrade)

// this guide also covers

• cockroachdb throttled
• cockroachdb license expired
• cockroachdb enterprise free renew
• cockroachdb telemetry required
• cockroachdb 5 concurrent transactions

Other CockroachDB errors

• CockroachDB 'restart transaction' Error (40001) Fix
• Why Is CockroachDB Slow? Slow Query Fixes
• CockroachDB Connection Refused / Cannot Connect Fix
• CockroachDB Node Down or Cluster Unavailable: Fix
• CockroachDB High Memory, CPU or OOM Crash Fix
• CockroachDB 'Not Supported' / Postgres Compatibility Errors Fix
• CockroachDB Cloud Bill Too High: How to Cut Costs
• How to Cancel or Downgrade CockroachDB Cloud