Generating Advisor Service Reports

Red Hat Insights 2020-04

Share reporting from Advisor about the conditions affecting your RHEL infrastructure.

Red Hat Customer Content Services

Abstract

The Advisor service provides several ways to download and share reporting.
Providing Feedback: If you have a suggestion to improve this documentation, or find an error, submit a Bugzilla report at http://bugzilla.redhat.com. Select the Cloud Software Services (cloud.redhat.com) product and use the Documentation component.

Chapter 1. Advisor service reporting overview

The Advisor service enables the following ways to share the status of your Red Hat Enterprise Linux (RHEL) infrastructure:

  • Export and download a report in CSV or JSON file format showing recommendations for your impacted RHEL systems, and share the information with strategic stakeholders.
  • Subscribe to the Advisor Weekly Report email to receive a brief summary of the health of your RHEL environment.
  • Download an executive report to share a high level overview of your infrastructure with an executive audience.

These methods enable a quick and easily accessible way for you or other stakeholders to assess the health of your infrastructure and plan or act accordingly.

Chapter 2. Advisor service data export

Advisor service users can export a report in either JSON or CSV format that shows the recommendations impacting each of your registered systems. Exported reports include the following information:

  • Host name
  • Inventory UUID for the host
  • RHEL version
  • Date and time of the last data upload from this host to Insights
  • Title of the recommendation impacting the host
  • Link to the solution for this recommendation
  • Total risk posed by this recommendation (from 1 to 4; 1 means low risk, 4 means high risk)
  • Likelihood of this recommendation being active on your registered systems (from 1 to 4 = 1 means unlikely; 4 means highly probable)
  • Date this recommendation was published
  • Link to the scan results for this host

2.1. Exporting reports using the Advisor service

To export a report using the Advisor service, complete the following steps:

  1. Navigate to the Advisor service > Recommendations page and log in if necessary.
  2. Apply filters as needed to refine results.
  3. Click the Download icon located to the right of the Search box in the toolbar.
  4. Select either Export to CSV or Export to JSON depending on your preference.
  5. In the dialog box, select Open with and specify an application with which to open the file, or click Save File and click OK.

2.2. Exporting Advisor service data using the API

Use the Advisor service API to export data in one of the following ways:

API documentation for all of the Red Hat Insights services is available at https://cloud.redhat.com/docs/api.

Chapter 3. Advisor service Weekly Report email subscription

The Advisor service Weekly Report email provides a quick view of the health of your environment. Subscribing to the email is optional and requires that you opt in using the settings in the Advisor service. The email is informative yet unobtrusive; all of the included information can be consumed at a glance.

The email is sent every Sunday night (United States Eastern Standard Time, UTC -05:00; Easter Daylight Time, UTC-4:00) to the email address associated with your individual Red Hat Customer Portal user account, allowing you to begin your week informed. When you opt in, your subscription preference will apply only to yourself, and not everyone in your organization.

The email provides the following information about systems registered to your account:

  • Number of critical rule hits in your infrastructure
  • Number of impacted systems in your infrastructure
  • Total number of recommendations impacting your infrastructure

3.1. Subscribing to the Advisor service Weekly Report email

You must subscribe to the weekly email in order to receive it.

Procedure to subscribe to the Weekly Report email

Use the following procedure to subscribe to the Advisor Weekly Report email.

  1. Navigate to the Advisor service > Recommendations page and log in if necessary.
  2. Click the down arrow to the right of your name and click User settings.

    adv user settings

  3. Under the Email subscriptions heading, next to Insights, check the Weekly Report check box.

    adv weekly email opt in

  4. Click Submit.

You will receive the email each Sunday night from sender, Red Hat Insights noreply@redhat.com, with the subject line, Weekly Insights summary report.

To unsubscribe, follow the procedure above and clear the Weekly Report check box.

Chapter 4. Advisor service executive report

You can download a high-level report summarizing the status of your infrastructure and designed for an executive audience. Executive reports are one to two-page PDF files showing the following information:

  • Identified recommendations by severity
  • Recently identified recommendations by category
  • Top three recommendations in your infrastructure based on the greatest total risk and the greatest number of systems exposed

4.1. Downloading an Advisor service executive report

Use the following procedure to download an executive report from the Advisor service.

Procedure

  1. Navigate to the Advisor service > Recommendations page and log in if necessary.
  2. Located in the upper-right corner of the Recommendations page, click the Download executive report link.
  3. Select to open or save the file and click OK.
  4. If downloaded, check your download location for the PDF file.

Chapter 5. Reference materials

To learn more about the Advisor service, see the following resources:

Chapter 6. Important changes with the 2020-04 release of Red Hat Insights

The 2020-04 release of Red Hat Insights includes significant changes to the application features and services.

Changes to the Red Hat Insights application

The Red Hat Insights application now includes the services that were previously bundled with the Cloud Management Services for RHEL application, and were part of the Red Hat Smart Management bundle, along with Red Hat Satellite.

The former cloud management services, plus a couple of new services, are now included in the value that Insights brings to each Red Hat Enterprise Linux (RHEL) subscription.

Insights Advisor

The tools and capabilities that constituted Red Hat Insights prior to this release are now available as the Advisor service. The rules that have always been the currency of Insights are now called Advisor Recommendations.

Insights security rules have moved

The CVE security rules that were previously curated by the Insights rules team are now included with all other Red Hat CVEs in the Vulnerability service. Security rules are high profile CVEs, some of which have been through the Customer Security Awareness Program. They are identifiable in the Vulnerability service by a security rule icon. You can also filter security rules in the Vulnerability service.

Services included with Red Hat Insights

The services included with Red Hat Insights in the 2020-04 release are:

  • Advisor. Identify and fix configuration issues that can negatively impact the availability, performance, stability, and security of RHEL systems.
  • Vulnerability. Assess and monitor the exposure of your RHEL environment to CVEs and security rules.
  • Compliance. Assess and monitor the compliance of your RHEL systems with SCAP security policies.
  • Patch. Enable consistent patch workflows for RHEL systems across the open hybrid cloud.
  • Drift. Compare system configurations of a system over time, or to other systems and baselines, to identify discrepancies in your environment and perform drift analysis.
  • Policies. Evaluate and react to system configuration changes in your environment.

The integrated tools that work with each of the services above are:

  • Inventory. Topological inventory of RHEL systems under Red Hat Insights management
  • Remediations. Repository of Ansible Playbooks that you create and manage using Red Hat Insights
  • Subscription Watch. Comprehensive, product-by-product, account-level subscription reporting service across hybrid cloud deployments

Legal Notice

Copyright © 2020 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.