From ed1056d3c9e474a04cd632fae709efab0eb62047 Mon Sep 17 00:00:00 2001 From: Aliaksandr Valialkin Date: Fri, 28 Oct 2022 14:23:02 +0300 Subject: [PATCH] docs/Cluster-VictoriaMetrics.md: improve docs for `dns+srv` service discovery --- README.md | 12 ++++++++---- docs/Cluster-VictoriaMetrics.md | 12 ++++++++---- 2 files changed, 16 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index cbc6816232..d39c31e56e 100644 --- a/README.md +++ b/README.md @@ -203,11 +203,15 @@ Additionally, all the VictoriaMetrics components allow setting flag values via e [Entrprise version of VictoriaMetrics](https://docs.victoriametrics.com/enterprise.html) supports [dns+srv](https://en.wikipedia.org/wiki/SRV_record) names at `-storageNode` command-line flag passed to `vminsert` and `vmstorage`. In this case the provided `dns+srv` names are resolved into tcp addresses of `vmstorage` nodes to connect to. The list of discovered `vmstorage` nodes is automatically updated at `vminsert` and `vmstorage` -when it changes behind the corresponding `dns+srv` names. +when it changes behind the corresponding `dns+srv` names. The `dns+srv` names must be prefixed with `dns+srv:` prefix. -It is possible specifying multiple `dns+srv` names at `-storageNode`. In this case all these names are resolved to tcp addresses of `vmstorage` nodes to connect to. -The `dns+srv` names must be prefixed with `dns+srv:` prefix. For example, `-storageNode=dns+srv:vmstorage.srv.nodes` . It is OK to passe regular addresses -together with `dns+srv` addresses at `-storageNode`. +It is possible passing multiple `dns+srv` names to `-storageNode` command-line flag. In this case all these names are resolved to tcp addresses of `vmstorage` nodes to connect to. +For example, `-storageNode='dns+srv:vmstorage-hot' -storageNode='dns+srv:vmstorage-cold'` . + +It is OK to pass regular static `vmstorage` addresses together with `dns+srv` addresses at `-storageNode`. For example, +`-storageNode=vmstorage1,vmstorage2 -storageNode='dns+srv:vmstorage-autodiscovery'`. + +The currently discovered `vmstorage` nodes can be [monitored](#monitoring) vith `vm_rpc_vmstorage_is_reachable` and `vm_rpc_vmstorage_is_read_only` metrics. ## mTLS protection diff --git a/docs/Cluster-VictoriaMetrics.md b/docs/Cluster-VictoriaMetrics.md index 3a0e2f1614..84cabc1ddb 100644 --- a/docs/Cluster-VictoriaMetrics.md +++ b/docs/Cluster-VictoriaMetrics.md @@ -207,11 +207,15 @@ Additionally, all the VictoriaMetrics components allow setting flag values via e [Entrprise version of VictoriaMetrics](https://docs.victoriametrics.com/enterprise.html) supports [dns+srv](https://en.wikipedia.org/wiki/SRV_record) names at `-storageNode` command-line flag passed to `vminsert` and `vmstorage`. In this case the provided `dns+srv` names are resolved into tcp addresses of `vmstorage` nodes to connect to. The list of discovered `vmstorage` nodes is automatically updated at `vminsert` and `vmstorage` -when it changes behind the corresponding `dns+srv` names. +when it changes behind the corresponding `dns+srv` names. The `dns+srv` names must be prefixed with `dns+srv:` prefix. -It is possible specifying multiple `dns+srv` names at `-storageNode`. In this case all these names are resolved to tcp addresses of `vmstorage` nodes to connect to. -The `dns+srv` names must be prefixed with `dns+srv:` prefix. For example, `-storageNode=dns+srv:vmstorage.srv.nodes` . It is OK to passe regular addresses -together with `dns+srv` addresses at `-storageNode`. +It is possible passing multiple `dns+srv` names to `-storageNode` command-line flag. In this case all these names are resolved to tcp addresses of `vmstorage` nodes to connect to. +For example, `-storageNode='dns+srv:vmstorage-hot' -storageNode='dns+srv:vmstorage-cold'` . + +It is OK to pass regular static `vmstorage` addresses together with `dns+srv` addresses at `-storageNode`. For example, +`-storageNode=vmstorage1,vmstorage2 -storageNode='dns+srv:vmstorage-autodiscovery'`. + +The currently discovered `vmstorage` nodes can be [monitored](#monitoring) vith `vm_rpc_vmstorage_is_reachable` and `vm_rpc_vmstorage_is_read_only` metrics. ## mTLS protection