Home
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.

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, system requirements, and known issues of the IBM® RMF for z/OS Grafana plugin.
Installing the plugin
You must install the IBM® RMF for z/OS Grafana plugin to analyze and visualize RMF Monitor III metrics and reports.
Upgrading the plugin
You must ensure that the IBM 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 plugin.
Creating RMF data sources
To access RMF Monitor III metrics in Grafana, you need to connect to the Distributed Data Servers by adding an RMF data source.
RMF master dashboard
IBM® RMF for z/OS Grafana is a plugin provides custom panels for the RMF data source and master dashboard that consists of RMF Charts, RMF Reporting, and RMF Time Series dashboards.
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.

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.

This article is regularly updated with the latest information on discovering and solving issues that may arise. You can search through the article to find the precise information you need.

You can open a case by navigating to IBM support if you cannot find any solutions for the issue you encountered. Before opening a case, gather all the required information and provide the details to IBM support for further investigation.

The following table describes the details of issues and the resolutions you can apply to fix the problems:


Issues	Cause	Resolutions
RMF Time Series dashboards do not plot the Monitor 3 metrics data, whereas RMF Reports and RMF Charts dashboards plot correctly.	The proxy settings configured by your network administrator block web socket connections from the Grafana server. The IBM RMF for z/OS Grafana plugin streams time series data to the clients through web socket connections.	Unblocking web sockets and configuring the appropriate proxy settings is necessary to ensure that web sockets with the name "`ws`" in the URI work correctly with the IBM RMF for z/OS Grafana plugin. You can contact your network administrator to modify the proxy configuration settings.