Skip to content

Commit 415f59c

Browse files
committed
Update sizing-and-hardware-recommendations.md
1 parent 3ab5c20 commit 415f59c

File tree

1 file changed

+16
-16
lines changed

1 file changed

+16
-16
lines changed

docs/best-practices/sizing-and-hardware-recommendations.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -60,17 +60,17 @@ There is no standard CPU utilization target for ClickHouse. Utilize a tool such
6060

6161
### How many CPU cores should I use? {#how-many-cpu-cores-should-i-use}
6262

63-
The number of CPUs you should use depends on your workload. However, we generally recommend the following memory to CPU core ratios based on your CPU type:
63+
The number of CPUs you should use depends on your workload. However, we generally recommend the following memory-to-CPU-core ratios based on your CPU type:
6464

65-
- **[M-type](https://aws.amazon.com/ec2/instance-types/) (general purpose use cases):** 4:1 memory to CPU core ratio
66-
- **[R-type](https://aws.amazon.com/ec2/instance-types/#Memory_Optimized) (data warehousing use cases):** 8:1 memory to CPU core ratio
67-
- **[C-type](https://aws.amazon.com/ec2/instance-types/#Compute_Optimized) (compute-optimized use cases):** 2:1 memory to CPU core ratio
65+
- **[M-type](https://aws.amazon.com/ec2/instance-types/) (general purpose use cases):** 4 GB:1 memory-to-CPU-core ratio
66+
- **[R-type](https://aws.amazon.com/ec2/instance-types/#Memory_Optimized) (data warehousing use cases):** 8 GB:1 memory-to-CPU-core ratio
67+
- **[C-type](https://aws.amazon.com/ec2/instance-types/#Compute_Optimized) (compute-optimized use cases):** 2 GB:1 memory-to-CPU-core ratio
6868

6969
As an example, when using M-type CPUs, we recommend provisioning 100GB of memory per 25 CPU cores. To determine the amount of memory appropriate for your application, profiling your memory usage is necessary. You can read [this guide on debugging memory issues](/guides/developer/debugging-memory-issues) or use the [built-in observability dashboard](/operations/monitoring) to monitor ClickHouse.
7070

7171
## Memory {#memory}
7272

73-
Like your choice of CPU, your choice of memory to storage ratio and memory to CPU ratio is dependent on your use-case.
73+
Like your choice of CPU, your choice of memory-to-storage ratio and memory-to-CPU ratio is dependent on your use-case.
7474

7575
The required volume of RAM generally depends on:
7676
- The complexity of queries.
@@ -79,13 +79,13 @@ The required volume of RAM generally depends on:
7979
In general, however, the more memory you have, the faster your queries will run.
8080
If your use case is sensitive to price, lower amounts of memory will work as it is possible to enable settings ([`max_bytes_before_external_group_by`](/operations/settings/settings#max_bytes_before_external_group_by) and [`max_bytes_before_external_sort`](/operations/settings/settings#max_bytes_before_external_sort)) to allow spilling data to disk, but note that this may significantly affect query performance.
8181

82-
### What should the memory to storage ratio be? {#what-should-the-memory-to-storage-ratio-be}
82+
### What should the memory-to-storage ratio be? {#what-should-the-memory-to-storage-ratio-be}
8383

84-
For low data volumes, a 1:1 memory to storage ratio is acceptable but total memory should not be below 8GB.
84+
For low data volumes, a 1:1 memory-to-storage ratio is acceptable but total memory should not be below 8GB.
8585

86-
For use cases with long retention periods for your data or with high data volumes, we recommend a 1:100 to 1:130 memory to storage ratio. For example, 100GB of RAM per replica if you are storing 10TB of data.
86+
For use cases with long retention periods for your data or with high data volumes, we recommend a 1:100 to 1:130 memory-to-storage ratio. For example, 100GB of RAM per replica if you are storing 10TB of data.
8787

88-
For use cases with frequent access such as for customer-facing workloads, we recommend using more memory at a 1:30 to 1:50 memory to storage ratio.
88+
For use cases with frequent access such as for customer-facing workloads, we recommend using more memory at a 1:30 to 1:50 memory-to-storage ratio.
8989

9090
## Replicas {#replicas}
9191

@@ -154,11 +154,11 @@ To provide guidance (not recommendations), the following are example configurati
154154
<td>256GB</td>
155155
</tr>
156156
<tr>
157-
<td><strong>RAM to vCPU ratio</strong></td>
158-
<td>4:1</td>
157+
<td><strong>RAM-to-vCPU ratio</strong></td>
158+
<td>4 GB:1</td>
159159
</tr>
160160
<tr>
161-
<td><strong>RAM to disk ratio</strong></td>
161+
<td><strong>RAM-to-disk ratio</strong></td>
162162
<td>1:50</td>
163163
</tr>
164164
</table>
@@ -212,18 +212,18 @@ To provide guidance (not recommendations), the following are example configurati
212212
<td>256GB</td>
213213
</tr>
214214
<tr>
215-
<td><strong>RAM to vCPU ratio</strong></td>
216-
<td>6:1</td>
215+
<td><strong>RAM-to-vCPU ratio</strong></td>
216+
<td>6 GB:1</td>
217217
</tr>
218218
<tr>
219-
<td><strong>RAM to disk ratio</strong></td>
219+
<td><strong>RAM-to-disk ratio</strong></td>
220220
<td>1:60</td>
221221
</tr>
222222
</table>
223223

224224
## Further reading {#further-reading}
225225

226-
Below are published blog posts on architecture from companies using open-source ClickHouse:
226+
Below are published blog posts on architectures from companies using open-source ClickHouse:
227227

228228
- [Cloudflare](https://blog.cloudflare.com/http-analytics-for-6m-requests-per-second-using-clickhouse/?utm_source=linkedin&utm_medium=social&utm_campaign=blog)
229229
- [eBay](https://innovation.ebayinc.com/tech/engineering/ou-online-analytical-processing/)

0 commit comments

Comments
 (0)