Home
Dashboards
The IBM RMF for z/OS Grafana plugin provides pre-built sample dashboards that you can install, as well as the ability to import dashboards from other sources and integrate with IBM Z OMEGAMON dashboards.
Importing Performance Monitoring dashboards
You can import dashboards exported from RMF Performance Monitoring (.po files) into the IBM RMF for z/OS Grafana plugin. The import process automatically creates the associated data sources and converts the dashboards to Grafana format.

Overview
Grafana is a platform for monitoring and visualizing data. It enables users to create, explore, and share dashboards that are interactive and customizable. The IBM® RMF for z/OS Grafana plugin provides effortless analysis and visualization of Resource Measurement Facility for z/OS (RMF for z/OS) Monitor III metrics and reports within the Grafana platform. Thereby, you can monitor and analyze the health and performance of applications.
Release notes
This article covers the new features and enhancements in the IBM RMF for z/OS Grafana plugin.
Prerequisites
Before you install the RMF for z/OS Grafana plugin, ensure that the following software requirements are met.
Installation
You must install the RMF for z/OS Grafana plugin to analyze and visualize RMF Monitor III metrics and reports.
Upgrading the plugin
You must ensure that the RMF for z/OS Grafana plugin is up to date to leverage its enhanced functionalities. You can do so by either installing or upgrading to the latest version of the RMF for z/OS Grafana plugin.
Creating RMF data sources
To access RMF Monitor III metrics in Grafana, you need to connect to the Distributed Data Server (DDS) by adding an RMF data source.
Dashboards
The IBM RMF for z/OS Grafana plugin provides pre-built sample dashboards that you can install, as well as the ability to import dashboards from other sources and integrate with IBM Z OMEGAMON dashboards.
- Installing sample dashboards
  After you install and enable the IBM RMF for z/OS Grafana plugin, you can install the DDS sample dashboards and Prometheus sample dashboards to visualize RMF metrics.
- Prometheus sample dashboards
  The RMF Distributed Data Server exposes Monitor III data to third-party tools using the OpenMetrics exposition format.
- Integrating DDS dashboards with OMEGAMON Web UI
  To enhance visibility and provide deeper insights, the DDS dashboards can be integrated with IBM Z OMEGAMON Web UI dashboards.
- Importing Performance Monitoring dashboards
  You can import dashboards exported from RMF Performance Monitoring (.po files) into the IBM RMF for z/OS Grafana plugin. The import process automatically creates the associated data sources and converts the dashboards to Grafana format.
Applying visualization to RMF data
By adding panels to dashboards, you can effectively present your RMF data in a visual format. Each panel must require at least one query to display a significant visualization.
IBM RMF query languages
In Grafana, queries are essential for fetching and transforming data from RMF data sources.
RMF Variable Query syntax
Variables are a powerful tool to create more interactive and dynamic dashboards. They offer a way to replace hard-coded values in metric queries and panel titles with placeholders for values.
Alerts
Grafana Alerting feature provides a reliable solution to detect and respond to system issues in real time.
Historical data
In Grafana, you can view historical data using absolute and relative time ranges.
Error types
Whenever you encounter issues while using the IBM RMF for z/OS Grafana plugin, you can view detailed error messages that contain sufficient information to help you identify and troubleshoot the problem.
Troubleshooting issues
This section guides how to analyze and address typical issues that may arise when using the IBM® RMF for z/OS Grafana plugin.
Grafana through z/OSMF
When you use IBM® z/OS Management Facility to monitor the performance of the z/OS sysplexes in your environment, you can also access Grafana dashboards from z/OSMF.
PDF Guide
You can find the link to view or download IBM RMF for z/OS Grafana plugin user guide as a PDF file.

Importing dashboards created in RMF Performance Monitoring

You can import dashboards exported from RMF Performance Monitoring (.po files) into the IBM RMF for z/OS Grafana plugin. The import process automatically creates the associated data sources and converts the dashboards to Grafana format.

Before you begin

You must have completed the following tasks:

Installed the IBM RMF for z/OS Grafana plugin. See Installing the RMF for z/OS Grafana plugin v2.0.1 or later.
Exported a dashboard from RMF Performance Monitoring in .po format.

About this task

When you import a .po file, the plugin performs the following actions:

Parses the data source definitions from the file and creates the corresponding IBM RMF data sources in Grafana if they do not already exist.
Converts the Performance Monitoring dashboard panels into Grafana bar chart panels with appropriate queries and transformations.
Installs the converted dashboard into the IBM RMF (PM) folder.

Procedure

Go to Apps > IBM RMF and navigate to the Import Dashboards from RMF Performance Monitoring section.
Verify the Destination folder path displayed under the section heading.

The imported dashboards are placed in the IBM RMF (PM) folder.
Drag and drop a .po dashboard file onto the drop zone, or click the drop zone to browse for the file manually.

Only files with the .po extension are accepted. You can import one file at a time.

The plugin automatically creates any required data sources and imports the dashboard into the destination folder. A success notification confirms the import with the dashboard name.
Optional: Click Go to PM Dashboards to navigate to the destination folder and review the imported dashboards.

This button is available only after at least one dashboard has been imported.
Optional: To remove all imported dashboards, click Delete.

This removes the IBM RMF (PM) folder and all dashboards within it. The data sources created during import are not removed.

Results

The dashboard exported from RMF Performance Monitoring is successfully imported into the IBM RMF for z/OS Grafana plugin and is available in the IBM RMF (PM) folder.

Important: Data sources defined in RMF Performance Monitoring dashboards are imported without credentials. After import, update each data source with valid credentials if the corresponding DDS requires authentication.