README.md

Victoria Metrics Helm Charts

This repository contains Victoria Metrics helm charts.

Add a chart helm repository

Access a Kubernetes cluster.

Add a chart helm repository with follow commands:

helm repo add vm https://victoriametrics.github.io/helm-charts/

helm repo update

List all charts and versions of vm repository available to installation:

for helm v3

helm search repo vm/

The command must display existing helm chart e.g.

NAME                          CHART VERSION APP VERSION DESCRIPTION
vm/victoria-metrics-agent     0.8.13       	v1.80.0     Victoria Metrics Agent - collects metrics from ...
vm/victoria-metrics-alert     0.4.36        	v1.80.0     Victoria Metrics Alert - executes a list of giv...
vm/victoria-metrics-auth      0.2.54       	1.80.0      Victoria Metrics Auth - is a simple auth proxy ...
vm/victoria-metrics-cluster   0.9.33        	1.80.0      Victoria Metrics Cluster version - high-perform...
vm/victoria-metrics-gateway   0.1.11        	1.80.0      Victoria Metrics Gateway - is a simple gateway ...
vm/victoria-metrics-k8s-stack 0.10.3        	1.80.0      Kubernetes monitoring on VictoriaMetrics stack....
vm/victoria-metrics-operator  0.9.0        	0.24.0      Victoria Metrics Operator
vm/victoria-metrics-single    0.8.34        	1.80.0      Victoria Metrics Single version - high-performa...

Installing the chart

Export default values of victoria-metrics-cluster chart to file values.yaml:

helm show values vm/victoria-metrics-cluster > values.yaml

Change the values according to the need of the environment in values.yaml file.

Test the installation with command:

helm install victoria-metrics vm/victoria-metrics-cluster -f values.yaml -n NAMESPACE --debug --dry-run

Install chart with command:

for helm v3

helm install victoria-metrics vm/victoria-metrics-cluster -f values.yaml -n NAMESPACE

Get the pods lists by running these commands:

kubectl get pods -A | grep 'victoria-metrics'

# or list all resorces of victoria-metrics

kubectl get all -n NAMESPACE | grep victoria

Get the application by running this commands:

helm list -f victoria-metrics -n NAMESPACE

See the history of versions of victoria-metrics application with command.

helm history victoria-metrics -n NAMESPACE

How to uninstall VictoriaMetrics

Remove application with command.

helm uninstall victoria-metrics -n NAMESPACE

Kubernetes compatibility versions

helm charts tested at kubernetes versions from 1.13 to 1.22.

List of Charts

• Victoria Metrics Agent
• Victoria Metrics Alert
• Victoria Metrics Auth
• Victoria Metrics Cluster
• Victoria Metrics k8s Stack
• Victoria Metrics Operator
• Victoria Metrics Single-node