Chapter 2. Installing and configuring the resource-optimization components
Installing resource optimization involves installing packages, configuring settings and enabling local services. This can be done manually, or with an Ansible playbook provided by Red Hat.
Pay as you go (PAYG) customers need to register the Insights client with subscription-manager (RHSM). There are two ways to register with subscription-manager:
- Using activation keys (recommended)
- Using your user name and password
For more information about how to register the Insights client, refer to Client Configuration Guide for Red Hat Insights with FedRAMP.
| RHEL Versions | Cloud Provider | Resource Optimization Compatibility |
|---|---|---|
| 8.x-9.x | AWS | Yes (x86_64 and ARM 64-bit) |
| 7.7-7.9 | AWS | Yes (x86_64 and ARM 64-bit) |
| 7.0-7.6 | AWS | No |
| 6.x | AWS | No |
Prerequisites
The following applications and configurations need to be installed or confirmed before the resource optimization service can be used:
- Cloud marketplace RHEL instance is configured.
- The Insights client is installed on the system and is operational.
2.1. Installing resource-optimization components
2.1.1. Installing resource optimization
Procedure
Use the following manual installation procedure: . Ensure the latest version of insights-client is installed.
$ yum update insights-client
-
Set
core_collect=Truein/etc/insights-client/insights-client.conf Install the Performance Co-Pilot (PCP) toolkit.
$ sudo yum install pcp
Create the PCP configuration file
/var/lib/pcp/config/pmlogger/config.roswith this content:log mandatory on default { hinv.ncpu mem.physmem mem.util.available disk.dev.total kernel.all.cpu.idle kernel.all.pressure.cpu.some.avg kernel.all.pressure.io.full.avg kernel.all.pressure.io.some.avg kernel.all.pressure.memory.full.avg kernel.all.pressure.memory.some.avg } [access] disallow .* : all; disallow :* : all; allow local:* : enquire;To configure pmlogger to gather the metrics required by resource optimization, add this line to
/etc/pcp/pmlogger/control.d/local:LOCALHOSTNAME n n PCP_LOG_DIR/pmlogger/ros -r -T24h10m -c config.ros -v 100Mb
NoteIn previous versions of this procedure, this line began with
LOCALHOSTNAME n y. The procedure now advises that you useLOCALHOSTNAME n n, which disables the usage ofpmsocks. For more information aboutpmsocks, refer to themanpage forpmsocks.Start and enable the required PCP services.
$ sudo systemctl enable pmcd pmlogger $ sudo systemctl start pmcd pmlogger
Re-register insights-client and upload the archive. The system will show in Insights immediately in a "Waiting for data" state, and data and suggestions will be available the day after registering.
$ sudo insights-client --register
Verification step
Data files with a timestamp will appear under /var/log/pcp/pmlogger/ros and after a few minutes, you can verify metrics are being collected:
$ ls -l /var/log/pcp/pmlogger/ros $ pmlogsummary /var/log/pcp/pmlogger/ros/
2.2. Enabling Kernel Pressure Stall Information (PSI)
PSI provides a canonical way to see resource pressure increases as they develop. There are pressure metrics for three major resources: memory, CPU, and input/output (I/O). PSI is available on RHEL 8 and newer versions, and is disabled by default.
When PSI is enabled, the resource optimization service can augment its findings and provide more details and better suggestions. Enabling PSI is strongly recommended to identify peaks.
Procedure
-
Edit the
/etc/default/grubfile and appendpsi=1at the end of the GRUB_CMDLINE_LINUX line (mind the quotes). Regenerate the grub configuration file.
$ sudo grub2-mkconfig -o /boot/grub2/grub.cfg
- Reboot the system.
Enabling PSI incurs in a slight (<1%) performance hit.
Verification step
When PSI is enabled, files for CPU, memory and IO appear under /proc/pressure.
2.3. Enabling notifications and integrations in the resource optimization service
You can enable the notifications service on Red Hat Hybrid Cloud Console to send notifications whenever the resource optimization service detects an issue and generates a suggestion. Using the notifications service frees you from having to continually check the Red Hat Insights for Red Hat Enterprise Linux dashboard for recommendations.
For example, you can configure the notifications service to automatically send an email message whenever the resource optimization service generates a suggestion.
Enabling the notifications service requires three main steps:
- First, an Organization Administrator creates a User access group with the Notifications administrator role, and then adds account members to the group.
- Next, a Notifications administrator sets up behavior groups for events in the notifications service. Behavior groups specify the delivery method for each notification. For example, a behavior group can specify whether email notifications are sent to all users, or just to Organization administrators.
- Finally, users who receive email notifications from events must set their user preferences so that they receive individual emails for each event.
In addition to sending email messages, you can configure the notifications service to pull event data in other ways:
- Using an authenticated client to query Red Hat Insights APIs for event data.
- Using webhooks to send events to third-party applications that accept inbound requests.
- Integrating notifications with applications such as Splunk to route resource optimization recommendations to the application dashboard.
Additional resources
- For more information about how to set up notifications for resource optimization recommendations, see Configuring notifications on the Red Hat Hybrid Cloud Console with FedRAMP and Integrating the Red Hat Hybrid Cloud Console with third-party applications.
