ClickPipes Benchmarks, Vertical Scaling FAQs, and additional pricing information

docs/cloud/manage/billing.md

@@ -472,17 +472,27 @@ For this reason, it uses dedicated compute replicas.
 
 #### What is the default number of replicas and their size? {#what-is-the-default-number-of-replicas-and-their-size}
 
-Each ClickPipe defaults to 1 replica that is provided with 2 GiB of RAM and 0.5 vCPU.
-This corresponds to **0.25** ClickHouse compute units (1 unit = 8 GiB RAM, 2 vCPUs).
+Each ClickPipe defaults to 1 replica that is provided with 512 MiB of RAM and 0.125 vCPU.
+This corresponds to **0.0625** ClickHouse compute units (1 unit = 8 GiB RAM, 2 vCPUs).
 
 #### What are the ClickPipes public prices? {#what-are-the-clickpipes-public-prices}
 
-- Compute: \$0.20 per unit per hour (\$0.05 per replica per hour)
+**Vertical Replica Sizes and Pricing:**
+
+| Replica Size | Compute Units | RAM | vCPU | Price per Hour |
+|---------------|---------------|-----|------|----------------|
+| Extra Small   | 0.0625         | 512 MiB | 0.125| $0.0125 |
+| Small         | 0.125         | 1 GiB | 0.25   | $0.025  |
+| Medium        | 0.25          | 2 GiB | 0.5 | $0.05     |
+| Large         | 0.5           | 4 GiB | 1.0    | $0.10  |
+| Extra Large   | 1.0           | 8 GiB | 2.0    | $0.20  |
+
+**Additional Pricing:**
 - Ingested data: \$0.04 per GB
 
 #### How does it look in an illustrative example? {#how-does-it-look-in-an-illustrative-example}
 
-The following examples assume a single replica unless explicitly mentioned.
+The following examples assume a single medium size replica unless explicitly mentioned.
 
 <table><thead>
   <tr>

docs/cloud/manage/jan2025_faq/_snippets/_clickpipes_faq.md

@@ -52,9 +52,9 @@ This corresponds to **0.25** ClickHouse compute units (1 unit = 8 GiB RAM, 2 vCP
 
 <summary>Can ClickPipes replicas be scaled?</summary>
 
-ClickPipes for streaming can be scaled horizontally
-by adding more replicas each with a base unit of **0.25** ClickHouse compute units.
-Vertical scaling is also available on demand for specific use cases (adding more CPU and RAM per replica).
+Yes, ClickPipes for streaming can be scaled both horizontally and vertically.
+Horizontal scaling adds more replicas to increase throughput, while vertical scaling increases the resources (CPU and RAM) allocated to each replica to handle more intensive workloads.
+Both can be done via the UI during the creation of the ClickPipe or later in the editing mode under "Settings" -> "Advanced Settings" -> "Scaling"
 
 </details>
 
@@ -142,4 +142,4 @@ The philosophy behind ClickPipes pricing is
 to cover the operating costs of the platform while offering an easy and reliable way to move data to ClickHouse Cloud.
 From that angle, our market analysis revealed that we are positioned competitively.
 
-</details>
+</details>

docs/integrations/data-ingestion/clickpipes/kafka/04_best_practices.md

@@ -130,3 +130,20 @@ This requires scaling to at least two consumers.
 Regardless number of running consumers, fault tolerance is available by design.
 If a consumer or its underlying infrastructure fails,
 the ClickPipe will automatically restart the consumer and continue processing messages.
+
+### Benchmarks {#benchmarks}
+
+Below are some informal benchmarks for ClickPipes for Kafka that can be used get a general idea of ClickPipes performance. It is important to know that many factors can impact performance including message size, data types, and data format. Your mileage may vary, and what we show here is not a guarantee of performance.
+
+Benchmark details:
+- We used production ClickHouse Cloud services with enough resources to ensure that throughput was not bottlenecked by the insert processing on the ClickHouse side.
+- The ClickHouse Cloud service, the Kafka cluster (Confluent Cloud), and the ClickPipe were all running in the same region (`us-east-2`).
+- The ClickPipe was configured with a single replica.
+- The sample data included nested data with a mix of UUID, String, and Int datatypes.
+  - Other datatypes, such as Floats, Decimals, and DateTime types may be less performant.
+- There was no appreciable difference in performance between compressed and uncompressed data.
+
+| Replica Size | Message Size | Data Format | Throughput |
+|---------------|-----------|-------------|-----------|
+| 1vcpu/4gb     | 1.6kb    |   JSON        | 63mb/s    |
+| 1vcpu/4gb    | 1.6kb    |   AVRO        | 99mb/s    |