ClickHouse Storage Regions
Before Release 7.5.0, when a Collector or an external device sends events to a (Event Upload) Worker, that worker will distribute events to all ClickHouse Data Nodes. Starting with Release 7.5.0, you can have storage separation, meaning that events from specific collectors/devices can be stored in specific ClickHouse Data Nodes, with no overlap.
To accomplish this:
-
You need to form ClickHouse Regions. Each ClickHouse Region includes
-
One or more Event Upload Workers
-
One or more ClickHouse Shards
Event Upload Workers and ClickHouse Shards must be non-overlapping across ClickHouse Regions.
-
-
You need to configure a Collector or an external device to send events to any Event Upload Worker of the region.
Step 1: Creating a ClickHouse Region
Make sure that you have already configured the ClickHouse Cluster and defined the Shards.
To configure a ClickHouse Region, take the following steps.
-
Navigate to Admin > Settings > Database > ClickHouse Regions.
-
If you have not configured any regions, you will see a Default Region that includes all Shards and Event Upload Workers. Click + to create a new ClickHouse Region configuration.
-
In the Name field, enter a name for the ClickHouse Region storage configuration.
-
From the Shards drop-down, select the shards belonging to the region. Click + to add more Shards for the region.
-
From the Event Upload Workers drop-down, select the event upload workers for the region. Click + to add more Event Upload Workers.
-
When done, click Save.
-
Click the Apply (
) icon to apply the saved changes.
Step 2: Configuring Collector to Forward Events to a Worker Belonging to a Region
If your Collectors are directly sending events to a Worker, then
-
For Service Provider deployments, navigate to Admin > Setup > Organization. For Enterprise deployments, navigate to Admin > Setup > Collector.
-
Select the Collector and click the Edit (
) icon. -
Set Event Worker to the IP address of an Event Upload Worker in the region. This will enable the Collector to send to the specific Workers in the Region.
-
Click Save.
If your Collectors are sending via a Load Balancer, then configure the Load Balancer so that Collectors events are only sent to the Workers in the Region.