This guide demonstrates how to create a simple dashboard with Helm.
The tutorial assumes that you have:
an instance of Grafana with the Helm application installed.
an instance of OpenNMS that is reachable from the Grafana instance above.
one or mode nodes being monitored by OpenNMS.
In this section, you will enable the Helm application in Grafana.
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
Apps tab, and click on the
OpenNMS Helm application.
Enable the application by clicking on the
If you see a
In the Helm Config tab, you can add custom actions. These will (currently) show when you right-click an alarm in an alarm table.
Custom action URLs may contain
$variables that reference properties of an OpenNMS alarm. A list of the available properties can be seen at the OpenNMS.js documentation.
Special case: event parameters on the alarm can be accessed either by index (
If a variable can’t be matched against the row, the action will not appear in the context menu.
Variables will be URL-encoded when they are injected into the URL.
In this section, you will configure the Fault Management (FM) data source.
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 Data Sources:
Next, click on
Add data source.
In the Name field enter:
My First OpenNMS FM DS.
Change the Type to
In the Url field enter the URL to your OpenNMS instance i.e.
The URL to your OpenNMS instance should normally end with
Click the checkbox next to Basic Auth.
Enter the credentials for an OpenNMS user in the User and Password fields.
Click the Add button.
If the data source is configured correctly you should see a message indicating that the
Data source is working.
If the message indicates a failure, review the information that was entered and click Save & Test to test the data source again.
Create a new Dashboard by click on the dashboard selector at the top of the page, and the clicking on
Add a new Alarm Table panel to either a new or an existing row.
Edit the Alarm Table panel, by click on the panel title, and then clicking
Navigate to Metrics tab and select the data source we previously created in the Panel Data Source selection.
Navigate to the Options tab, click the
+ next to Columns and select
IP Address from the list.
Return to the dashboard view by clicking
Back to dashboard near the top of the screen.
Save the dashboard by clicking the disk icon near the top of the screen, enter a name, and click
That’s it! Now, you have your first dashboard. Try changing the time range at the top right of the screen, or try performing actions against the alarms by right on any of the alarm rows.