system · Command reference
qzx getCPULoad
What it does
Gets information about current CPU usage
Canonical command: getCPULoad
Accepted aliases: None
Case-sensitive: no
Included in the published package
Available in PyPI 0.2.2.0.2. This page documents the 0.2.2.0.2 alpha development checkout.
Safety and effects
Read-only under the current classification
No documented dry-run parameter
No native program invocation in the current classification
No documented network use
No inherent elevation requirement
This safety classification was reviewed against implementation digest sha256:b87860785511a936d5a1f8cb657bb8ae1d779e73ab81d87ab8396999641e5020 on 2026-07-24.
Exact syntax
qzx getCPULoad [interval] --jsonParameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| interval | float | No | 1 | Time interval (in seconds) to calculate CPU usage |
Input examples
qzx getCPULoadGet CPU usage information with 1-second interval
qzx getCPULoad 0.5Get CPU usage information with 0.5-second interval
For the complete structured payload, add --json: qzx getCPULoad [interval] --json
Representative output example
This illustrative JSON is derived from the current implementation-backed result contract. It shows what the command can return without claiming a recorded execution; values vary with inputs, host, permissions, and optional tools.
Example command: qzx getCPULoad --json
{
"success": true,
"message": "Gets information about current CPU usage. In this illustrative example, the command completed successfully.",
"cores_count": 3,
"frequency": "Example value",
"load_average": {
"1min": "Example value",
"5min": "Example value",
"15min": "Example value"
},
"overall_percent": 42.7,
"per_core": [
18.2,
23.5,
12.1,
29.8
],
"per_core_frequency": "Example value",
"times_percent": 42.7
}View the JSON result contract
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"required": [
"success",
"message"
],
"properties": {
"success": {
"type": "boolean"
},
"message": {
"type": "string"
},
"cores_count": [],
"error": {
"type": "string"
},
"frequency": [],
"load_average": {
"type": "object",
"properties": {
"1min": [],
"5min": [],
"15min": []
},
"additionalProperties": true
},
"overall_percent": [],
"per_core": {
"type": "array"
},
"per_core_frequency": [],
"times_percent": []
},
"additionalProperties": true
}Errors and limits
The public contract requires success=false and a descriptive message on failure. This catalog does not yet declare a command-specific error taxonomy; inspect the result and do not invent error codes.
QZX is alpha software. Optional dependencies, permissions, and host capabilities can change the result.
Evidence workflow: ready for deterministic automated capture.
Evidence and provenance
- Implementation
- src/qzx/commands/system/get_cpu_load.py
- Tests
- No command-specific test file with the same module name was found; this does not prove that all coverage is absent.
- Documentation channel
- Development documentation 0.2.2.0.2 · main · sha256:319b16857a87636ebc3b89734cc040a737bb56194464fca33ce73bdae2043096
- Availability
- 0.2.2.0.2 or earlier
Keep exploring
Related commands
These commands also belong to the system category. Compare them to choose the operation that best fits your task.