Language and Page Formatting Options
Chapter 1. Client Configuration Guide for Red Hat Insights
The Insights for RHEL client runs on your RHEL system and gathers management data that is uploaded to Red Hat Insights for Red Hat Enterprise Linux and the suite of management applications available on Red Hat Hybrid Cloud Console. You control each instance of the Insights for RHEL client through configuration commands and settings.
1.1. Insights client configuration overview
insights-client command and associated configuration files, you can control how your system interacts with Red Hat Insights for Red Hat Enterprise Linux.
- General information and overviews of the Insights client features are covered in the first few chapters.
- How-to information on using the Insights client commands and configuration files to accomplish specific tasks follows the overview information.
- Command reference and configuration file reference information is at the end of this guide.
Navigation links help you quickly find what you are looking for.
1.2. Client configuration overview
The Insights client collects information about your system and sends it to Red Hat Insights for Red Hat Enterprise Linux, which is a cloud application. Command options for the CLI and configuration file options modify the information that is collected and shared with Red Hat Insights for Red Hat Enterprise Linux. These options control the following:
IP address obfuscationNote
IP address obfuscation is supported only for IPv4 addresses.
- Host name obfuscation
- Specific files
- Output of specific commands
- Pattern-match deletions
- Keyword replacement
- Insights client scheduling
- Insights for RHEL rule updates
Insights client authentication method
- SSO-based, or Basic
- System tagging
The information collected by the Insights client is saved in a
tar file, that file is referred to as an archive file.
The Red Hat Insights for Red Hat Enterprise Linux compliance service uses OpenSCAP tools to generate compliance reports based on information from the host system. The collaboration with OpenSCAP prevents the compliance service’s ability to completely obfuscate or redact host name and IP address data. Also, host information is sent to Insights for RHEL when a compliance data collection job launches on the host system. Red Hat Insights for Red Hat Enterprise Linux is working to improve obfuscation options for host information.
For information about how Red Hat Insights for Red Hat Enterprise Linux handles data collection, see Red Hat Insights Data & Application Security.
1.3. Insights client CLI and configuration file interactions
The Insights client runs according to its scheduler, which by default is every 24 hours. The client also runs when you enter the
When the client runs, its behavior is controlled, in order, by the following:
The values, if any, provided when you enter the
insights-clientcommand. Values entered in the CLI override configuration file settings and system environment settings for that execution of the Insights client.
The settings in the configuration files (
/etc/insights-client/remove.conf) override system environment settings.
The values of any system environment variables (
printenv) not affected by the CLI or the client configuration files are used.
Any options you provide in the
insights-client command are used only for that execution. Those values can temporarily override values set in the configuration file or the environment variables.
insights-client command to set the display name takes effect immediately but does not run the Insights client.
If you are using RHEL 6.9 or earlier, the client command is
1.4. Red Hat Insights client distribution
Insights client is available on Red Hat Enterprise Linux (RHEL) as shown in the following table.
Distributed with Insights client pre-installed, unless RHEL 8 was installed as a minimal installation.
Distributed with the Insights client RPM package loaded but not installed.
RHEL 6.10 and later
You must download the Insights client RPM package and install it.
Insights client installation on older versions
RHEL versions 6 and 7 do not come with the Insights client pre-installed. If you have one of these versions, run the following commands in your terminal:
[root@server ~]# yum install insights-client
Then, register the system to Red Hat Insights for Red Hat Enterprise Linux:
[root@server ~]# insights-client --register
Minimal Installation Configuration
The Insights client is not automatically installed on systems running the minimal installation of RHEL 8.
To create a minimal installation with the Insights client, select Minimal Installation from the RHEL Software Selection options in the Anaconda installer. Make sure to select the Standard checkbox in the Additional Software for Selected Environment section. The Standard option includes the insights-client package in the RHEL installation.
If you do not select the Standard checkbox, RHEL installs without the insights-client package. If that happens, you can use
dnf install to install the Insights client at a later time.