Merge pull request #41679 from xJustin/insights-advisor-overview

Author: Bob Furu

modules/insights-operator-advisor-overview.adoc

@@ -0,0 +1,16 @@
+// Module included in the following assemblies:
+//
+// * support/remote_health_monitoring/using-insights-to-identify-issues-with-your-cluster.adoc
+
+:_content-type: CONCEPT
+[id="insights-operator-advisor-overview_{context}"]
+= About Red Hat Insights Advisor for {product-title}
+
+You can use Insights Advisor to assess and monitor the health of your {product-title} clusters. Whether you are concerned about individual clusters, or with your whole infrastructure, it is important to be aware of your exposure to issues that can affect service availability, fault tolerance, performance, or security.
+
+Insights repeatedly analyzes the data that Insights Operator sends using a database of _recommendations_, which are sets of conditions that can leave your {product-title} clusters at risk. Your data is then uploaded to the Insights Advisor service on Red Hat Hybrid Cloud Console where you can perform the following actions:
+
+* See clusters impacted by a specific recommendation.
+* Use robust filtering capabilities to refine your results to those recommendations.
+* Learn more about individual recommendations, details about the risks they present, and get resolutions tailored to your individual clusters.
+* Share results with other stakeholders. 

modules/insights-operator-advisor-recommendations.adoc

@@ -0,0 +1,17 @@
+// Module included in the following assemblies:
+//
+// * support/remote_health_monitoring/using-insights-to-identify-issues-with-your-cluster.adoc
+
+:_content-type: CONCEPT
+[id="insights-operator-advisor-recommendations_{context}"]
+= Understanding Insights Advisor recommendations
+
+Insights Advisor bundles information about various cluster states and component configurations that can negatively affect the service availability, fault tolerance, performance, or security of your clusters. This information set is called a recommendation in Insights Advisor and includes the following information:
+
+* *Name:* A concise description of the recommendation
+* *Added:* When the recommendation was published to the Insights Advisor archive
+* *Category:* Whether the issue has the potential to negatively affect service availability, fault tolerance, performance, or security
+* *Total risk:* A value derived from the _likelihood_ that the condition will negatively affect your infrastructure, and the _impact_ on operations if that were to happen
+* *Clusters:* A list of clusters on which a recommendation is detected
+* *Description:* A brief synopsis of the issue, including how it affects your clusters
+* *Link to associated topics:* More information from Red Hat about the issue

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

@@ -9,7 +9,9 @@ endif::[]
 
 toc::[]
 
-Insights repeatedly analyzes the data Insights Operator sends. Users of {product-title} can display the report on the *Insights* tab of each cluster in {console-redhat-com}.
+Insights repeatedly analyzes the data Insights Operator sends. Users of {product-title} can display the report in *Insights Advisor* on Red Hat Hybrid Cloud Console.
 
+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-the-insights-status-in-the-web-console.adoc[leveloffset=+1]