From e465cf5d57af663f3bc6fe08d30965ceaefd150c Mon Sep 17 00:00:00 2001 From: Aliaksandr Valialkin Date: Mon, 5 Dec 2022 17:24:08 -0800 Subject: [PATCH] docs/vmctl.md: `make docs-sync` after 86c31f2955c291da5bb652bffa9e0d5bfd59c96e Updates https://github.com/VictoriaMetrics/VictoriaMetrics/issues/2930 --- docs/vmctl.md | 74 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 74 insertions(+) diff --git a/docs/vmctl.md b/docs/vmctl.md index 6f77c01f34..dbbaf6e2cd 100644 --- a/docs/vmctl.md +++ b/docs/vmctl.md @@ -837,6 +837,80 @@ Total: 16 B ↗ Speed: 186.32 KiB p/s 2022/08/30 19:48:24 Total time: 12.680582ms ``` +#### Cluster-to-cluster migration mode + +Using cluster-to-cluster migration mode helps to migrate all tenants data in a single `vmctl` run. + +Cluster-to-cluster uses `/admin/tenants` endpoint (available starting from [v1.84.0](https://docs.victoriametrics.com/CHANGELOG.html#v1840)) to discover list of tenants from source cluster. + +To use this mode you need to set `--vm-intercluster` flag to `true`, `--vm-native-src-addr` flag to 'http://vmselect:8481/' and `--vm-native-dst-addr` value to http://vminsert:8480/: + +```console +./bin/vmctl vm-native --vm-intercluster=true --vm-native-src-addr=http://localhost:8481/ --vm-native-dst-addr=http://172.17.0.3:8480/ +VictoriaMetrics Native import mode +2022/12/05 21:20:06 Discovered tenants: [123:1 12812919:1 1289198:1 1289:1283 12:1 1:0 1:1 1:1231231 1:1271727 1:12819 1:281 812891298:1] +2022/12/05 21:20:06 Initing export pipe from "http://localhost:8481/select/123:1/prometheus/api/v1/export/native" with filters: + filter: match[]={__name__!=""} +Initing import process to "http://172.17.0.3:8480/insert/123:1/prometheus/api/v1/import/native": +Total: 61.13 MiB ↖ Speed: 2.05 MiB p/s +Total: 61.13 MiB ↗ Speed: 2.30 MiB p/s +2022/12/05 21:20:33 Initing export pipe from "http://localhost:8481/select/12812919:1/prometheus/api/v1/export/native" with filters: + filter: match[]={__name__!=""} +Initing import process to "http://172.17.0.3:8480/insert/12812919:1/prometheus/api/v1/import/native": +Total: 43.14 MiB ↘ Speed: 1.86 MiB p/s +Total: 43.14 MiB ↙ Speed: 2.36 MiB p/s +2022/12/05 21:20:51 Initing export pipe from "http://localhost:8481/select/1289198:1/prometheus/api/v1/export/native" with filters: + filter: match[]={__name__!=""} +Initing import process to "http://172.17.0.3:8480/insert/1289198:1/prometheus/api/v1/import/native": +Total: 16.64 MiB ↗ Speed: 2.66 MiB p/s +Total: 16.64 MiB ↘ Speed: 2.19 MiB p/s +2022/12/05 21:20:59 Initing export pipe from "http://localhost:8481/select/1289:1283/prometheus/api/v1/export/native" with filters: + filter: match[]={__name__!=""} +Initing import process to "http://172.17.0.3:8480/insert/1289:1283/prometheus/api/v1/import/native": +Total: 43.33 MiB ↙ Speed: 1.94 MiB p/s +Total: 43.33 MiB ↖ Speed: 2.35 MiB p/s +2022/12/05 21:21:18 Initing export pipe from "http://localhost:8481/select/12:1/prometheus/api/v1/export/native" with filters: + filter: match[]={__name__!=""} +Initing import process to "http://172.17.0.3:8480/insert/12:1/prometheus/api/v1/import/native": +Total: 63.78 MiB ↙ Speed: 1.96 MiB p/s +Total: 63.78 MiB ↖ Speed: 2.28 MiB p/s +2022/12/05 21:21:46 Initing export pipe from "http://localhost:8481/select/1:0/prometheus/api/v1/export/native" with filters: + filter: match[]={__name__!=""} +Initing import process to "http://172.17.0.3:8480/insert/1:0/prometheus/api/v1/import/native": +2022/12/05 21:21:46 Import finished! +Total: 330 B ↗ Speed: 3.53 MiB p/s +2022/12/05 21:21:46 Initing export pipe from "http://localhost:8481/select/1:1/prometheus/api/v1/export/native" with filters: + filter: match[]={__name__!=""} +Initing import process to "http://172.17.0.3:8480/insert/1:1/prometheus/api/v1/import/native": +Total: 63.81 MiB ↙ Speed: 1.96 MiB p/s +Total: 63.81 MiB ↖ Speed: 2.28 MiB p/s +2022/12/05 21:22:14 Initing export pipe from "http://localhost:8481/select/1:1231231/prometheus/api/v1/export/native" with filters: + filter: match[]={__name__!=""} +Initing import process to "http://172.17.0.3:8480/insert/1:1231231/prometheus/api/v1/import/native": +Total: 63.84 MiB ↙ Speed: 1.93 MiB p/s +Total: 63.84 MiB ↖ Speed: 2.29 MiB p/s +2022/12/05 21:22:42 Initing export pipe from "http://localhost:8481/select/1:1271727/prometheus/api/v1/export/native" with filters: + filter: match[]={__name__!=""} +Initing import process to "http://172.17.0.3:8480/insert/1:1271727/prometheus/api/v1/import/native": +Total: 54.37 MiB ↘ Speed: 1.90 MiB p/s +Total: 54.37 MiB ↙ Speed: 2.37 MiB p/s +2022/12/05 21:23:05 Initing export pipe from "http://localhost:8481/select/1:12819/prometheus/api/v1/export/native" with filters: + filter: match[]={__name__!=""} +Initing import process to "http://172.17.0.3:8480/insert/1:12819/prometheus/api/v1/import/native": +Total: 17.01 MiB ↙ Speed: 1.75 MiB p/s +Total: 17.01 MiB ↖ Speed: 2.15 MiB p/s +2022/12/05 21:23:13 Initing export pipe from "http://localhost:8481/select/1:281/prometheus/api/v1/export/native" with filters: + filter: match[]={__name__!=""} +Initing import process to "http://172.17.0.3:8480/insert/1:281/prometheus/api/v1/import/native": +Total: 63.89 MiB ↘ Speed: 1.90 MiB p/s +Total: 63.89 MiB ↙ Speed: 2.29 MiB p/s +2022/12/05 21:23:42 Initing export pipe from "http://localhost:8481/select/812891298:1/prometheus/api/v1/export/native" with filters: + filter: match[]={__name__!=""} +Initing import process to "http://172.17.0.3:8480/insert/812891298:1/prometheus/api/v1/import/native": +Total: 63.84 MiB ↖ Speed: 1.99 MiB p/s +Total: 63.84 MiB ↗ Speed: 2.26 MiB p/s +2022/12/05 21:24:10 Total time: 4m4.1466565s +``` ## Verifying exported blocks from VictoriaMetrics