Migrating from the OpenNMS Data Source plugin
This guide helps migrate an existing installation of Grafana from using the OpenNMS Data Source plugin to using HELM to interface with OpenNMS.
The tutorial assumes that you have:
an instance of Grafana with the OpenNMS Data Source installed.
a data source configured with type OpenNMS, and one or more dashboards using the data source.
Both the OpenNMS Data Source plugin and HELM can be installed at the same time while you complete the migration.
If you have not already done so, you may install HELM using your prefered method. See Installation for detailed instructions.
Once HELM is installed, you need to enable the application in Grafana to make the provided panels and data sources available:
Navigate to the home page of your Grafana instance. In the top-left corner of the page, click on the Grafana icon, and then click Plugins:
Next, navigate to the
Appstab, and click on the
OpenNMS Helmis application is not listed on the
Appstab, try restarting the Grafana server. If the issue persists, make sure the application is installed correctly.
Enable the application by clicking on the
If you see a
Disablebutton, then the application is already enabled and you can skip to the next step.
Once the HELM application is enabled, you can convert your existing
OpenNMS data sources to use the
OpenNMS Perfomance type.
When switching the type, you may need to re-enter the URL and authentication details.
HELM provides two data source types.
Once the existing data sources have been converted to use the new
OpenNMS Performance type, you should verify your existing dashboards to make sure they continue to render properly.
If you encounter any errors when switching, you can revert to the previous data source type.
Once you have verified that your dashboards continue to work with the new data source, you can remove the previous plugin.
grafana-cli tool to remove the
OpenNMS Data Source plugin from the commandline:
sudo grafana-cli plugins remove opennms-datasource
Restart Grafana for the plugin to be completely unregistered:
sudo service grafana-server restart