Chapter 12. Send reports to the Red Hat Hybrid Cloud Console
After you run a scan, you can send an Red Hat Lightspeed report to the Red Hat Hybrid Cloud Console at cloud.redhat.com. This report is formatted for ingestion by Red Hat Hybrid Cloud Console services.
The Red Hat Lightspeed report is a third type of report, separate from the details report and the deployments report. When you send Red Hat Lightspeed reports to the Red Hat Hybrid Cloud Console, the report data can be used by services such as Subscriptions Inventory of Red Hat Lightspeed to display host-based inventory data. It can also be used by Subscription Services to display subscription usage data.
12.1. Download and send Red Hat Lightspeed reports to the Red Hat Hybrid Cloud Console Copy linkLink copied to clipboard!
When you need to provide report data to the Red Hat Hybrid Cloud Console services such as the Red Hat Lightspeed Subscriptions Inventory and Subscription Services, you download and send an insights report.
This type of report is different from a details report or a deployments report. A Red Hat Lightspeed report is a Discovery report with data that is similar to the deployments report. However, its contents and format are designed especially to be ingested and used by the Red Hat Hybrid Cloud Console services.
Prerequisites
- The most recent scan job for that scan has completed successfully.
- You are logged in to Red Hat Lightspeed in the Discovery graphical user interface (GUI).
Procedure
- Log in to the Discovery graphical user interface.
Find the
IDvalue for the scan job that you want to use to create an Red Hat Lightspeed report.NoteDepending on how your reports were created, you may locate them using the
Scan IDorScan Namefields that relate to the scans that produced the reports. Merged and uploaded reports may not have values in theScan IDorScan Namefields.Select
Publishto send the Lightspeed report to the Red Hat Hybrid Cloud Console and the services that can consume the reports, such as Subscriptions Inventory and Subscription Services.NoteWhile you can view the output of insights reports, the Discovery documentation does not provide any information to help you interpret Lightspeed report results. Red Hat Support can provide some basic assistance related to the installation and use of Discovery. However, the support team does not provide any assistance to help you understand the Lightspeed reports. The Lightspeed reports and their format are designed for use by Red Hat internal processes, such as providing data to various Red Hat Hybrid Cloud Console services.
Verification
- Verify that a confirmation message displays in the Discovery graphical user interface, confirming that the report was sent to the Red Hat Hybrid Cloud Console.
12.2. Download and publish Lightspeed reports to the Red Hat Hybrid Cloud Console with the CLI Copy linkLink copied to clipboard!
Download and publish a Lightspeed report with the Discovery command line interface (CLI) to provide data from Discovery to Red Hat Hybrid Cloud Console services such as Red Hat Lightspeed Subscriptions Inventory and Subscription Services.
This type of report is different from the details report or deployments report contained in the .tar.gz files you may normally download from Discovery. A Lightspeed report is a Discovery report with data that is similar to the deployments report, but its contents and format are restructured specifically for use by the Red Hat Hybrid Cloud Console services.
Prerequisites
- A scan job has completed successfully, or you have successfully merged reports from previous scan jobs.
- The deployments report from that scan job or merge contains at least one valid host.
- The Discovery command line interface is installed on the same system as the Discovery server.
Procedure
Log in to the command line interface, where
server_administrator_usernameis the username for the Discovery server administrator andserver_administrator_passwordis the password for the server administrator:dsc server login --username __server_administrator_username__ --password __server_administrator_password__Find the
report_idvalue for the scan job that you want to use to create a Lightspeed report. The following command returns the summary details for all created scan objects:dsc scan list --tableNoteIf you know the scan name but not the
report_idvalue, you can use theqpc scan show --name scan_namecommand to show the scan jobs for that scan only.Using the
report_idvalue that you located, download the Lightspeed report for the scan job. In the following example command, the file name assigned to the downloaded report isreport.tar.gzbut you can change this filename as needed:dsc report insights --report __report_id__ --output-file report.tar.gzAdd the credentials that you use to log in to the Red Hat Hybrid Cloud Console, generally your Red Hat Customer Portal account, to the command line interface configuration. This step is needed so that these credentials can be used in the next step to publish the Lightspeed report to the Red Hat Hybrid Cloud Console.
dsc insights loginUse the
publishsubcommand to publish the Lightspeed report data to the Red Hat Hybrid Cloud Console and the services that can consume the reports, such as Subscriptions Inventory and Subscription Services.dsc insights publish --input-file report.tar.gzNoteWhile you can view the output of Lightspeed reports, the Discovery documentation does not provide any information to help you interpret Lightspeed report results. Red Hat Support can provide some basic assistance related to the installation and use of Discovery. However, the support team does not provide any assistance to help you understand the Lightspeed reports. The Lightspeed reports and their format are designed for use by Red Hat internal processes, such as providing data to various Red Hat Hybrid Cloud Console services.
Verification
- Verify that the command output confirms the Lightspeed report was published successfully to the Red Hat Hybrid Cloud Console.
12.3. Red Hat Lightspeed report overview Copy linkLink copied to clipboard!
An Red Hat Lightspeed report is a specialized report formatted for Red Hat Hybrid Cloud Console services. Send it to Subscriptions Inventory for host-based inventory data and Subscription Services for subscription usage data.
Although Discovery is useful for scanning and reporting on all parts of your IT infrastructure, sending a report to the Red Hat Hybrid Cloud Console services is particularly useful for disconnected or air-gapped environments. By using Discovery to gather data about those parts of your network, you can get a more complete and more curated view of your overall network.
Red Hat Hybrid Cloud Console provides a unified inventory and a more complete picture of subscription usage. This is possible when the data from Discovery’s Red Hat Lightspeed report combines with data from other tools that support Red Hat Hybrid Cloud Console.
12.3.1. Frequency of reporting Copy linkLink copied to clipboard!
All disconnected or air-gapped systems must be periodically scanned and reported through an Red Hat Lightspeed report to ensure that accurate data is reaching the Red Hat Hybrid Cloud Console. A weekly cadence of sending a Red Hat Lightspeed report is the current recommendation. A weekly cadence provides sufficient milestones for effectively monitoring subscription usage in Subscription Services.