rancher-monitoring-v1-to-v2's Introduction

rancher-monitoring v1 to v2 migration

Small helper scripts to migrate alerts and Grafana dashboards from monitoring v1 to v2 introduced in Rancher 2.5.

Installation

The scripts are written in Python. The easiest option is to run them in a venv:

git clone https://github.com/bashofmann/rancher-monitoring-v1-to-v2.git
cd rancher-monitoring-v1-to-v2
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Migrate Grafana dashboards

All dashboards will be exported. The script creates ConfigMaps that you can create in a cluster with monitoring v2 activated.

Usage: migrate_dashboards.py [OPTIONS]

Options:
  --rancher-url TEXT        URL to source Rancher  [required]
  --rancher-api-token TEXT  API Token for source Rancher  [required]
  --cluster-id TEXT         ID for source cluster  [required]
  --project-id TEXT         ID for source project (optional)
  --insecure                If set, do not verify tls certificates
  --help                    Show this message and exit.

Example:

python migrate_dashboards.py \
  --rancher-url https://rancher.example.com \
  --rancher-api-token ABCDEF
  --cluster-id c-123456 > dashboards.yaml

kubectl create -f dashboards.yaml

Migrate Alerts

All metric based alerts will be exported. The script creates PrometheusRule objects that you can create in a cluster with monitoring v2 activated.

Usage: migrate_rules.py [OPTIONS]

Options:
  --rancher-url TEXT        URL to source Rancher  [required]
  --rancher-api-token TEXT  API Token for source Rancher  [required]
  --cluster-id TEXT         ID for source cluster  [required]
  --project-id TEXT         ID for source project (optional)
  --insecure                If set, do not verify tls certificates
  --help                    Show this message and exit.

Example:

python migrate_rules.py \
  --rancher-url https://rancher.example.com \
  --rancher-api-token ABCDEF
  --cluster-id c-123456 > rules.yaml

kubectl create -f rules.yaml

Recommend Projects