Sync main (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.

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>