From 7ab7ae79c7e5050003b42769d239333c1f7412fb Mon Sep 17 00:00:00 2001 From: Aliaksandr Valialkin Date: Thu, 3 Sep 2020 12:38:07 +0300 Subject: [PATCH] docs/Single-server-VictoriaMetrics.md: mention that `/api/v1/series` returns series for the last 5 minutes if `start` query arg is missing Updates https://github.com/VictoriaMetrics/VictoriaMetrics/issues/735 --- docs/Single-server-VictoriaMetrics.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/Single-server-VictoriaMetrics.md b/docs/Single-server-VictoriaMetrics.md index c100f73698..3a9c3ca3be 100644 --- a/docs/Single-server-VictoriaMetrics.md +++ b/docs/Single-server-VictoriaMetrics.md @@ -568,6 +568,8 @@ These handlers can be queried from Prometheus-compatible clients such as Grafana Additionally to unix timestamps and [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) VictoriaMetrics accepts relative times in `time`, `start` and `end` query args. For example, the following query would return data for the last 30 minutes: `/api/v1/query_range?start=-30m&query=...`. +VictoriaMetrics returns time series for the last 5 minutes from `/api/v1/series` if `start` query arg is missing there. + VictoriaMetrics accepts additional args for `/api/v1/labels` and `/api/v1/label/.../values` handlers. See [this feature request](https://github.com/prometheus/prometheus/issues/6178) for details: @@ -686,7 +688,7 @@ where `` may contain any [time series selector]( 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). -It is recommended verifying which metrics will be deleted with the call to `http://:8428/api/v1/series?match[]=` +It is recommended verifying which metrics will be deleted with the call to `http://:8428/api/v1/series?match[]=&start=1` before actually deleting the metrics. The `/api/v1/admin/tsdb/delete_series` handler may be protected with `authKey` if `-deleteAuthKey` command-line flag is set.