Clarify retention in Parent with tiered storage examples (#21887)
Ralph Meijer committed
Mar 4, 2026 at 23:04 UTC
98faddf55c8f7c722198f4f35e8b5198e6163184
1 file changed
+8
-18
docs/deployment-guides/deployment-strategies.md
+8
-18
@@ -18,9 +18,6 @@ Check out our [configuration documentation](/docs/netdata-agent/configuration/RE
18
19
This example helps you make Children super lightweight by offloading work to Parents, minimizing resource usage on production systems.
20
21
-<details>
22
-<summary><strong>Click to see lightweight Child configuration</strong></summary><br/>
23
-
21
**Why minimize Child footprint?**
22
We don't recommend connecting Children to Cloud directly. This reduces the Netdata Agent footprint on your production systems, as some capabilities can be switched OFF for the Child and kept ON for the Parent.
23
@@ -74,16 +71,10 @@ Edit `stream.conf` on the Child using the [edit-config](/docs/netdata-agent/conf
71
72
**Perfect for:** IoT devices, containers, or any resource-constrained system.
73
77
-</details><br/>
74
75
### Parent with Tiered Storage
76
81
-This example helps you configure a Parent with intelligent storage tiers to store different time ranges at different resolutions.
82
-
83
-<details>
84
-<summary><strong>Click to see Parent with tiered storage configuration</strong></summary><br/>
85
-
86
-This example provides configuration for multiple [tiers of metrics storage](/src/database/README.md#tiers), for 10 Children with about 2k metrics each.
77
+This example helps you configure a Parent with multiple [tiers of metrics storage](/src/database/README.md#tiers) to store different time ranges at different resolutions, for 10 Children with about 2k metrics each. Retention in each tier is restricted both in time and storage space, whichever is met first. See [retention settings](/src/database/CONFIGURATION.md#retention-settings) for fine-tuning retention.
78
79
**What this gives you:**
80
@@ -105,17 +96,21 @@ Edit `netdata.conf` on the Parent using the [edit-config](/docs/netdata-agent/co
96
storage tiers = 3
97
dbengine page cache size = 1.4GiB
98
108
- # storage tier 0
99
+ # storage tier 0, 1 second resolution
100
update every = 1
101
dbengine tier 0 retention size = 12GiB
102
+ dbengine tier 0 retention time = 7d
103
112
- # storage tier 1
104
+ # storage tier 1, 60 seconds = 1 minute resolution
105
dbengine tier 1 update every iterations = 60
106
dbengine tier 1 retention size = 4GiB
107
+ dbengine tier 1 retention time = 1mo
108
116
- # storage tier 2
109
+ # storage tier 2, 60 * 60 seconds = 1 hour resolution
110
dbengine tier 2 update every iterations = 60
111
dbengine tier 2 retention size = 2GiB
112
+ dbengine tier 2 retention time = 1y
113
+
114
[ml]
115
# Enabled by default
116
# enabled = yes
@@ -137,15 +132,11 @@ Edit `stream.conf` on the Parent using the [edit-config](/docs/netdata-agent/con
132
133
**Perfect for:** Central monitoring servers with enough storage for historical data.
134
140
-</details><br/>
135
136
### Active-Active Parents
137
138
This example guides you through setting up active-active Parents that sync with each other for high availability.
139
146
-<details>
147
-<summary><strong>Click to see high availability configuration</strong></summary><br/>
148
-
140
:::info
141
142
- To set up active-active streaming between Parent 1 and Parent 2, Parent 1 needs to be instructed to stream data to Parent 2 and Parent 2 to stream data to Parent 1.
@@ -195,7 +186,6 @@ This example guides you through setting up active-active Parents that sync with
186
api key = API_KEY
187
```
188
198
-</details><br/>
189
190
## Further Reading
191