Troubleshooting Operational Issues Using System Comparison

Red Hat Insights 2020-10

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.
Providing Feedback:
If you have a suggestion to improve this document or find an error, submit a Bugzilla report at http://bugzilla.redhat.com against Cloud Software Services (cloud.redhat.com) for the System Comparison component.

Chapter 1. Overview

In an IT environment, two systems can behave differently even when they have been configured using the same template. The System Comparison 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 System Comparison service.
  2. Add systems manually within System Comparison 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 System Comparison service is part of Red Hat Insights. Access this service via https://cloud.redhat.com.

Procedure

  1. On https://cloud.redhat.com, in the Red Hat Insights panel, click Drift. The Comparison screen opens.

    drift comparison screen

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

    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 inventory.
    • On the Baselines tab, you can create baselines. This screen also lists any baselines that already exist in your inventory.

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

Chapter 3. Adding Systems Manually within System Comparison

Within the System Comparison service, you can add systems registered in your Insights inventory.

Add systems registered in your Insights inventory within the {ServiceName} service.

Procedure

  1. On the Insights user interface, click DriftComparison in the left-side navigation menu. The Comparison service opens to the Comparison screen.
  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 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 Different to show facts that are different.
  2. 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.

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.

Export the system profiles you filtered above by state to highlight the differences and incomplete data 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 as CSV icon ( drift export as csv icon ), and then select either Export as CSV, or Clear all comparisons.

    export csv1

  2. Open the CSV file with the tool of your choice so that you can easily compare exported facts and analyze discrepancies in systems.

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.