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.