Upgrade Guide - Scylla Monitoring 2.x to Scylla Monitoring 3.x¶
This document is a step by step procedure for upgrading Scylla Monitoring Stack from version 2.x to 3.x
Switching from Scylla Monitoring 2.x to Scylla Monitoring 3.x is not fully backwards compatible. The changes effect dashboards names and metrics.
Scylla Monitoring uses the node_exporter utility to collect OS related metrics. By default, Scylla will install node_exporter version 0.17. If you upgrade in the past from older Scylla version (before Scylla 2.3) you should verify that you are running the correct node_exporter. You can do that by running node_exporter –version on the machines running scylla.
If you are running an older version of node_exporter you can use the helper script node_exporter_install –force that shipped with Scylla to force upgrade.
Download the 3.x version from the release page.
Unzip it into a different directory.
Copy the targets files from the old stack to the new one, located on the
scylla_servers.yml (for example
cp /path/to/old/monitor/prometheus/scylla_servers.yml prometheus/)
The targets files are no longer part of the release, make sure to copy them or the monitoring stack will not start.
Stop the old monitoring stack
Start the new monitoring stack
./start-all.sh -d /prometheus-data-path