Upgrade from Older Versions
Usually, upgrading simply involves installing the new package. However, major version releases can sometimes introduce breaking changes, in which case you may need additional steps to upgrade.
Helm 3 to 4+ migration
Helm 4 introduced a breaking change, renaming the FM (Fault Management) datasource to the Entities datasource. You will need to follow a few steps to upgrade your dashboards. |
Before you do anything else, make sure you have installed the latest Helm plugin. Make sure you also have Node.js installed.
Export datasources with Wizzy
First, install Wizzy with npm
, and create a place to put your datasources:
npm i -g wizzy
mkdir /tmp/wizzy
cd /tmp/wizzy
Next, configure Wizzy to speak to your Grafana instance and dump your datasources:
# create a local wizzy project directory
wizzy init
# configure Grafana login information
wizzy set grafana url http://localhost:3000
wizzy set grafana username admin
wizzy set grafana password admin
# dump datasources to the project directory
wizzy import datasources
Then, convert any fault
datasources to be entity
datasources:
perl -pi -e 's/opennms-helm-fault-datasource/opennms-helm-entity-datasource/g' datasources/*.json
Finally, publish your changes back to Grafana:
wizzy export datasources