Menu Close
Monitoring your OpenShift cluster health with Insights Advisor
Using Insights Advisor to monitor your OpenShift cluster health
Abstract
Chapter 1. About Red Hat Insights Advisor for OpenShift Container Platform
Use Red Hat Insights Advisor for OpenShift Container Platform to identify and solve issues with your clusters.
1.1. About Red Hat Insights Advisor for OpenShift Container Platform
You can use Insights Advisor to assess and monitor the health of your OpenShift Container Platform 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 OpenShift Container Platform 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.
To use Insights Advisor, your cluster must be registered to OpenShift Cluster Manager. To register a disconnected cluster, see Registering OpenShift Container Platform clusters to OpenShift Cluster Manager.
Additional resources
- Insights Advisor does not collect identifying information, such as user names, passwords, or certificates. See Red Hat Insights Data & Application Security for information about Red Hat Insights data collection and controls.
- For more information on how Insights Advisor gathers data from OpenShift, see the OpenShift Container Platform documentation:
- About remote health monitoring
- Showing data collected by remote health monitoring
- Opting out of remote health reporting
1.2. 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
- Link to associated topics: More information from Red Hat about the issue
Chapter 2. Using Red Hat Insights Advisor for OpenShift Container Platform
Insights Advisor repeatedly analyzes the data Insights Operator sends. You can view and manage reports showing Insights Advisor data for your OpenShift Container Platform cluster from the Insights Advisor service on Red Hat Hybrid Cloud Console.
2.1. Displaying potential issues with your cluster
This section describes how to display the Insights report in Insights Advisor on Red Hat Hybrid Cloud Console.
Note that Insights repeatedly analyzes your cluster and shows the latest results. These results can change, for example, if you fix an issue or a new issue has been detected.
Prerequisites
- Your cluster is registered with OpenShift Cluster Manager.
- Remote health reporting is enabled, which is the default.
- You are logged in to Red Hat Hybrid Cloud Console.
Procedure
Navigate to Advisor → Recommendations on Red Hat Hybrid Cloud Console.
Depending on the result, Insights Advisor displays one of the following:
- No matching recommendations found, if Insights did not identify any issues.
- A list of issues Insights has detected, grouped by risk (low, moderate, important, and critical).
- No clusters yet, if Insights has not yet analyzed the cluster. The analysis starts shortly after the cluster has been installed, registered, and connected to the internet.
If any issues are displayed, click the > icon in front of the entry for more details.
Depending on the issue, the details can also contain a link to more information from Red Hat about the issue.
2.2. Displaying all Insights Advisor recommendations
The Recommendations view, by default, only displays the recommendations that are detected on your clusters. However, you can view all of the recommendations in the Insights Advisor archive.
Prerequisites
- Remote health reporting is enabled, which is the default.
- Your cluster is registered with OpenShift Cluster Manager.
- You are logged in to Red Hat Hybrid Cloud Console.
Procedure
- Navigate to Advisor → Recommendations on Red Hat Hybrid Cloud Console.
Click the X icons next to the Clusters Impacted and Status filters.
You can now browse through all of the potential recommendations for your cluster.
2.3. Disabling Insights Advisor recommendations
You can disable specific recommendations that affect your clusters, so that they no longer appear in your reports. It is possible to disable a recommendation for a single cluster or all of your clusters.
Disabling a recommendation for all of your clusters also applies to any future clusters.
Prerequisites
- Remote health reporting is enabled, which is the default.
- Your cluster is registered with OpenShift Cluster Manager.
- You are logged in to Red Hat Hybrid Cloud Console.
Procedure
- Navigate to Advisor → Recommendations on Red Hat Hybrid Cloud Console.
To disable the recommendation for a single cluster:
- Click the name of the recommendation to disable. You are directed to the single recommendation page.
-
Click the Options menu
for that cluster, and then click Disable recommendation for cluster.
- Enter a justification note and click Save.
To disable the recommendation for all of your clusters:
- Click the name of the recommendation to disable. You are directed to the single recommendation page.
- Click Actions → Disable recommendation.
- Enter a justification note and click Save.
2.4. Enabling a previously disabled Insights Advisor recommendation
When a recommendation is disabled for all clusters, you will no longer see the recommendation in Insights Advisor. You can change this behavior.
Prerequisites
- Remote health reporting is enabled, which is the default.
- Your cluster is registered with OpenShift Cluster Manager.
- You are logged in to Red Hat Hybrid Cloud Console.
Procedure
- Navigate to Advisor → Recommendations on Red Hat Hybrid Cloud Console.
- Filter the recommendations by Status → Disabled.
- Locate the recommendation to enable.
-
Click the Options menu
, and then click Enable recommendation.
2.5. Displaying the Insights Advisor status in the web console
Insights Advisor repeatedly analyzes your cluster and you can display the status of identified potential issues of your cluster in the OpenShift Container Platform web console. This status shows the number of issues in the different categories and, for further details, links to the reports in Red Hat Hybrid Cloud Console.
Prerequisites
- Your cluster is registered with OpenShift Cluster Manager.
- Remote health reporting is enabled, which is the default.
- You are logged in to the OpenShift Container Platform web console.
Procedure
- Navigate to Home → Overview in the OpenShift Container Platform web console.
Click Insights on the Status card.
The pop-up window lists potential issues grouped by risk. Click the individual categories or View all recommendations in Insights Advisor to display more details.