Monitoring Hosts Using Red Hat Insights

In this chapter, you can find information about creating host monitoring reports and monitoring your hosts using Red Hat Insights and creating an Insights plan.

Installing Red Hat Cloud Plug-in

Install the Red Hat Cloud plug-in to generate and upload reports from orcharhino to your Red Hat Hybrid Cloud Console.

  1. Install the Red Hat Cloud plug-in on your orcharhino Server:

    # orcharhino-installer --enable-foreman-plugin-rh-cloud
  2. Optional: In the orcharhino management UI, navigate to Administer > About and select the Plugins tab to verify the installation of the Red Hat Cloud plug-in.

Using Red Hat Insights with Hosts in orcharhino

You can use Red Hat Insights to diagnose systems and downtime related to security exploits, performance degradation and stability failures. You can use the 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 Red Hat Insights to monitor hosts that you manage with orcharhino, you must first install Red Hat Insights on your hosts and register your hosts with Red Hat Insights.

For new orcharhino hosts, you can install and configure orcharhino hosts with Insights during registration using the global registration template. For more information, see Registering a Host to orcharhino Using the Global Registration Template in Managing Hosts.

To install and register your host using Puppet, or manually, see Red Hat Insights Getting Started.

Red Hat Insights Information Available for Hosts

Additional information is available about hosts through Red Hat Insights.

You can find this information in two places:

  • In the orcharhino management 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 provide 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 provide a Go To orcharhino Insights page link to information for the system, and a View in Red Hat Insights link to host details on the console.

Excluding hosts from rh-cloud and insights-client reports

You can set the host_registration_insights parameter to False to omit rh-cloud and insight-client reports. orcharhino will exclude the hosts from rh-cloud reports and block insight-client from uploading a report to the cloud.

You can also set this parameter at the organization, hostgroup, subnet, and domain level. It automatically prevents new reports from being uploaded as long as they are associated with the entity.

If you set the parameter to false on a host that is already reported on the Red Hat Hybrid Cloud, it will be still removed automatically from the inventory. However, this process can take some time to complete.

Deploying Red Hat Insights using the Ansible Role

You can automate the installation and registration of hosts with Red Hat Insights using the RedHatInsights.insights-client Ansible role. For more information about adding this role to your orcharhino, see Getting Started with Ansible in orcharhino in Managing Hosts using Ansible.

  1. Add the RedHatInsights.insights-client role to the hosts.

    For new hosts, see Creating a Host.

    For existing hosts, see Using Ansible Roles to Automate Repetitive Tasks on Clients in Managing Hosts using Ansible.

  2. 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.

  3. Click the Run Ansible roles button.

You must set up the API token for Insights before continuing. For further information, see Red Hat API Tokens.

You can manually synchronize the recommendations using the following procedure:

  1. In the orcharhino management UI, navigate to Configure > Insights.

  2. Click the Start Recommendations Sync button.

If you have not set up the API token, you are prompted to create one before using this page.

Additional Information
  • To view the logs for Red Hat Insights and all plug-ins, go to /var/log/foreman/production.log.

  • If you have problems connecting to Red Hat 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-client by configuring insights-client.timer on a host.

Creating an Insights Plan for Hosts

With orcharhino, you can create a Red Hat Insights remediation plan and run the plan on orcharhino hosts.

  1. In the orcharhino management UI, navigate to Configure > Insights.

  2. 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.

  3. Click Remediate.

  4. In the Remediation Summary window, you can select the Resolutions to apply. Use the Filter field to search for specific keywords.

  5. Click Remediate.

  6. In the Job Invocation page, do not change the contents of precompleted fields.

  7. Optional. For more advanced configuration of the Remote Execution Job, click Show Advanced Fields.

  8. Select the Type of query you require.

  9. Select the Schedule you require.

  10. Click Submit.


  1. In the orcharhino management UI, navigate to Hosts > All Hosts.

  2. Select a host.

  3. On the Host details page, click Recommendations.

  4. 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.

The text and illustrations on this page are licensed by ATIX AG under a Creative Commons Attribution–Share Alike 3.0 Unported ("CC-BY-SA") license. This page also contains text from the official Foreman documentation which uses the same license ("CC-BY-SA").