Linux PSI Monitoring
Last updated on 02 October, 2024LogicMonitor’s Linux PSI monitoring package leverages SSH to monitor the CPU, Memory and IO load of your Linux resource.
Compatibility
As of March 2022, LogicMonitor’s Linux PSI package is known to be compatible with:
- Linux Kernel version 4.20 and higher.
Setup Requirements
- SSH must be configured to detect the Linux system and its kernel version. This is required for the addCategory_LinuxPSI PropertySource.
- The Linux_SSH_Info PropertySource must run before addCategory_LinuxPSI PropertySource can verify Linux Kernel version and apply the “LinuxPSI” system.categories property. Dependencies are in the following order: addCategory_Linux_SSH -> Linux_SSH_Info -> addCategory_LinuxPSI.
- The Linux bootloader must have Linux PSI enabled for the module to run successfully.
- Collector version 30.000 and greater is required.
Add Resources into Monitoring
Add your Linux hosts into monitoring. For more information on adding resources into monitoring, see Adding Devices.
Assign Properties to Resources
The following custom properties must be set on the Linux PSI resource within LogicMonitor. For more information on setting properties, see Resource and Instance Properties.
Property | Value |
ssh.user | (Required) Secure Shell username. |
ssh.pass | Secure Shell password. (Optional if public key is used.) |
ssh.cert | Secure Shell public and private key. (Optional if password is used.) |
ssh.port | Secure Shell port to use to access the resources data. Defaults to 22 (SSH). |
system.category | Add “LinuxPSI”. This value is set automatically by the addCategory_LinuxPSI PropertySource. |
Import LogicModules
From the LogicMonitor public repository, import all Linux PSI LogicModules, which are listed in the LogicModules in Package section of this support article. If these LogicModules are already present, ensure you have the most recent versions. Data collection will start once the LogicModules are imported.
Troubleshooting
The module may not report all datapoints based on system configuration. For example, a single-core processor or 1 vCPU VM will only show “some CPU” metrics, while a dual-core or 2 vCPU VM will show “full CPU” metrics.
LogicModules in Package
LogicMonitor’s package for Linux PSI consists of the following LogicModules. For full coverage, make sure that all of these LogicModules are imported into your LogicMonitor platform.
Display Name | Type | Description |
addCategory_LinuxPSI | PropertySource | Adds property system.categories = LinuxPSI if running the running Kernel on the Linux system is running a version higher than 4.20. |
Linux PSI | DataSource | Linux Pressure Stall Information monitors CPU, Memory and IO load. |
The DataSources in this package do not include predefined datapoint thresholds (that is, no alerts will trigger based on collected data). This is because the technology owner has not provided KPIs that can be reliably extended to the majority of users. To receive alerts for collected data, you need to manually create custom thresholds. For more information, see Tuning Static Thresholds for Datapoints.