Troubleshooting Operational Issues Using System Comparison

Red Hat Insights 2021

How to identify operational issues in systems and generate reports

Red Hat Customer Content Services

Abstract

This workflow example demonstrates how to identify configuration differences between systems and generate CSV reports for analyses.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. We are beginning with these four terms: master, slave, blacklist, and whitelist. Because of the enormity of this endeavor, these changes will be implemented gradually over several upcoming releases. For more details, see our CTO Chris Wright’s message.

Providing feedback on Red Hat Hybrid Cloud Console documentation

We appreciate your input on our documentation. Please let us know how we could make it better. To do so, create a Bugzilla ticket:

  1. Go to the Bugzilla website.
  2. As the Component, use Documentation.
  3. Fill in the Description field with your suggestion for improvement. Include a link to the relevant part(s) of documentation.
  4. Click Submit Bug.

Chapter 1. Overview

In an IT environment, two systems can behave differently even when they have been configured using the same template. The Insights for Red Hat Enterprise Linux service enables IT operators to compare the system configuration of one system to that of other systems.

To identify configuration differences between two or more systems:

  1. Access the Insights for Red Hat Enterprise Linux service.
  2. Add systems manually within Insights for Red Hat Enterprise Linux and view profiles.
  3. Filter the system facts by state to highlight differences and incomplete data.
  4. Export the filtered output to a CSV file for further analysis.

Chapter 2. Accessing the system and baselines comparison service

The Insights for Red Hat Enterprise Linux service is part of Insights for Red Hat Enterprise Linux application. Access this service via Red Hat Hybrid Cloud Console.

Procedure

  1. Navigate to Red Hat Enterprise Linux > Drift > Comparison. The Comparison screen opens.

    img drift comparison screen

  2. Cick Add to comparison. The Add to comparison screen opens, where you can add systems or baselines to compare.

    img drift add to comparison screen

    • On the Systems tab, you can add any systems you want to compare. This screen also lists any baselines that already exist in your Insights for RHEL application inventory.
    • On the Baselines tab, you can create baselines. This screen also lists any baselines that already exist in your inventory.

      img drift baselines screen

  3. Click Submit to add your systems or baselines for comparison.

Once you add them, you can start comparing the facts of systems and baselines in your Insights for RHEL application inventory.

Chapter 3. Adding systems manually within system comparison

Within the Insights for Red Hat Enterprise Linux service, you can add systems registered in your Insights for RHEL application inventory.

Procedure

  1. Navigate to Red Hat Enterprise Linux > Drift > Comparison. The Comparison screen opens.
  2. Click Add to comparison.
  3. Select the systems to compare from the list. Alternatively, enter the system name in the search box to find by name, and then select the system.
  4. Click Submit.
Note
  • At any time, you can add more systems by clicking the Add to comparison button near the top of the Comparison screen.
  • Similarly, you can remove a particular system under comparison by clicking the X symbol on the upper-right corner of the individual system name, or you can remove all systems under comparison by clicking the options menu img drift options menu located at the top, then clicking Clear all comparisons to start again.

Chapter 4. Filtering system facts

Filter the system profiles by state to highlight any differences between the systems, and incomplete data.

  1. Click the View drop-down list and select Same to show facts that are identical.
  2. Click the View drop-down list and select Different to show facts that are different.
  3. Click the View drop-down list and select Incomplete Data to show facts where information is incomplete.

In the example screen capture below, you can see the system comparison data filtered by facts that show a difference across systems. Some facts, such as the fqdn, are expected to be different for each system, but the installed packages are expected to be the same. Over time, some packages have been upgraded on system 1, but not on system 2 and system 3, as shown by expanding the fact category installed_packages.

img drift comparison with diffs screen

Chapter 5. Exporting system comparison output

The Comparison service allows you to export system comparison output, along with any current selections such as filters, to a comma-separated values (CSV) file.

Note

The exported CSV report preserves all your current selections on the system comparison output, including any filters applied. That is, it follows the WYSIWYG (What You See Is What You Get) paradigm. Therefore, you will need to expand any nested fact categories (installed_packages, for example) to be exported in the report.

Procedure

  1. On the Comparison output screen for two or more systems, click the Export to CSV icon ( img drift export as csv icon ), and then select Export to CSV.
  2. Save the CSV file to the location of your choice so that you can easily compare exported facts and analyze discrepancies in systems.

Legal Notice

Copyright © 2021 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.