From 03c55fa646f61f2ecae8970c709b9f7881c9078a Mon Sep 17 00:00:00 2001 From: Dmytro Kozlov Date: Tue, 1 Nov 2022 10:36:28 +0200 Subject: [PATCH] docs: clarify information about usage of the `api/v1/admin/tsdb/delete_series` API (#3287) docs: clarify information about usage of the `api/v1/admin/tsdb/delete_series` API --- docs/README.md | 6 ++++-- docs/Single-server-VictoriaMetrics.md | 6 ++++-- 2 files changed, 8 insertions(+), 4 deletions(-) diff --git a/docs/README.md b/docs/README.md index cc2ef665e4..f857a65060 100644 --- a/docs/README.md +++ b/docs/README.md @@ -873,8 +873,10 @@ Steps for restoring from a snapshot: Send a request to `http://:8428/api/v1/admin/tsdb/delete_series?match[]=`, where `` may contain any [time series selector](https://prometheus.io/docs/prometheus/latest/querying/basics/#time-series-selectors) -for metrics to delete. After that all the time series matching the given selector are deleted. Storage space for -the deleted time series isn't freed instantly - it is freed during subsequent [background merges of data files](https://medium.com/@valyala/how-victoriametrics-makes-instant-snapshots-for-multi-terabyte-time-series-data-e1f3fb0e0282). +for metrics to delete. Delete API doesn't support the deletion of specific time ranges, the series can only be deleted completely. +After using the API all the time series matching the given selector will be deleted. +Storage space for the deleted time series isn't freed instantly - it is freed during subsequent +[background merges of data files](https://medium.com/@valyala/how-victoriametrics-makes-instant-snapshots-for-multi-terabyte-time-series-data-e1f3fb0e0282). Note that background merges may never occur for data from previous months, so storage space won't be freed for historical data. In this case [forced merge](#forced-merge) may help freeing up storage space. diff --git a/docs/Single-server-VictoriaMetrics.md b/docs/Single-server-VictoriaMetrics.md index af101cd536..6c8e0e8339 100644 --- a/docs/Single-server-VictoriaMetrics.md +++ b/docs/Single-server-VictoriaMetrics.md @@ -876,8 +876,10 @@ Steps for restoring from a snapshot: Send a request to `http://:8428/api/v1/admin/tsdb/delete_series?match[]=`, where `` may contain any [time series selector](https://prometheus.io/docs/prometheus/latest/querying/basics/#time-series-selectors) -for metrics to delete. After that all the time series matching the given selector are deleted. Storage space for -the deleted time series isn't freed instantly - it is freed during subsequent [background merges of data files](https://medium.com/@valyala/how-victoriametrics-makes-instant-snapshots-for-multi-terabyte-time-series-data-e1f3fb0e0282). +for metrics to delete. Delete API doesn't support the deletion of specific time ranges, the series can only be deleted completely. +After using the API all the time series matching the given selector will be deleted. +Storage space for the deleted time series isn't freed instantly - it is freed during subsequent +[background merges of data files](https://medium.com/@valyala/how-victoriametrics-makes-instant-snapshots-for-multi-terabyte-time-series-data-e1f3fb0e0282). Note that background merges may never occur for data from previous months, so storage space won't be freed for historical data. In this case [forced merge](#forced-merge) may help freeing up storage space.