Chapter 10. Monitoring hosts by using Red Hat Insights
You can use Insights to diagnose systems and downtime related to security exploits, performance degradation, and stability failures. You can use the Insights dashboard to quickly identify key risks to stability, security, and performance. You can sort by category, view details of the impact and resolution, and then determine what systems are affected.
To use Insights to monitor hosts that you manage with Satellite, you must first install Insights on your hosts and register your hosts with Insights.
For new Satellite hosts, you can install and configure Insights during host registration to Satellite. For more information, see Section 4.3, “Registering hosts by using global registration”.
For hosts already registered to Satellite, you can install and configure Insights on your hosts by using an Ansible role. For more information, see Section 10.3, “Deploying Red Hat Insights by using the Ansible role”.
Additional information
-
To view the logs for all plugins, go to
/var/log/foreman/production.log. - If you have problems connecting to Insights, ensure that your certificates are up-to-date. Refresh your subscription manifest to update your certificates.
-
You can change the default schedule for running
insights-clientby configuringinsights-client.timeron a host. For more information, see Changing the insights-client schedule in the Client Configuration Guide for Red Hat Insights.
10.1. Access to information from Insights in Satellite
You can access the additional information available for hosts from Red Hat Insights in the following places in the Satellite web UI:
- Navigate to Configure > Insights where the vertical ellipsis next to the Remediate button provides a View in Red Hat Insights link to the general recommendations page. On each recommendation line, the vertical ellipsis provides a View in Red Hat Insights link to the recommendation rule, and, if one is available for that recommendation, a Knowledgebase article link.
- For additional information, navigate to Hosts > All Hosts. If the host has recommendations listed, click on the number of recommendations. On the Insights tab, the vertical ellipsis next to the Remediate button provides a Go To Satellite Insights page link to information for the system, and a View in Red Hat Insights link to host details on the console.
10.2. Excluding hosts from rh-cloud and insights-client reports
You can set the host_registration_insights parameter to False to omit rh-cloud and insights-client reports. Satellite will exclude the hosts from rh-cloud reports and block insights-client from uploading a report to the cloud.
Procedure
- In the Satellite web UI, navigate to Host > All Hosts.
- Select any host for which you want to change the value.
-
On the Parameters tab, click on the edit button of
host_registration_insights. - Set the value to False.
If you set the parameter to false on a host that is already reported on the Red Hat Hybrid Cloud Console, it will be still removed automatically from the inventory. However, this process can take some time to complete.
Additional resources
- You can set this parameter at any level. For more information, see Host parameter hierarchy in Provisioning hosts.
10.3. Deploying Red Hat Insights by using the Ansible role
The RedHatInsights.insights-client Ansible role is used to automate the installation and registration of hosts with Insights. For more information about adding this role to your Satellite, see Getting Started with Ansible in Satellite in Managing configurations by using Ansible integration.
Procedure
Add the RedHatInsights.insights-client role to the hosts.
For new hosts, see Section 2.1, “Creating a host in Red Hat Satellite”.
For existing hosts, see Using Ansible Roles to Automate Repetitive Tasks on Clients in Managing configurations by using Ansible integration.
- To run the RedHatInsights.insights-client role on your host, navigate to Hosts > All Hosts and click the name of the host that you want to use.
- On the host details page, expand the Schedule a job dropdown menu.
- Click Run Ansible roles.
10.4. Configuring synchronization of Insights recommendations for hosts
You can enable automatic synchronization of the recommendations from Red Hat Hybrid Cloud Console that occurs daily by default. If you leave the setting disabled, you can synchronize the recommendations manually.
Procedures
To get the recommendations automatically:
- In the Satellite web UI, navigate to Configure > Insights.
- Enable Sync Automatically.
To get the recommendations manually:
- In the Satellite web UI, navigate to Configure > Insights.
- On the vertical ellipsis, click Sync Recommendations.
10.5. Configuring automatic removal of hosts from the Insights Inventory
When hosts are removed from Satellite, they can also be removed from the inventory of Red Hat Insights, either automatically or manually. You can configure automatic removal of hosts from the Insights Inventory during Red Hat Hybrid Cloud Console synchronization with Satellite that occurs daily by default. If you leave the setting disabled, you can still remove the bulk of hosts from the Inventory manually.
Prerequisites
-
Your user account must have the permission of
view_foreman_rh_cloudto view the Inventory Upload page in Satellite web UI.
Procedure
- In the Satellite web UI, navigate to Configure > Inventory Upload.
- Enable the Automatic Mismatch Deletion setting.
10.6. Creating an Insights remediation plan for hosts
With Satellite, you can create a Red Hat Insights remediation plan and run the plan on Satellite hosts.
Procedure
- In the Satellite web UI, navigate to Configure > Insights.
On the Red Hat Insights page, select the number of recommendations that you want to include in an Insights plan.
You can only select the recommendations that have an associated playbook.
- Click Remediate.
- In the Remediation Summary window, you can select the Resolutions to apply. Use the Filter field to search for specific keywords.
- Click Remediate.
- In the Job Invocation page, do not change the contents of precompleted fields.
- Optional. For more advanced configuration of the Remote Execution Job, click Show Advanced Fields.
- Select the Type of query you require.
- Select the Schedule you require.
- Click Submit.
Alternatively:
- In the Satellite web UI, navigate to Hosts > All Hosts.
- Select a host.
- On the Host details page, click Recommendations.
- On the Red Hat Insights page, select the number of recommendations you want to include in an Insights plan and proceed as before.
In the Jobs window, you can view the progress of your plan.
