From ec48d022dfa8c9b401b1a26a531a87bf58ce123e Mon Sep 17 00:00:00 2001 From: Roman Khavronenko Date: Sun, 13 Mar 2022 15:56:01 +0200 Subject: [PATCH] docs: fix broken links (#2303) Signed-off-by: hagen1778 --- app/vmalert/README.md | 2 +- docs/CHANGELOG.md | 2 +- docs/Cluster-VictoriaMetrics.md | 2 +- docs/README.md | 21 ++++++++++++++++++ docs/Single-server-VictoriaMetrics.md | 21 ++++++++++++++++++ docs/operator/VictoriaMetrics-Operator.md | 27 +++++++++++------------ docs/operator/auth.MD | 2 +- docs/operator/backups.MD | 2 +- docs/vmalert.md | 2 +- 9 files changed, 61 insertions(+), 20 deletions(-) diff --git a/app/vmalert/README.md b/app/vmalert/README.md index 8820d563f..760413266 100644 --- a/app/vmalert/README.md +++ b/app/vmalert/README.md @@ -3,7 +3,7 @@ `vmalert` executes a list of the given [alerting](https://prometheus.io/docs/prometheus/latest/configuration/alerting_rules/) or [recording](https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/) rules against configured `-datasource.url`. For sending alerting notifications -vmalert relies on [Alertmanager]((https://github.com/prometheus/alertmanager)) configured via `-notifier.url` flag. +vmalert relies on [Alertmanager](https://github.com/prometheus/alertmanager) configured via `-notifier.url` flag. Recording rules results are persisted via [remote write](https://prometheus.io/docs/prometheus/latest/storage/#remote-storage-integrations) protocol and require `-remoteWrite.url` to be configured. Vmalert is heavily inspired by [Prometheus](https://prometheus.io/docs/alerting/latest/overview/) diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md index c99a41232..1a594224b 100644 --- a/docs/CHANGELOG.md +++ b/docs/CHANGELOG.md @@ -439,7 +439,7 @@ Released at 25-06-2021 * FEATURE: vmstorage: reduce memory usage on a system with many CPU cores under high ingestion rate. * BUGFIX: prevent from adding new samples to deleted time series after the rotation of the inverted index (the rotation is performed once per `-retentionPeriod`). See [this comment](https://github.com/VictoriaMetrics/VictoriaMetrics/issues/1347#issuecomment-861232136) for details. -* BUGFIX: vmstorage: reduce high disk write IO usage on systems with big number of CPU cores. The issue has been introduced in the release [v1.59.0](#v1590). See [this commit](aa9b56a046b6ae8083fa659df35dd5e994bf9115) and [this comment](https://github.com/VictoriaMetrics/VictoriaMetrics/issues/1338#issuecomment-863046999) for details. +* BUGFIX: vmstorage: reduce high disk write IO usage on systems with big number of CPU cores. The issue has been introduced in the release [v1.59.0](#v1590). See [this commit](https://github.com/VictoriaMetrics/VictoriaMetrics/commit/aa9b56a046b6ae8083fa659df35dd5e994bf9115) and [this comment](https://github.com/VictoriaMetrics/VictoriaMetrics/issues/1338#issuecomment-863046999) for details. * BUGFIX: vmstorage: prevent from incorrect stats collection when multiple concurrent queries execute the same tag filter. This may help reducing CPU usage under certain workloads. See [this issue](https://github.com/VictoriaMetrics/VictoriaMetrics/issues/1338). * BUGFIX: vmselect: return the last timestamp for the max / min value from `tmax_over_time(m[d])` and `tmin_over_time(m[d])` [MetricsQL functions](https://docs.victoriametrics.com/MetricsQL.html) as most users expect. See also [this issue](https://github.com/prometheus/prometheus/issues/8966). * BUGFIX: vmselect: return the expected value for `increase_pure()` [MetricsQL function](https://docs.victoriametrics.com/MetricsQL.html) after a gap in a time series. Previously incorrect too big value could be returned after the gap from `increase_pure()`. diff --git a/docs/Cluster-VictoriaMetrics.md b/docs/Cluster-VictoriaMetrics.md index 37cb90830..c937811bc 100644 --- a/docs/Cluster-VictoriaMetrics.md +++ b/docs/Cluster-VictoriaMetrics.md @@ -840,7 +840,7 @@ Below is the output for `/path/to/vmstorage -help`: ## VictoriaMetrics Logo -[Zip](VM_logo.zip) contains three folders with different image orientation (main color and inverted version). +[Zip](https://github.com/VictoriaMetrics/VictoriaMetrics/blob/master/VM_logo.zip) contains three folders with different image orientation (main color and inverted version). Files included in each folder: diff --git a/docs/README.md b/docs/README.md index bc50fbd59..6d950b239 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1455,6 +1455,27 @@ See the full description of flags [here](#list-of-command-line-flags). ## Data migration +### From VictoriaMetrics + +The simplest way to migrate data from one single-node (source) to another (destination), or from one vmstorage node +to another do the following: +1. Stop the VictoriaMetrics (source) with `kill -INT`; +2. Copy (via [rsync](https://en.wikipedia.org/wiki/Rsync) or any other tool) the entire folder specified +via `-storageDataPath` from the source node to the empty folder at the destination node. +3. Once copy is done, stop the VictoriaMetrics (destination) with `kill -INT` and verify that +its `-storageDataPath` points to the copied folder from p.2; +4. Start the VictoriaMetrics (destination). The copied data should be now available. + +Things to consider when copying data: +1. Data formats between single-node and vmstorage node aren't compatible and can't be copied. +2. Copying data folder means complete replacement of the previous data on destination VictoriaMetrics. + +For more complex scenarios like single-to-cluster, cluster-to-single, re-sharding or migrating only a fraction +of data - see [vmctl. Migrating data from VictoriaMetrics](https://docs.victoriametrics.com/vmctl.html#migrating-data-from-victoriametrics). + + +### From other systems + Use [vmctl](https://docs.victoriametrics.com/vmctl.html) for data migration. It supports the following data migration types: * From Prometheus to VictoriaMetrics diff --git a/docs/Single-server-VictoriaMetrics.md b/docs/Single-server-VictoriaMetrics.md index 4188db54b..f5dcf968f 100644 --- a/docs/Single-server-VictoriaMetrics.md +++ b/docs/Single-server-VictoriaMetrics.md @@ -1459,6 +1459,27 @@ See the full description of flags [here](#list-of-command-line-flags). ## Data migration +### From VictoriaMetrics + +The simplest way to migrate data from one single-node (source) to another (destination), or from one vmstorage node +to another do the following: +1. Stop the VictoriaMetrics (source) with `kill -INT`; +2. Copy (via [rsync](https://en.wikipedia.org/wiki/Rsync) or any other tool) the entire folder specified +via `-storageDataPath` from the source node to the empty folder at the destination node. +3. Once copy is done, stop the VictoriaMetrics (destination) with `kill -INT` and verify that +its `-storageDataPath` points to the copied folder from p.2; +4. Start the VictoriaMetrics (destination). The copied data should be now available. + +Things to consider when copying data: +1. Data formats between single-node and vmstorage node aren't compatible and can't be copied. +2. Copying data folder means complete replacement of the previous data on destination VictoriaMetrics. + +For more complex scenarios like single-to-cluster, cluster-to-single, re-sharding or migrating only a fraction +of data - see [vmctl. Migrating data from VictoriaMetrics](https://docs.victoriametrics.com/vmctl.html#migrating-data-from-victoriametrics). + + +### From other systems + Use [vmctl](https://docs.victoriametrics.com/vmctl.html) for data migration. It supports the following data migration types: * From Prometheus to VictoriaMetrics diff --git a/docs/operator/VictoriaMetrics-Operator.md b/docs/operator/VictoriaMetrics-Operator.md index df3318686..8cfbd10f9 100644 --- a/docs/operator/VictoriaMetrics-Operator.md +++ b/docs/operator/VictoriaMetrics-Operator.md @@ -6,25 +6,25 @@ sort: 1 ## Overview - Design and implementation inspired by [prometheus-operator](https://github.com/prometheus-operator/prometheus-operator). It's great a tool for managing monitoring configuration of your applications. VictoriaMetrics operator has api capability with it. +Design and implementation inspired by [prometheus-operator](https://github.com/prometheus-operator/prometheus-operator). It's great a tool for managing monitoring configuration of your applications. VictoriaMetrics operator has api capability with it. So you can use familiar CRD objects: `ServiceMonitor`, `PodMonitor`, `PrometheusRule` and `Probe`. Or you can use VictoriaMetrics CRDs: - `VMServiceScrape` - defines scraping metrics configuration from pods backed by services. - `VMPodScrape` - defines scraping metrics configuration from pods. - `VMRule` - defines alerting or recording rules. - `VMProbe` - defines a probing configuration for targets with blackbox exporter. -Besides, operator allows you to manage VictoriaMetrics applications inside kubernetes cluster and simplifies this process [quick-start](/Operator/quick-start.html) -With CRD (Custom Resource Definition) you can define application configuration and apply it to your cluster [crd-objects](/Operator/api.html). +Besides, operator allows you to manage VictoriaMetrics applications inside kubernetes cluster and simplifies this process [quick-start](https://docs.victoriametrics.com/operator/quick-start.html) +With CRD (Custom Resource Definition) you can define application configuration and apply it to your cluster [crd-objects](https://docs.victoriametrics.com/operator/api.html). - Operator simplifies VictoriaMetrics cluster installation, upgrading and managing. +Operator simplifies VictoriaMetrics cluster installation, upgrading and managing. - It has integration with VictoriaMetrics `vmbackupmanager` - advanced tools for making backups. Check backup [docs](/Operator/backups.html) +It has integration with VictoriaMetrics `vmbackupmanager` - advanced tools for making backups. Check backup [docs](https://docs.victoriametrics.com/operator/backups.html) ## Use cases - For kubernetes-cluster administrators, it simplifies installation, configuration and management for `VictoriaMetrics` application. The main feature of operator is its ability to delegate the configuration of applications monitoring to the end-users. +For kubernetes-cluster administrators, it simplifies installation, configuration and management for `VictoriaMetrics` application. The main feature of operator is its ability to delegate the configuration of applications monitoring to the end-users. - For applications developers, its great possibility for managing observability of applications. You can define metrics scraping and alerting configuration for your application and manage it with an application deployment process. Just define app_deployment.yaml, app_vmpodscrape.yaml and app_vmrule.yaml. That's it, you can apply it to a kubernetes cluster. Check [quick-start](/Operator/quick-start.html) for an example. +For applications developers, its great possibility for managing observability of applications. You can define metrics scraping and alerting configuration for your application and manage it with an application deployment process. Just define app_deployment.yaml, app_vmpodscrape.yaml and app_vmrule.yaml. That's it, you can apply it to a kubernetes cluster. Check [quick-start](/Operator/quick-start.html) for an example. ## Operator vs helm-chart @@ -33,18 +33,17 @@ VictoriaMetrics provides [helm charts](https://github.com/VictoriaMetrics/helm-c ## Configuration - Operator configured by env variables, list of it can be found at [link](/vars.html) +Operator configured by env variables, list of it can be found at [link](https://docs.victoriametrics.com/operator/vars.html) - It defines default configuration options, like images for components, timeouts, features. +It defines default configuration options, like images for components, timeouts, features. ## Kubernetes' compatibility versions -operator tested at kubernetes versions -from 1.16 to 1.22 +Operator tested at kubernetes versions from 1.16 to 1.22. - For clusters version below 1.16 you must use legacy CRDs from [path](config/crd/legacy) - and disable CRD controller with flag: `--controller.disableCRDOwnership=true` +For clusters version below 1.16 you must use legacy CRDs from [path](https://github.com/VictoriaMetrics/operator/tree/master/config/crd/legacy) +and disable CRD controller with flag: `--controller.disableCRDOwnership=true` ## Troubleshooting @@ -58,7 +57,7 @@ Error from server (Invalid): error when creating "release/crds/crd.yaml": Custom ## Development -- operator-sdk verson v1.0.0 + [https://github.com/operator-framework/operator-sdk] +- [operator-sdk](https://github.com/operator-framework/operator-sdk) version v1.0.0+ - golang 1.15 + - minikube or kind diff --git a/docs/operator/auth.MD b/docs/operator/auth.MD index 0288cb44b..30c1b8172 100644 --- a/docs/operator/auth.MD +++ b/docs/operator/auth.MD @@ -142,7 +142,7 @@ EOF ## Basic auth for targets -To authenticate a `VMServiceScrape`s over a metrics endpoint use [`basicAuth`](../api.html#basicauth) +To authenticate a `VMServiceScrape`s over a metrics endpoint use [`basicAuth`](https://docs.victoriametrics.com/operator/api.html#basicauth) ```yaml cat <