Status
GET /runtime/status
Returns comprehensive runtime state, project info, system metrics, and cumulative statistics. Responds immediately without queuing a lifecycle action.
Parameters: None
Response: 200 OK — JSON object:
{
"state": "Running",
"project": {
"fileName": "C:\\Projects\\MyProject.prj",
"name": "MyProject.prj",
"loaded": true,
"startedUtc": "2026-04-18T10:00:00.0000000Z",
"uptime": "0.02:15:30",
"uptimeSeconds": 8130,
"computeTimeMsShort": 4.52,
"computeTimeMsLong": 4.48,
"computeTimePercent": 27.05,
"budgetExceededFrames": 0,
"congestions": 0,
"queueFlushes": 0,
"errors": 0,
"warnings": 2
},
"system": {
"ramUsageGb": 3.456,
"gpuMemoryUsedGb": 2.100,
"gpuMemoryFreeGb": 5.900,
"gpuMemoryTotalGb": 8.000
},
"runtime": {
"startedUtc": "2026-04-18T08:00:00.0000000Z",
"uptime": "0.04:15:30",
"uptimeSeconds": 15330,
"totalProjectsStarted": 3,
"totalReloads": 1,
"totalApiCalls": 47,
"totalErrors": 0,
"totalWarnings": 5,
"lastReloadDurationSeconds": 2.34,
"lastTimeToFirstFrameSeconds": 1.87
},
"timestamp": "2026-04-18T12:15:30.0000000Z"
}
Response fields:
state (string)
Current runtime state: Idle, Loading, Running, or Stopping.
project object
| Field | Type | Description |
|---|---|---|
fileName |
string | Full path to the loaded project file. Preserved across Idle transitions. |
name |
string | Project file name (e.g. MyProject.prj) |
loaded |
bool | Whether a project is currently loaded and running |
startedUtc |
string? | ISO 8601 UTC timestamp when the current project session started. Null when idle. |
uptime |
string? | Project session uptime in d.hh:mm:ss format. Null when idle. |
uptimeSeconds |
long? | Project session uptime in seconds. Null when idle. |
computeTimeMsShort |
float | Average compute time over the last ~100 frames (ms). Short-term indicator. |
computeTimeMsLong |
float | Average compute time over the last ~10,000 frames (ms). Long-term indicator. |
computeTimePercent |
float | Compute time as percentage of frame budget (e.g. 75.0 = 75%) |
budgetExceededFrames |
long | Frames where compute time exceeded the frame budget |
congestions |
int | Congestive frame count since project start |
queueFlushes |
int | Worker queue flush count since project start |
errors |
int | Error count for the current project session (resets on reload) |
warnings |
int | Warning count for the current project session (resets on reload) |
system object
| Field | Type | Description |
|---|---|---|
ramUsageGb |
float | Process RAM usage in GB |
gpuMemoryUsedGb |
float | GPU memory used in GB (from nvidia-smi) |
gpuMemoryFreeGb |
float | GPU memory free in GB |
gpuMemoryTotalGb |
float | Total GPU memory in GB |
runtime object
| Field | Type | Description |
|---|---|---|
startedUtc |
string | ISO 8601 UTC timestamp when the runtime process started |
uptime |
string | Process uptime in d.hh:mm:ss format |
uptimeSeconds |
long | Process uptime in seconds |
totalProjectsStarted |
int | Cumulative projects started (initial + reloads + API starts) |
totalReloads |
int | Cumulative reload operations |
totalApiCalls |
long | Total Runtime API calls received |
totalErrors |
int | Cumulative errors across all project sessions |
totalWarnings |
int | Cumulative warnings across all project sessions |
lastReloadDurationSeconds |
float | Duration of the last reload operation in seconds |
lastTimeToFirstFrameSeconds |
float | Time from last start/reload to first rendered frame in seconds |