victoria-metrics-alert

VictoriaMetrics Alert

Chainguard's redistribution of the victoria-metrics-alert Helm chart, pre-configured with hardened Chainguard Images. vmalert executes a list of MetricsQL/PromQL expressions (rules) against a VictoriaMetrics or Prometheus-compatible datasource and sends alerts to Alertmanager.

Prerequisites

Authentication is required. First, authenticate with Chainguard:

chainctl auth login
chainctl auth configure-docker --pull-token --save
helm registry login cgr.dev

Create an image pull secret:

kubectl create secret docker-registry cgr-pull-secret \
  --docker-server=cgr.dev \
  --docker-username="$(echo cgr.dev | docker-credential-cgr get | jq -r '.Username')" \
  --docker-password="$(echo cgr.dev | docker-credential-cgr get | jq -r '.Secret')" \
  --namespace default

Installation

helm install victoria-metrics-alert oci://cgr.dev/ORGANIZATION/charts/victoria-metrics-alert \
  --namespace default \
  --create-namespace \
  --set global.imagePullSecrets[0].name=cgr-pull-secret \
  --set server.datasource.url=http://victoria-metrics-single-server:8428

To also deploy the bundled Alertmanager, add --set alertmanager.enabled=true.

About This Chart

This is a redistribution of the upstream victoria-metrics-alert chart. All upstream configuration options apply. A server.datasource.url is required for vmalert to evaluate its rules. The chart uses the following Chainguard images:

• cgr.dev/ORGANIZATION/victoriametrics-vmalert for the vmalert server
• cgr.dev/ORGANIZATION/prometheus-alertmanager for the optional Alertmanager

For full documentation, see: https://docs.victoriametrics.com/vmalert/