This guide provides a comprehensive overview of the core components, sizing guidelines, resource specifications, and architectural considerations crucial for scaling and capacity planning when deploying SigNoz. Use this information to plan the right deployment size and ensure your SigNoz installation is optimized for both present and future growth.
Components Overview
A SigNoz deployment consists of several key components, each with specific resource requirements. The following sections detail the configuration requirements for each component.
The following table outlines the resource requirements for all SigNoz components:
| Component | Replicas | CPU per Pod/Instance (cores) | Memory per Pod/Instance (GiB) | Node Count | Total CPU (cores) | Total Memory (GiB) |
|---|---|---|---|---|---|---|
| Collectors | 3 | 4 | 16 | 3 | 12 | 48 |
| ClickHouse | 2 shards | 16 | 32 (variable, based on data volume) | 2 | 32 | 64 (variable) |
| SigNoz Core | 1 | 4 | 8 | 1 | 4 | 8 |
| PostgreSQL | 1 | 2 | 8 | 1 | 2 | 8 |
| ZooKeeper | 3 | 2 | 8 | 3 | 6 | 24 |
Notes:
- Collectors: Scale with processing needs. More processors or pipelines will require more CPU. In very high-scale environments or if ClickHouse is throttling, allocate more memory to Collectors.
- ClickHouse: Ensure storage capacity is sized according to your retention policy and expected data volume. Plan for growth over time.
- SigNoz Core: Resource requirements vary based on component functionality and usage.
- PostgreSQL: Size according to metadata volume and query patterns. Managed database services (AWS RDS, GCP Cloud SQL, Azure Database for PostgreSQL) are recommended
- ZooKeeper: Required by ClickHouse for cluster operation; should have stable resource allocation.
Instance Types
These are the node types we suggest from various cloud providers. Please see the relevant specifications in the provider's documentation.
A family fixes the chip and the CPU-to-memory ratio; capacity comes from the size you pick inside it. Choose a size that meets or exceeds the per-component CPU and memory in the table above. The smallest size in each of these families falls short of what its workload needs: t3.nano gives you 2 vCPUs and 0.5 GiB, against the 4 vCPUs and 16 GiB each Collector needs.
For AWS:
- General Purpose workloads (Collectors, SigNoz Core, PostgreSQL, ZooKeeper): Any General Purpose machine available in your region that belongs to
T3instance family and above for Intel chips andT4ginstance family and above for ARM chips. - Compute-optimized workloads (ClickHouse): Any Compute Optimized machine available in your region that belongs to
C5instance family and above for Intel chips andC6gorC7ginstance family and above for ARM chips. - Smallest sizes that meet the table:
t3.xlargeort4g.xlarge(4 vCPUs, 16 GiB) for General Purpose workloads, andc5.4xlarge,c6g.4xlarge, orc7g.4xlarge(16 vCPUs, 32 GiB) for ClickHouse.
For GCP:
- General Purpose workloads (Collectors, SigNoz Core, PostgreSQL, ZooKeeper): Any General Purpose machine available in your region that belongs to
E2instance family and above. - Compute-optimized workloads (ClickHouse): Any machine available in your region that belongs to
C3orC3Dmachine series and above. GCP documents C3 and C3D under its general purpose machine family, so look for them there rather than under compute-optimized, which coversC2,C2D,H3, andH4D. - Smallest sizes that meet the table:
e2-standard-4(4 vCPUs, 16 GiB) for General Purpose workloads, andc3-highcpu-22(22 vCPUs, 44 GiB) for ClickHouse. C3 has no 16-vCPU shape, jumping from 8 to 22 vCPUs, andc3-standard-8carries only 8 vCPUs. GCP labels these same figuresGBin its machine type tables, defining 1 GB as 1,024 MB, so the numbers match the GiB values used here.
For Azure:
- General Purpose workloads (Collectors, SigNoz Core, PostgreSQL, ZooKeeper): Any General Purpose machine available in your region that belongs to the
Dsv5size series and above for Intel chips,Dasv5and above for AMD chips, orDpsv5and above for Arm chips. - Compute-optimized workloads (ClickHouse): Any Compute Optimized machine available in your region that belongs to the
Fsv2size series and above for Intel chips, orFasv6and above for AMD chips. Azure's compute-optimized F family has no Arm-based series, so use a general purposeDpsv5or later size if you want ClickHouse on Arm. - Smallest sizes that meet the table:
Standard_D4s_v5,Standard_D4as_v5, orStandard_D4ps_v5(4 vCPUs, 16 GiB) for General Purpose workloads, andStandard_F16s_v2(16 vCPUs, 32 GiB) orStandard_F16as_v6(16 vCPUs, 64 GiB) for ClickHouse.