Grafana Dashboard Box
Grafana provides an API key that lets third-party applications access it. Meridian uses Grafana to generate visualizations, including the Grafana Dashboard Box on the home page. By default, it shows a set of dashboards related to Meridian and your monitored environment.

Filter dashboards
To filter for relevant dashboards, you can use a dashboard’s tag (defined by the org.opennms.grafanaBox.tag
property) and make it accessible.
If no tag is provided, all Grafana dashboards are shown.
You can configure this feature by creating or editing ${OPENNMS_HOME}/etc/opennms.properties.d/grafana.properties
.
Name | Description | Type | Default Value |
---|---|---|---|
org.opennms.grafanaBox.show |
Determines whether a Grafana Dashboard Box showing the available dashboards is included on the home page. |
Boolean |
false |
org.opennms.grafanaBox.hostname |
The hostname of the Grafana server. You may need to use the IP address or fully qualified domain name, based on your DNS records. |
String |
localhost |
org.opennms.grafanaBox.port |
The port for the Grafana server’s REST API. |
Integer |
3000 |
org.opennms.grafanaBox.basePath |
The base path to Grafana. |
String |
Empty |
org.opennms.grafanaBox.apiKey |
The Grafana API key.
This key is needed for REST calls to work. |
String |
Empty |
org.opennms.grafanaBox.tag |
A tag that specifies which dashboards to display in the Grafana Dashboard Box.
The tag must be assigned to an existing dashboard for it to be included. |
String |
Empty |
org.opennms.grafanaBox.protocol |
The protocol for the REST call. |
String |
http |
org.opennms.grafanaBox.connectionTimeout |
Connection timeout, in milliseconds, for fetching information from the Grafana server. |
Integer |
500 |
org.opennms.grafanaBox.soTimeout |
Socket timeout, in milliseconds. |
Integer |
500 |
org.opennms.grafanaBox.dashboardLimit |
The maximum number of entries to display.
Setting the value to |
Integer |
0 |
org.opennms.grafanaBox.link.protocol |
The protocol used to build each dashboard URL. |
String |
org.opennms.grafanaBox.protocol |
org.opennms.grafanaBox.link.hostname |
Hostname used to build each dashboard URL. |
String |
org.opennms.grafanaBox.hostname |
org.opennms.grafanaBox.link.port |
The port used to build each dashboard URL. |
Integer |
org.opennms.grafanaBox.port |
org.opennms.grafanaBox.link.basePath |
The Grafana base path used to build each dashboard URL. |
String |
org.opennms.grafanaBox.basePath |
If you have Grafana set up behind a reverse proxy, you may need to define the org.opennms.grafanaBox.link.* properties.
The link.* properties, if defined, are used to build the user-facing URLs, independent of other properties that are used for internal interaction with the Grafana REST API.
|