From b030662e3e3a460a75ce7af77039cc708fbc666d Mon Sep 17 00:00:00 2001 From: Artem Navoiev Date: Tue, 1 Nov 2022 16:19:09 +0200 Subject: [PATCH] =?UTF-8?q?update=20multi-tenancy=20guide.=20Add=20infroma?= =?UTF-8?q?tion=20about=20Enterprise=20and=20Rete=E2=80=A6=20(#3285)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit docs: update multi-tenancy guide Add information about Enterprise and Retention Filters Signed-off-by: Artem Navoiev --- .../guide-vmcluster-multiple-retention-setup.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/docs/guides/guide-vmcluster-multiple-retention-setup.md b/docs/guides/guide-vmcluster-multiple-retention-setup.md index 9ae32e4995..1e0da4e5d7 100644 --- a/docs/guides/guide-vmcluster-multiple-retention-setup.md +++ b/docs/guides/guide-vmcluster-multiple-retention-setup.md @@ -14,7 +14,16 @@ to distinct sets of time series and/or [tenants](https://docs.victoriametrics.co Community version of VictoriaMetrics supports only one retention period via [-retentionPeriod](https://docs.victoriametrics.com/#retention) command-line flag. The following solution allows supporting multiple retentions for community version of VictoriaMetrics. -**Solution** +**Enterprise Solution** + +Enterprise version of VictoriaMetrics Single and Cluster support multi-retention from version [1.83.0](https://github.com/VictoriaMetrics/VictoriaMetrics/releases/tag/v1.83.0) via `-retentionFilters` command-line flag. For example: + +* VictoriaMetrics Single - `-retentionFilter='{env=~"dev|staging"}:30d' -retentionPeriod=1y` +* VictoriaMetrics Cluster - `-retentionFilter='{vm_account_id=~"42.*"}:1d' -retentionFilter='{env=~"dev|staging"}:3d' -retentionPeriod=4w`. Labels `vm_account_id` and `vm_project_id` can be used to specify tenant and project respectively. + +Multi-retention is explained in more detail in corresponding docs for [single-node](https://docs.victoriametrics.com/Single-server-VictoriaMetrics.html#multiple-retentions) and [cluster](https://docs.victoriametrics.com/Cluster-VictoriaMetrics.html#retention-filters) versions. + +**Open Source Solution** A multi-retention setup can be implemented by dividing a [victoriametrics cluster](https://docs.victoriametrics.com/Cluster-VictoriaMetrics.html) into logical groups with different retentions.