Release v1.1.1

.gitignore

@@ -5,4 +5,3 @@
 .antlr
 *.interp
 *.tokens
-grafana/rmf-app/**/rmf-datasource/parser/lib/RMFQuery*.ts

LICENSE

@@ -186,7 +186,8 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright [yyyy] [name of copyright owner]
+   Copyright 2023,2025 IBM Corporation
+   Copyright 2023-2025 Rocket Software, Inc.
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

README.md

@@ -2,27 +2,39 @@
 
 Resource Measurement Facility for z/OS
 
+## Grafana Sample Dashboards
+
+The IBM RMF Monitor III metrics can be exposed to third-party tools directly using the OpenMetrics exposition format.
+Some examples of the tools are:
+- Prometheus
+- VictoriaMetrics
+- Telegraf
+
+Grafana sample dashboards for Prometheus and VictoriaMetrics as well as usage information are available in the [grafana/dashboards](grafana/dashboards) directory.  
+
+Refer to [z/OS Resource Measurement Facility User's Guide](https://www.ibm.com/docs/en/zos/latest?topic=rmf-zos-resource-measurement-facility-users-guide) for more information on configuring RMF DDS.
+
 ## IBM RMF for z/OS Grafana Plugin
 
 The IBM® RMF for z/OS Grafana plugin provides effortless analysis and visualization of RMF Monitor III metrics and reports within the Grafana platform.
 
-See [IBM RMF for z/OS Grafana Plugin](https://github.com/IBM/RMF/blob/release/spreadsheet-reporter/grafana/rmf-app/README.md) for more details.
+See [IBM RMF for z/OS Grafana Plugin](grafana/rmf-app/README.md) for more details.
 
 ## IBM RMF Performance Monitoring
 
-The IBM® RMF Performance Monitoring (RMF PM) is a tool that enables you to manage the performance of your z/OS host right from your workstation. By establishing a TCP/IP connection to one or more z/OS sysplexes, you can effortlessly access real-time data on the resources of the corresponding sysplex.
+The IBM® RMF Performance Monitoring (RMF PM) is a tool that enables you to manage the performance of your z/OS host right from your workstation. By establishing a TCP/IP connection to one or more z/OS sysplexes, you can access real-time data on the resources of the corresponding sysplex.
 
-RMF PM offers great flexibility in creating unique scenarios to monitor the system's performance. You can easily sample data from different resources and combine it to comprehensively overview the system's performance. With RMF PM, you can visualize the performance data as bar charts to better understand the system's status.
+RMF PM offers flexibility in creating scenarios to monitor the system's performance. You can sample data from different resources and combine it to comprehensively overview the system's performance. With RMF PM, you can visualize the performance data as bar charts to better understand the system's status.
 
-You can download the installer from the following location:
+You can download the installer from the following location: 
 https://github.com/IBM/RMF/releases
 
-Refer to the  [z/OS Resource Measurement Facility User's Guide](https://www.ibm.com/docs/en/zos/latest?topic=monitoring-performance-overview) for more information.
+Refer to the [z/OS Resource Measurement Facility User's Guide](https://www.ibm.com/docs/en/zos/latest?topic=monitoring-performance-overview) for more information.
 
 ## IBM RMF Spreadsheet Reporter
 
-The RMF Spreadsheet Reporter is an advanced and efficient workstation solution that enables users to visualize RMF (Resource Measurement Facility) Postprocessor data in a graphical format. With the RMF Spreadsheet Reporter, you can convert your RMF data into a spreadsheet format, which makes it easier to analyze and manipulate the data.
+The RMF Spreadsheet Reporter is a workstation solution that enables users to visualize RMF (Resource Measurement Facility) Postprocessor data in a graphical format. With the RMF Spreadsheet Reporter, you can convert your RMF data into a spreadsheet format, which makes it easier to analyze and manipulate the data.
 
 You can download the installer from the following location: (https://github.com/IBM/RMF/releases).
 
-Refer to the [z/OS Resource Measurement Facility User's Guide](https://www.ibm.com/docs/en/zos/latest?topic=reporter-concepts-performance-analysis-rmf-spreadsheet) for more information.
+Refer to the [z/OS Resource Measurement Facility User's Guide](https://www.ibm.com/docs/en/zos/latest?topic=reporter-concepts-performance-analysis-rmf-spreadsheet) for more information.

docs/grafana/rmf-app/context-help-map.xml

@@ -10,6 +10,7 @@
    <appContext helpID="apply_visualize" path="apply_visualize.html"/>
    <appContext helpID="query_lang" path="query_lang.html"/>
    <appContext helpID="variables" path="variables.html"/>
+   <appContext helpID="install_grafana_plugin" path="integrating_dds_omegamon.html"/>
    <appContext helpID="alerts" path="alerts.html"/>
    <appContext helpID="historical_data" path="historical_data.html"/>
    <appContext helpID="error_reports" path="error_reports.html"/>

docs/grafana/rmf-app/index.html

@@ -107,7 +107,7 @@
             <div class="container-fluid wh_content_flex_container">
                 <!-- This is the placeholder for the main page tiles. -->
 
-                <div class=" wh_main_page_toc "><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="visual_grafana.html" data-id="visual_grafana">Overview</a></span><div class=" wh_toc_shortdesc " data-id="visual_grafana">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.</div></div><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="rn.html" data-id="rn">Release notes</a></span><div class=" wh_toc_shortdesc " data-id="rn">This article covers the new features, system requirements, and known issues of the             IBM® RMF for z/OS Grafana plugin.</div></div><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="install_grafana_plugin.html" data-id="install_grafana_plugin">Installing the plugin</a></span><div class=" wh_toc_shortdesc " data-id="install_grafana_plugin">You must install the IBM® RMF for z/OS Grafana plugin to analyze         and visualize RMF Monitor III metrics and reports.</div></div><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="update_plugin.html" data-id="update_plugin">Upgrading the plugin</a></span><div class=" wh_toc_shortdesc " data-id="update_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.</div></div><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="prometheus_sample_dashboards.html" data-id="prometheus_sample_dashboards_1">Prometheus Sample Dashboards</a></span><div class=" wh_toc_shortdesc " data-id="prometheus_sample_dashboards_1">The RMF Distributed Data Server exposes Monitor III data to third-party tools using         the OpenMetrics exposition format. </div></div><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="create_datasources.html" data-id="create_datasources">Creating RMF data sources</a></span><div class=" wh_toc_shortdesc " data-id="create_datasources">To access RMF Monitor III metrics in Grafana, you need to connect to the Distributed Data Server (DDS) by         adding an RMF data source.</div></div><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="apply_visualize.html" data-id="apply_visualize">Applying visualization to RMF data</a></span><div class=" wh_toc_shortdesc " data-id="apply_visualize">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.</div></div><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="query_lang.html" data-id="query_lang">IBM RMF query languages</a></span><div class=" wh_toc_shortdesc " data-id="query_lang">In Grafana, queries are essential for fetching and transforming data from RMF data         sources.</div></div><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="variables.html" data-id="variables">RMF Variable Query syntax</a></span><div class=" wh_toc_shortdesc " data-id="variables">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.</div></div><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="alerts.html" data-id="alerts">Alerts</a></span><div class=" wh_toc_shortdesc " data-id="alerts">Grafana Alerting feature provides a reliable solution to detect and respond to system         issues in real time.</div></div><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="historical_data.html" data-id="historical_data">Historical data</a></span><div class=" wh_toc_shortdesc " data-id="historical_data">In Grafana, you can view historical data using absolute and relative time         ranges.</div></div><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="error_reports.html" data-id="error_reports">Error types</a></span><div class=" wh_toc_shortdesc " data-id="error_reports">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.</div></div><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="ts_issues.html" data-id="ts_issues">Troubleshooting issues</a></span><div class=" wh_toc_shortdesc " data-id="ts_issues">This section guides how to analyze and address typical issues that may arise when         using the IBM® RMF for z/OS Grafana plugin.</div></div><div class=" wh_main_page_toc_accordion_header "><span role="heading" aria-level="1" id="grafana_via_zosmf-d329e186-heading"><span role="button" aria-expanded="false" class="header-button" aria-controls="grafana_via_zosmf-d329e186-entries" tabindex="0"></span><span class="topicref"><a href="grafana_via_zosmf.html" data-id="grafana_via_zosmf">Grafana through <span xmlns="" class="ph">z/OSMF</span></a></span></span><div class=" wh_toc_shortdesc " data-id="grafana_via_zosmf">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.</div></div><div class=" wh_main_page_toc_accordion_entries " id="grafana_via_zosmf-d329e186-entries" role="region" aria-labelledby="grafana_via_zosmf-d329e186-heading"><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="prereq_zosmf.html" data-id="prereq_zosmf">Prerequisites</a></span><div class=" wh_toc_shortdesc " data-id="prereq_zosmf">Before you can start working with Grafana dashboards through z/OSMF, there are some prerequisites that you need to         complete.</div></div><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="define_grafana_zosmf.html" data-id="define_grafana_zosmf">Defining the Grafana server</a></span><div class=" wh_toc_shortdesc " data-id="define_grafana_zosmf">You must define the Grafana server as a target system in z/OSMF to access Grafana from the Resource             Monitoring page of z/OSMF.</div></div><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="access_grafana_zosmf.html" data-id="access_grafana_zosmf">Accessing the Grafana dashboard</a></span><div class=" wh_toc_shortdesc " data-id="access_grafana_zosmf">You can access the Grafana dashboard from the Resource             Monitoring page of z/OSMF to         investigate the RMF Monitor III metrics and reports.</div></div></div><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="pdf_guide.html" data-id="pdf_guide">PDF Guide</a></span><div class=" wh_toc_shortdesc " data-id="pdf_guide">You can find the link to view or download IBM RMF for z/OS Grafana plugin user guide as a PDF file.</div></div></div>
+                <div class=" wh_main_page_toc "><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="visual_grafana.html" data-id="visual_grafana">Overview</a></span><div class=" wh_toc_shortdesc " data-id="visual_grafana">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.</div></div><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="rn.html" data-id="rn">Release notes</a></span><div class=" wh_toc_shortdesc " data-id="rn">This article covers the new features, system requirements, and known issues of the             IBM® RMF for z/OS Grafana plugin.</div></div><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="install_grafana_plugin.html" data-id="install_grafana_plugin">Installing the plugin</a></span><div class=" wh_toc_shortdesc " data-id="install_grafana_plugin">You must install the IBM® RMF for z/OS Grafana plugin to analyze         and visualize RMF Monitor III metrics and reports.</div></div><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="update_plugin.html" data-id="update_plugin">Upgrading the plugin</a></span><div class=" wh_toc_shortdesc " data-id="update_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.</div></div><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="prometheus_sample_dashboards.html" data-id="prometheus_sample_dashboards_1">Prometheus Sample Dashboards</a></span><div class=" wh_toc_shortdesc " data-id="prometheus_sample_dashboards_1">The RMF Distributed Data Server exposes Monitor III data to third-party tools using         the OpenMetrics exposition format. </div></div><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="create_datasources.html" data-id="create_datasources">Creating RMF data sources</a></span><div class=" wh_toc_shortdesc " data-id="create_datasources">To access RMF Monitor III metrics in Grafana, you need to connect to the Distributed Data Server (DDS) by         adding an RMF data source.</div></div><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="apply_visualize.html" data-id="apply_visualize">Applying visualization to RMF data</a></span><div class=" wh_toc_shortdesc " data-id="apply_visualize">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.</div></div><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="query_lang.html" data-id="query_lang">IBM RMF query languages</a></span><div class=" wh_toc_shortdesc " data-id="query_lang">In Grafana, queries are essential for fetching and transforming data from RMF data         sources.</div></div><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="variables.html" data-id="variables">RMF Variable Query syntax</a></span><div class=" wh_toc_shortdesc " data-id="variables">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.</div></div><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="integrating_dds_omegamon.html" data-id="install_grafana_plugin">Integrating DDS Dashboards with OMEGAMON</a></span><div class=" wh_toc_shortdesc " data-id="install_grafana_plugin">To enhance visibility and provide deeper insights, the DDS dashboards can be         integrated with IBM Z OMEGAMON Web UI dashboards. </div></div><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="alerts.html" data-id="alerts">Alerts</a></span><div class=" wh_toc_shortdesc " data-id="alerts">Grafana Alerting feature provides a reliable solution to detect and respond to system         issues in real time.</div></div><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="historical_data.html" data-id="historical_data">Historical data</a></span><div class=" wh_toc_shortdesc " data-id="historical_data">In Grafana, you can view historical data using absolute and relative time         ranges.</div></div><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="error_reports.html" data-id="error_reports">Error types</a></span><div class=" wh_toc_shortdesc " data-id="error_reports">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.</div></div><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="ts_issues.html" data-id="ts_issues">Troubleshooting issues</a></span><div class=" wh_toc_shortdesc " data-id="ts_issues">This section guides how to analyze and address typical issues that may arise when         using the IBM® RMF for z/OS Grafana plugin.</div></div><div class=" wh_main_page_toc_accordion_header "><span role="heading" aria-level="1" id="grafana_via_zosmf-d335e197-heading"><span role="button" aria-expanded="false" class="header-button" aria-controls="grafana_via_zosmf-d335e197-entries" tabindex="0"></span><span class="topicref"><a href="grafana_via_zosmf.html" data-id="grafana_via_zosmf">Grafana through <span xmlns="" class="ph">z/OSMF</span></a></span></span><div class=" wh_toc_shortdesc " data-id="grafana_via_zosmf">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.</div></div><div class=" wh_main_page_toc_accordion_entries " id="grafana_via_zosmf-d335e197-entries" role="region" aria-labelledby="grafana_via_zosmf-d335e197-heading"><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="prereq_zosmf.html" data-id="prereq_zosmf">Prerequisites</a></span><div class=" wh_toc_shortdesc " data-id="prereq_zosmf">Before you can start working with Grafana dashboards through z/OSMF, there are some prerequisites that you need to         complete.</div></div><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="define_grafana_zosmf.html" data-id="define_grafana_zosmf">Defining the Grafana server</a></span><div class=" wh_toc_shortdesc " data-id="define_grafana_zosmf">You must define the Grafana server as a target system in z/OSMF to access Grafana from the Resource             Monitoring page of z/OSMF.</div></div><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="access_grafana_zosmf.html" data-id="access_grafana_zosmf">Accessing the Grafana dashboard</a></span><div class=" wh_toc_shortdesc " data-id="access_grafana_zosmf">You can access the Grafana dashboard from the Resource             Monitoring page of z/OSMF to         investigate the RMF Monitor III metrics and reports.</div></div></div><div class=" wh_main_page_toc_entry "><span class="topicref"><a href="pdf_guide.html" data-id="pdf_guide">PDF Guide</a></span><div class=" wh_toc_shortdesc " data-id="pdf_guide">You can find the link to view or download IBM RMF for z/OS Grafana plugin user guide as a PDF file.</div></div></div>
 
             </div>
         </div>