This page applies to Scale and Enterprise services.
- Basic Tier: Basic services have a fixed size and can’t scale. If you use a Basic service and expect a traffic spike, upgrade your Cloud tier.
- Bring Your Own Cloud (BYOC): The steps below apply, but your services run in your own cloud account, so make sure your account has adequate quotas and capacity for the expected peak.
Upcoming peak: Black Friday and Cyber Monday 2026If you expect higher traffic around November 27 - 30, 2026, we recommend scaling up by November 20 and staying scaled up until December 1. If you’re planning to scale beyond the allowed number of replicas for a service, contact us by November 13 (see step 3 below).
Before the peak
- Set up monitoring and alerts to quickly detect any changes during the peak. Configure email and/or Slack notifications for scaling events, errors, and billing. If you use an external monitoring tool, connect it using the Prometheus endpoint and set alerts on CPU and memory utilization.
- Estimate your expected load: Look at how your services behaved during previous peaks, and estimate how much query and insert volume may increase. To see historical CPU and memory utilization for each replica, visit your service’s Infrastructure dashboard (Monitoring > Infrastructure) or see Handling spikes in workload.
-
Let us know about large scale-ups: If you plan to scale beyond the allowed number of replicas for a service, contact your account team or ClickHouse support at least two weeks before the peak. This helps us plan capacity with our cloud providers ahead of time. In your request, please include:
- Service name and region
- Target size (memory per replica and number of replicas)
- Start and end dates
Capacity is subject to availability from our cloud providers, so we can’t guarantee that a specific size will be available at a given time. Letting us know early gives us the best opportunity to secure it for you. - Scale up in advance: Scale up several days before the peak, not on the day it starts. This gives you time to confirm your service is running at the new size and to adjust if needed. You can change your service’s scaling settings in the ClickHouse Cloud console under Settings > Scaling, or with the ClickHouse Cloud API.
-
Review your autoscaling settings: If autoscaling is enabled for your service (vertical or horizontal), check your limits before the peak:
- Raise the minimum to keep capacity in place throughout the peak, instead of waiting for autoscaling to react.
- Raise the maximum so autoscaling has room to grow if load exceeds your estimate.
- Review idling. For latency-sensitive services, consider disabling idling during the peak so the service doesn’t need to wake up when traffic arrives.
- Review any scaling schedules. Scaling schedules take precedence over your autoscaling settings when they trigger. Pause or adjust any schedules that would scale your service(s) down during the peak, such as weekend or overnight scale-downs.
- Test at the new size: Once your service(s) are scaled up, run a load test where possible that simulates peak traffic. This helps confirm the new size is sufficient to handle the expected surge and allows for corrective action if needed.