From dab9a63485f17316b76cc414d0b3f7ee2e2eb092 Mon Sep 17 00:00:00 2001 From: Aliaksandr Valialkin Date: Mon, 27 Jan 2020 18:44:21 +0200 Subject: [PATCH] docs/Single-server-VictoriaMetrics.md: update `Retention` section --- docs/Single-server-VictoriaMetrics.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/Single-server-VictoriaMetrics.md b/docs/Single-server-VictoriaMetrics.md index 560b9ea5c..4ebb8c763 100644 --- a/docs/Single-server-VictoriaMetrics.md +++ b/docs/Single-server-VictoriaMetrics.md @@ -85,6 +85,7 @@ Cluster version is available [here](https://github.com/VictoriaMetrics/VictoriaM - [Federation](#federation) - [Capacity planning](#capacity-planning) - [High availability](#high-availability) + - [Retention](#retention) - [Multiple retentions](#multiple-retentions) - [Downsampling](#downsampling) - [Multi-tenancy](#multi-tenancy) @@ -657,6 +658,16 @@ If you have Prometheus HA pairs with replicas `r1` and `r2` in each pair, then c to write data to `victoriametrics-addr-1`, while each `r2` should write data to `victoriametrics-addr-2`. +### Retention + +Retention is configured with `-retentionPeriod` command-line flag. For instance, `-retentionPeriod=3` means +that the data will be stored for 3 months and then deleted. +Data is split in per-month subdirectories inside `<-storageDataPath>/data/small` and `<-storageDataPath>/data/big` folders. +Directories for months outside the configured retention are deleted on the first day of new month. +In order to keep data according to `-retentionPeriod` max disk space usage is going to be `-retentionPeriod` + 1 month. +For example if `-retentionPeriod` is set to 1, data for January is deleted on March 1st. + + ### Multiple retentions Just start multiple VictoriaMetrics instances with distinct values for the following flags: