mirror of
https://github.com/VictoriaMetrics/VictoriaMetrics.git
synced 2024-11-23 12:31:07 +01:00
README.md: mention that delete API
shouldnt be used on a regular basis due to non-zero overhead
This commit is contained in:
parent
c97ade4487
commit
04363d6511
14
README.md
14
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://<victoria-metrics-addr>:8428/api/v1/series?match[]=<timeseries_selector_for_delete>`
|
It is recommended verifying which metrics will be deleted with the call to `http://<victoria-metrics-addr>:8428/api/v1/series?match[]=<timeseries_selector_for_delete>`
|
||||||
before actually deleting the metrics.
|
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?
|
### How to export time series?
|
||||||
|
|
||||||
@ -815,6 +828,7 @@ The most interesting metrics are:
|
|||||||
|
|
||||||
### Backfilling
|
### Backfilling
|
||||||
|
|
||||||
|
VictoriaMetrics accepts historical data in arbitrary order of time.
|
||||||
Make sure that configured `-retentionPeriod` covers timestamps for the backfilled data.
|
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
|
It is recommended disabling query cache with `-search.disableCache` command-line flag when writing
|
||||||
|
@ -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).
|
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)
|
* [Wix.com](https://github.com/VictoriaMetrics/VictoriaMetrics/wiki/CaseStudies#wixcom)
|
||||||
* [Wedos.com](https://github.com/VictoriaMetrics/VictoriaMetrics/wiki/CaseStudies#wedoscom)
|
* [Wedos.com](https://github.com/VictoriaMetrics/VictoriaMetrics/wiki/CaseStudies#wedoscom)
|
||||||
* [Dreamteam](https://github.com/VictoriaMetrics/VictoriaMetrics/wiki/CaseStudies#dreamteam)
|
* [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://<victoria-metrics-addr>:8428/api/v1/series?match[]=<timeseries_selector_for_delete>`
|
It is recommended verifying which metrics will be deleted with the call to `http://<victoria-metrics-addr>:8428/api/v1/series?match[]=<timeseries_selector_for_delete>`
|
||||||
before actually deleting the metrics.
|
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?
|
### How to export time series?
|
||||||
|
|
||||||
@ -803,6 +818,7 @@ The most interesting metrics are:
|
|||||||
|
|
||||||
### Backfilling
|
### Backfilling
|
||||||
|
|
||||||
|
VictoriaMetrics accepts historical data in arbitrary order of time.
|
||||||
Make sure that configured `-retentionPeriod` covers timestamps for the backfilled data.
|
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
|
It is recommended disabling query cache with `-search.disableCache` command-line flag when writing
|
||||||
|
Loading…
Reference in New Issue
Block a user