```console
-curl -G 'http://localhost:8428/prometheus/api/v1/label/job/values'
+curl http://localhost:8428/prometheus/api/v1/label/job/values
```
-Cluster:
+Cluster version of VictoriaMetrics:
```console
-curl -G 'http://localhost:8428/prometheus/api/v1/query?query=vm_http_request_errors_total&time=2021-02-22T19:10:30.781Z'
+curl http://localhost:8428/prometheus/api/v1/query -d 'query=vm_http_request_errors_total'
```
-Cluster:
+Cluster version of VictoriaMetrics:
```console
-curl -G 'http://localhost:8428/prometheus/api/v1/query_range?query=vm_http_request_errors_total&start=2021-02-22T19:10:30.781Z&step=20m'
+curl http://localhost:8428/prometheus/api/v1/query_range -d 'query=sum(increase(vm_http_request_errors_total{job="foo"}[5m]))' -d 'start=-1d' -d 'step=1h'
```
-Cluster:
+Cluster version of VictoriaMetrics:
```console
-curl -G 'http://localhost:8428/prometheus/api/v1/series?match[]=vm_http_request_errors_total&start=-1h'
+curl http://localhost:8428/prometheus/api/v1/series -d 'match[]=vm_http_request_errors_total'
```
-Cluster:
+Cluster version of VictoriaMetrics:
```console
-curl -G 'http://localhost:8428/prometheus/api/v1/status/tsdb'
+curl http://localhost:8428/prometheus/api/v1/status/tsdb
```
-Cluster:
+Cluster version of VictoriaMetrics:
```console
@@ -447,25 +490,26 @@ echo '
Additional information:
* [How to send data from datadog agent](https://docs.victoriametrics.com/#how-to-send-data-from-datadog-agent)
+* [URL format for VictoriaMetrics cluster](https://docs.victoriametrics.com/Cluster-VictoriaMetrics.html#url-format)
## /federate
**Returns federated metrics**
-Single:
+Single-node VictoriaMetrics:
```console
-curl -G 'http://localhost:8428/federate?match[]=vm_http_request_errors_total&start=2021-02-22T19:10:30.781Z'
+curl http://localhost:8428/federate -d 'match[]=vm_http_request_errors_total'
```
-Cluster:
+Cluster version of VictoriaMetrics:
```console
-curl -G 'http://:8481/select/0/prometheus/federate?match[]=vm_http_request_errors_total&start=2021-02-22T19:10:30.781Z'
+curl http://:8481/select/0/prometheus/federate -d 'match[]=vm_http_request_errors_total'
```
@@ -474,60 +518,63 @@ Additional information:
* [Federation](https://docs.victoriametrics.com/#federation)
* [Prometheus-compatible federation data](https://prometheus.io/docs/prometheus/latest/federation/#configuring-federation)
+* [URL format for VictoriaMetrics cluster](https://docs.victoriametrics.com/Cluster-VictoriaMetrics.html#url-format)
## /graphite/metrics/find
**Searches Graphite metrics in VictoriaMetrics**
-Single:
+Single-node VictoriaMetrics:
```console
-curl -G 'http://localhost:8428/graphite/metrics/find?query=vm_http_request_errors_total'
+curl http://localhost:8428/graphite/metrics/find -d 'query=vm_http_request_errors_total'
```
-Cluster:
+Cluster version of VictoriaMetrics:
```console
-curl -G 'http://:8481/select/0/graphite/metrics/find?query=vm_http_request_errors_total'
+curl http://:8481/select/0/graphite/metrics/find -d 'query=vm_http_request_errors_total'
```
Additional information:
-* [Metrics find](https://graphite-api.readthedocs.io/en/latest/api.html#metrics-find)
-* [How to send data from graphite compatible agents such as statsd](https://docs.victoriametrics.com/Single-server-VictoriaMetrics.html#how-to-send-data-from-graphite-compatible-agents-such-as-statsd)
+* [Metrics find API in Graphite](https://graphite-api.readthedocs.io/en/latest/api.html#metrics-find)
+* [Graphite API in VictoriaMetrics](https://docs.victoriametrics.com/#graphite-api-usage)
+* [How to send Graphite data to VictoriaMetrics](https://docs.victoriametrics.com/Single-server-VictoriaMetrics.html#how-to-send-data-from-graphite-compatible-agents-such-as-statsd)
* [URL Format](https://docs.victoriametrics.com/Cluster-VictoriaMetrics.html#url-format)
## /influx/write
**Writes data with InfluxDB line protocol to VictoriaMetrics**
-Single:
+Single-node VictoriaMetrics:
```console
-curl -d 'measurement,tag1=value1,tag2=value2 field1=123,field2=1.23' -X POST 'http://localhost:8428/write'
+curl -d 'measurement,tag1=value1,tag2=value2 field1=123,field2=1.23' -X POST http://localhost:8428/write
```
-Cluster:
+Cluster version of VictoriaMetrics:
```console
-curl -d 'measurement,tag1=value1,tag2=value2 field1=123,field2=1.23' -X POST 'http://:8480/insert/0/influx/write'
+curl -d 'measurement,tag1=value1,tag2=value2 field1=123,field2=1.23' -X POST http://:8480/insert/0/influx/write
```
Additional information:
-* [How to send data from influxdb compatible agents such as telegraf](https://docs.victoriametrics.com/#how-to-send-data-from-influxdb-compatible-agents-such-as-telegraf)
+* [How to send Influx data to VictoriaMetrics](https://docs.victoriametrics.com/#how-to-send-data-from-influxdb-compatible-agents-such-as-telegraf)
+* [URL Format](https://docs.victoriametrics.com/Cluster-VictoriaMetrics.html#url-format)
## TCP and UDP
@@ -536,7 +583,7 @@ Additional information:
Turned off by default. Enable OpenTSDB receiver in VictoriaMetrics by setting `-opentsdbListenAddr` command-line flag.
*If run from docker, '-opentsdbListenAddr' port should be exposed*
-Single:
+Single-node VictoriaMetrics:
```console
@@ -545,7 +592,7 @@ echo "put foo.bar.baz `date +%s` 123 tag1=value1 tag2=value2" | nc -N localhost
-Cluster:
+Cluster version of VictoriaMetrics:
```console
@@ -556,7 +603,7 @@ echo "put foo.bar.baz `date +%s` 123 tag1=value1 tag2=value2 VictoriaMetrics_Ac
Enable HTTP server for OpenTSDB /api/put requests by setting `-opentsdbHTTPListenAddr` command-line flag.
-Single:
+Single-node VictoriaMetrics:
```console
@@ -565,36 +612,34 @@ curl -H 'Content-Type: application/json' -d '[{"metric":"foo","value":45.34},{"m
-Cluster:
+Cluster version of VictoriaMetrics:
```console
-curl -H 'Content-Type: application/json' -d '[{"metric":"foo","value":45.34},{"metric":"bar","value":43}]'
- 'http://:8480/insert/42/opentsdb/api/put'
+curl -H 'Content-Type: application/json' -d '[{"metric":"foo","value":45.34},{"metric":"bar","value":43}]' http://:8480/insert/42/opentsdb/api/put
```
Additional information:
-* [Api http put](http://opentsdb.net/docs/build/html/api_http/put.html)
-* [How to send data from opentsdb compatible agents](https://docs.victoriametrics.com/Single-server-VictoriaMetrics.html#how-to-send-data-from-opentsdb-compatible-agents)
+* [OpenTSDB http put API](http://opentsdb.net/docs/build/html/api_http/put.html)
+* [How to send data OpenTSDB data to VictoriaMetrics](https://docs.victoriametrics.com/Single-server-VictoriaMetrics.html#how-to-send-data-from-opentsdb-compatible-agents)
-**How to write data with Graphite plaintext protocol to VictoriaMetrics**
+**How to send Graphite data to VictoriaMetrics**
Enable Graphite receiver in VictoriaMetrics by setting `-graphiteListenAddr` command-line flag.
-Single:
+Single-node VictoriaMetrics:
```console
-echo "foo.bar.baz;tag1=value1;tag2=value2 123 `date +%s`" |
- nc -N localhost 2003
+echo "foo.bar.baz;tag1=value1;tag2=value2 123 `date +%s`" | nc -N localhost 2003
```
-Cluster:
+Cluster version of VictoriaMetrics:
```console
@@ -605,7 +650,7 @@ echo "foo.bar.baz;tag1=value1;tag2=value2;VictoriaMetrics_AccountID=42 123 `date
Additional information:
-`VictoriaMetrics_AccountID=42` - tag that indicated tenant ID.
+`VictoriaMetrics_AccountID=42` - [tenant ID](https://docs.victoriametrics.com/Cluster-VictoriaMetrics.html#multitenancy) in cluster version of VictoriaMetrics
-* [Request handler](https://github.com/VictoriaMetrics/VictoriaMetrics/blob/a3eafd2e7fc75776dfc19d3c68c85589454d9dce/app/vminsert/opentsdb/request_handler.go#L47)
-* [How to send data from graphite compatible agents such as statsd](https://docs.victoriametrics.com/Single-server-VictoriaMetrics.html#how-to-send-data-from-graphite-compatible-agents-such-as-statsd)
+* [How to send Graphite data to VictoriaMetrics](https://docs.victoriametrics.com/Single-server-VictoriaMetrics.html#how-to-send-data-from-graphite-compatible-agents-such-as-statsd)
+* [Multitenancy in cluster version of VictoriaMetrics](https://docs.victoriametrics.com/Cluster-VictoriaMetrics.html#multitenancy)