diff --git a/README.md b/README.md index 4bf520947..9108229ab 100644 --- a/README.md +++ b/README.md @@ -547,6 +547,19 @@ the deleted time series isn't freed instantly - it is freed during subsequent me It is recommended verifying which metrics will be deleted with the call to `http://:8428/api/v1/series?match[]=` before actually deleting the metrics. +The delete API is intended mainly for the following cases: + +- One-off deleting of accidentally written invalid (or undesired) time series. +- One-off deleting of user data due to [GDPR](https://en.wikipedia.org/wiki/General_Data_Protection_Regulation). + +It isn't recommended using delete API for the following cases, since it brings non-zero overhead: + +- Regular cleanups for unneded data. Just prevent writing unneeded data into VictoriaMetrics. +- Reducing disk space usage by deleting unneded time series. This doesn't work as expected, since the deleted + time series occupy disk space until the next merge operation, which can never occur. + +It is better using `-retentionPeriod` command-line flag for efficient pruning of old data. + ### How to export time series? @@ -815,6 +828,7 @@ The most interesting metrics are: ### Backfilling +VictoriaMetrics accepts historical data in arbitrary order of time. Make sure that configured `-retentionPeriod` covers timestamps for the backfilled data. It is recommended disabling query cache with `-search.disableCache` command-line flag when writing diff --git a/docs/Single-server-VictoriaMetrics.md b/docs/Single-server-VictoriaMetrics.md index 7c3587fce..d40e6ddcf 100644 --- a/docs/Single-server-VictoriaMetrics.md +++ b/docs/Single-server-VictoriaMetrics.md @@ -8,8 +8,10 @@ in [source code](https://github.com/VictoriaMetrics/VictoriaMetrics). Just downl Cluster version is available [here](https://github.com/VictoriaMetrics/VictoriaMetrics/tree/cluster). -## Case studies +## Case studies and talks +* [Adidas](https://github.com/VictoriaMetrics/VictoriaMetrics/wiki/CaseStudies#adidas) +* [COLOPL](https://github.com/VictoriaMetrics/VictoriaMetrics/wiki/CaseStudies#colopl) * [Wix.com](https://github.com/VictoriaMetrics/VictoriaMetrics/wiki/CaseStudies#wixcom) * [Wedos.com](https://github.com/VictoriaMetrics/VictoriaMetrics/wiki/CaseStudies#wedoscom) * [Dreamteam](https://github.com/VictoriaMetrics/VictoriaMetrics/wiki/CaseStudies#dreamteam) @@ -535,6 +537,19 @@ the deleted time series isn't freed instantly - it is freed during subsequent me It is recommended verifying which metrics will be deleted with the call to `http://:8428/api/v1/series?match[]=` before actually deleting the metrics. +The delete API is intended mainly for the following cases: + +- One-off deleting of accidentally written invalid (or undesired) time series. +- One-off deleting of user data due to [GDPR](https://en.wikipedia.org/wiki/General_Data_Protection_Regulation). + +It isn't recommended using delete API for the following cases, since it brings non-zero overhead: + +- Regular cleanups for unneded data. Just prevent writing unneeded data into VictoriaMetrics. +- Reducing disk space usage by deleting unneded time series. This doesn't work as expected, since the deleted + time series occupy disk space until the next merge operation, which can never occur. + +It is better using `-retentionPeriod` command-line flag for efficient pruning of old data. + ### How to export time series? @@ -803,6 +818,7 @@ The most interesting metrics are: ### Backfilling +VictoriaMetrics accepts historical data in arbitrary order of time. Make sure that configured `-retentionPeriod` covers timestamps for the backfilled data. It is recommended disabling query cache with `-search.disableCache` command-line flag when writing