Merge pull request #70364 from kblake2016/HCCDOC-1765

[HCCDOC#1765]: Add recommendations-filtering content to Remote Health Monitoring

Author: EricPonvelle

modules/filtering-insights-advisor-recommendations.adoc

@@ -0,0 +1,26 @@
+// Module included in the following assemblies:
+//
+// * support/remote_health_monitoring/using-insights-to-identify-issues-with-your-cluster.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="filtering-unnecessary-advisor-recommendations_{context}"]
+= Filtering Insights advisor recommendations
+
+As an {product-title} cluster manager, you can filter the recommendations that are displayed on the recommendations list. By applying filters, you can reduce the number of reported recommendations and concentrate on your highest priority recommendations.
+
+The following procedure demonstrates how to set and remove *Category* filters; however, the procedure is applicable to any of the filter types and respective values. 
+
+.Prerequisites
+You are logged in to the https://console.redhat.com/openshift[OpenShift Cluster Manager Hybrid Cloud Console].
+
+.Procedure
+. Go to *Red Hat Hybrid Cloud Console* -> *OpenShift* -> *Advisor recommendations*.
+. In the main, filter-type drop-down list, select the *Category* filter type.
+. Expand the filter-value drop-down list and select the checkbox next to each category of recommendation you want to view. Leave the checkboxes for unnecessary categories clear.
+. Optional: Add additional filters to further refine the list.
+
+Only recommendations from the selected categories are shown in the list. 
+
+.Verification
+
+* After applying filters, you can view the updated recommendations list. The applied filters are added next to the default filters.

modules/insights-advisor-recommendations-filters.adoc

@@ -0,0 +1,24 @@
+// Module included in the following assemblies:
+//
+// * support/remote_health_monitoring/using-insights-to-identify-issues-with-your-cluster.adoc
+
+:_mod-docs-content-type: CONCEPT
+[id="insights-operator-advisor-recommendation-filters_{context}"]
+= Advisor recommendation filters
+
+The Insights advisor service can return a large number of recommendations. To focus on your most critical recommendations, you can apply filters to the https://console.redhat.com/openshift/insights/advisor/recommendations[Advisor recommendations] list to remove low-priority recommendations.
+
+By default, filters are set to only show enabled recommendations that are impacting one or more clusters. To view all or disabled recommendations in the Insights library, you can customize the filters.
+
+To apply a filter, select a filter type and then set its value based on the options that are available in the drop-down list. You can apply multiple filters to the list of recommendations.
+
+You can set the following filter types:
+
+* *Name:* Search for a recommendation by name.
+* *Total risk:* Select one or more values from *Critical*, *Important*, *Moderate*, and *Low* indicating the likelihood and the severity of a negative impact on a cluster.
+* *Impact:* Select one or more values from *Critical*, *High*, *Medium*, and *Low* indicating the potential impact to the continuity of cluster operations. 
+* *Likelihood:* Select one or more values from *Critical*, *High*, *Medium*, and *Low* indicating the potential for a negative impact to a cluster if the recommendation comes to fruition.
+* *Category:* Select one or more categories from *Service Availability*, *Performance*, *Fault Tolerance*, *Security*, and *Best Practice* to focus your attention on.
+* *Status:* Click a radio button to show enabled recommendations (default), disabled recommendations, or all recommendations.
+* *Clusters impacted:* Set the filter to show recommendations currently impacting one or more clusters, non-impacting recommendations, or all recommendations.
+* *Risk of change:* Select one or more values from *High*, *Moderate*, *Low*, and *Very low* indicating the risk that the implementation of the resolution could have on cluster operations.

modules/removing-filters-from-insights-advisor-recommendations.adoc

@@ -0,0 +1,15 @@
+// Module included in the following assemblies:
+//
+// * support/remote_health_monitoring/using-insights-to-identify-issues-with-your-cluster.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="removing-filters-from-insights-recommendations_{context}"]
+= Removing filters from Insights Advisor recommendations
+
+You can apply multiple filters to the list of recommendations. When ready, you can remove them individually or completely reset them.
+
+.Removing filters individually
+* Click the *X* icon next to each filter, including the default filters, to remove them individually.
+
+.Removing all non-default filters
+* Click *Reset filters* to remove only the filters that you applied, leaving the default filters in place.

support/remote_health_monitoring/using-insights-to-identify-issues-with-your-cluster.adoc

@@ -15,6 +15,9 @@ include::modules/insights-operator-advisor-overview.adoc[leveloffset=+1]
 include::modules/insights-operator-advisor-recommendations.adoc[leveloffset=+1]
 include::modules/displaying-potential-issues-with-your-cluster.adoc[leveloffset=+1]
 include::modules/displaying-all-insights-advisor-recommendations.adoc[leveloffset=+1]
+include::modules/insights-advisor-recommendations-filters.adoc[leveloffset=+1]
+include::modules/filtering-insights-advisor-recommendations.adoc[leveloffset=+2]
+include::modules/removing-filters-from-insights-advisor-recommendations.adoc[leveloffset=+2]
 include::modules/disabling-insights-advisor-recommendations.adoc[leveloffset=+1]
 include::modules/enabling-insights-advisor-recommendations.adoc[leveloffset=+1]
 include::modules/displaying-the-insights-status-in-the-web-console.adoc[leveloffset=+1]