PressureStallInformation QML Type
Provides Linux PSI (Pressure Stall Information) monitoring for a cgroup resource. More...
| Import Statement: | import QtApplicationManager |
Properties
- mode : enumeration
- stallTime : int
- timeWindow : int
- type : enumeration
Signals
Detailed Description
This type cannot be instantiated directly. Instances are accessed via the CGroupStatus::cpuPSI, CGroupStatus::memoryPSI, and CGroupStatus::ioPSI properties.
Linux PSI monitoring (available since kernel 4.20 with cgroup v2) detects resource pressure by tracking the time tasks spend stalled waiting for a resource. Set mode to Some or Full and configure timeWindow and stallTime to define the trigger threshold. The triggered signal fires whenever the accumulated stall time within timeWindow exceeds stallTime.
See also CGroupStatus.
Property Documentation
mode : enumeration
Controls whether PSI monitoring is enabled and which stall condition is observed.
| Constant | Description |
|---|---|
PressureStallInformation.Off | PSI monitoring is disabled. This is the default. |
PressureStallInformation.Some | Triggers when at least one task is stalled on the resource. |
PressureStallInformation.Full | Triggers when all non-idle tasks are simultaneously stalled on the resource. |
See also timeWindow, stallTime, and triggered.
stallTime : int
The stall time threshold in milliseconds. When the accumulated stall time within timeWindow exceeds this value, the triggered signal is emitted.
See also timeWindow and triggered.
timeWindow : int
The observation time window in milliseconds over which stall time is accumulated. When the accumulated stall time within this window exceeds stallTime, the triggered signal is emitted.
Note: Unprivileged users can only set time windows in multiples of 2000ms due to kernel limitations.
See also stallTime and triggered.
type : enumeration
The type of resource this PressureStallInformation instance monitors.
| Constant | Description |
|---|---|
PressureStallInformation.Cpu | Monitors CPU pressure (tasks stalled waiting for CPU time). |
PressureStallInformation.Memory | Monitors memory pressure (tasks stalled waiting for memory to become available). |
PressureStallInformation.Io | Monitors I/O pressure (tasks stalled waiting for I/O operations to complete). |
This is a read-only property that is set when the instance is created. It can be used to distinguish between the different PSI types when accessing them via CGroupStatus.
Signal Documentation
triggered()
Emitted when the accumulated stall time within timeWindow exceeds stallTime. Monitoring must be active, i.e. mode must be set to either Some or Full.
Note: The corresponding handler is onTriggered.
See also mode, timeWindow, and stallTime.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.