On this page

PressureStallInformation QML Type

Provides Linux PSI (Pressure Stall Information) monitoring for a cgroup resource. More...

Import Statement: import QtApplicationManager

Properties

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.

ConstantDescription
PressureStallInformation.OffPSI monitoring is disabled. This is the default.
PressureStallInformation.SomeTriggers when at least one task is stalled on the resource.
PressureStallInformation.FullTriggers 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.

ConstantDescription
PressureStallInformation.CpuMonitors CPU pressure (tasks stalled waiting for CPU time).
PressureStallInformation.MemoryMonitors memory pressure (tasks stalled waiting for memory to become available).
PressureStallInformation.IoMonitors 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.