Skip to content

Commit 0fae42f

Browse files
[release-v2.7] Add basic cluster sizing for Tempo doc (#4670)
* Add basic cluster sizing for Tempo doc * Update docs/sources/tempo/setup/size.md (cherry picked from commit f947882) Co-authored-by: Kim Nylander <[email protected]>
1 parent aa086fe commit 0fae42f

File tree

1 file changed

+71
-0
lines changed

1 file changed

+71
-0
lines changed

docs/sources/tempo/setup/size.md

Lines changed: 71 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,71 @@
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

Comments
 (0)