|
| 1 | +--- |
| 2 | +title: Size the cluster |
| 3 | +menuTitle: Size the cluster |
| 4 | +description: Plan the size of your Tempo cluster. |
| 5 | +aliases: |
| 6 | + - /docs/tempo/deployment |
| 7 | + - /docs/tempo/deployment/deployment |
| 8 | + - /docs/tempo/setup/deployment |
| 9 | +weight: 250 |
| 10 | +--- |
| 11 | + |
| 12 | +# Size the cluster |
| 13 | + |
| 14 | +Resource requirements for your Grafana Tempo cluster depend on the amount and rate of data processed, retained, and queried. |
| 15 | + |
| 16 | +This document provides basic configuration guidelines that you can use as a starting point to help size your own deployment. |
| 17 | + |
| 18 | +{{< admonition type="note" >}} |
| 19 | +Tempo is under continuous development. These requirements can change with each release. |
| 20 | +{{< /admonition >}} |
| 21 | + |
| 22 | +## Factors impacting cluster sizing |
| 23 | + |
| 24 | +The size of the cluster you deploy depends on how many resources it needs for a given ingestion rate and retention: number of spans/time, average byte span size, rate of querying, and retention N days. |
| 25 | + |
| 26 | +Tracing instrumentation also effects your Tempo cluster requirements. |
| 27 | +Refer to [Best practices](https://grafana.com/docs/tempo/<TEMPO_VERSION>/getting-started/best-practices/) for suggestions on determining where to add spans, span length, and attributes. |
| 28 | + |
| 29 | +## Example sample cluster sizing |
| 30 | + |
| 31 | +Distributor: |
| 32 | + |
| 33 | +* 1 replica per every 10MB/s of received traffic |
| 34 | +* CPU: 2 cores |
| 35 | +* Mem: 2 GB |
| 36 | + |
| 37 | +Ingester: |
| 38 | + |
| 39 | +* 1 replica per every 3-5MB/s of received traffic. |
| 40 | +* CPU: 2.5 cores |
| 41 | +* Mem: 4-20GB, determined by trace composition |
| 42 | + |
| 43 | +Querier: |
| 44 | + |
| 45 | +* 1 replica per every 1-2MB/s of received traffic. |
| 46 | +* CPU: dependent on trace size and queries |
| 47 | +* Mem: 4-20GB, determined by trace composition and queries |
| 48 | +* This number of queriers should give good performance for typical search patterns and time ranges. Can scale up or down to fit the specific workload. |
| 49 | + |
| 50 | +Query-Frontend: |
| 51 | + |
| 52 | +* 2 replicas, for high availability |
| 53 | +* CPU: dependent on trace size and queries |
| 54 | +* Mem: 4-20GB, dependent on trace size and queries |
| 55 | + |
| 56 | +Compactor: |
| 57 | + |
| 58 | +* 1 replica per every 3-5 MB/s of received traffic. |
| 59 | +* CPU: 1 core (compactors are primarily I/O bound, therefore do not require much CPU) |
| 60 | +* Mem: 4-20GB, determined by trace composition |
| 61 | + |
| 62 | +## Performance tuning resources |
| 63 | + |
| 64 | +Refer to these documents for additional information on tuning your Tempo cluster: |
| 65 | + |
| 66 | +* [Monitor Tempo](https://grafana.com/docs/tempo/<TEMPO_VERSION>/operations/monitor/) |
| 67 | +* [Tune search performance](https://grafana.com/docs/tempo/<TEMPO_VERSION>/operations/backend_search/) |
| 68 | +* [Improve performance with caching](https://grafana.com/docs/tempo/<TEMPO_VERSION>/operations/caching/) |
| 69 | +* [Dedicated attribute columns](https://grafana.com/docs/tempo/<TEMPO_VERSION>/operations/dedicated_columns/) |
| 70 | + |
| 71 | +For information on more advanced system options, refer to [Manage advanced systems](https://grafana.com/docs/tempo/<TEMPO_VERSION>/operations/manage-advanced-systems/). |
0 commit comments