VictoriaMetrics/docs/Quick-Start.md
Roman Khavronenko c6a8ebb11f
docs: update docs ordering and formatting (#1192)
The major change is adding `sort` directive to docs. For those docs which are copied
from internal packages `sort` is added via makefile command. For the rest it is added
manually since they're updated manually as well.

The rest of changes is connected with markdown formatting. For example, changing headers
in some files (`##` => `#`) makes navigation on .github.io to look better. This especially
useful for `changelog` docs.

Table of contents for `vmctl` is dropped, since we already have it autogenerated on .github.io.

No link changes expected. The corresponding PR to `cluster` branch will be made in follow-up PR.
2021-04-07 13:39:16 +03:00

2.2 KiB

sort
10

Quick Start

  1. If you run Ubuntu please run the snap install victoriametrics command to install and start VictoriaMetrics. Then read these docs. Otherwise you can download the latest VictoriaMetrics release from releases page, or Docker hub or build it from sources.

  2. This step isn't needed if you run VictoriaMetrics via snap install victoriametrics as described above. Otherwise, please run the binary or Docker image with your desired command-line flags. You can look at -help to see descriptions of all available flags and their default values. The default flag values should fit the majority of cases. The minimum required flags that must be configured are:

    • -storageDataPath - the path to directory where VictoriaMetrics stores your data.
    • -retentionPeriod - data retention.

    For example:

    ./victoria-metrics-prod -storageDataPath=/var/lib/victoria-metrics-data -retentionPeriod=3

    Check these instructions to configure VictoriaMetrics as an OS service. We recommended setting up VictoriaMetrics monitoring.

  3. Configure either vmagent or Prometheus to write data to VictoriaMetrics. We recommended using vmagent instead of Prometheus because it is more resource efficient. If you still prefer Prometheus see these instructions for details on how it may be properly configured.

  4. To configure Grafana to query VictoriaMetrics instead of Prometheus please see these instructions.

There is also cluster version and SaaS playground.