Skip to main content

Operations Monitoring

The Operations module consolidates the platform runtime metrics, system information, logs, background tasks, export records, and WebRTC session status for routine inspection and fault isolation. The page and its data APIs require the Administrator role.

Operations overview (Administrator only)

Prerequisites​

ItemContent
Menu entryManage → Operations
Route/monitor, enters /monitor/overview by default
Page permission"View Ops Monitor"
Visible rolesAdministrator
Data APIsThe monitoring, queue, and log APIs validate the Administrator role
DependenciesRedis (Operations metrics stream and task queues), database

Subpages​

SubpageRouteContent shownData source
Monitoring Overview/monitor/overviewCurrent values and trends of database latency, Redis latency, and queue backlogRedis Operations metrics stream
System Information/monitor/statusVersion, build date and time, Node.js version, Uptime, Hostname, Operating System, Architecture, CPU cores, Total MemoryServer build information and host information
System Log/monitor/logsAccess, active user, login, operation, and workflow logsAccess and audit data
Background Tasks/monitor/jobsTask list and actions of the system queue and export queueTask queues
Export Records/monitor/exportsExport task history and artifactsExport records
WebRTC/monitor/webrtcActive rooms, publishers, viewers, and track countWebRTC service room list

Runtime Metrics​

Monitoring Overview​

The top of /monitor/overview shows three metric cards, with the corresponding trend charts below.

MetricMeaningThreshold
Database latencyDatabase probe durationBelow 50 milliseconds is normal, 50–200 milliseconds is a warning, and 200 milliseconds or more is critical
Redis latencyRedis PING durationBelow 10 milliseconds is normal, 10–50 milliseconds is a warning, and 50 milliseconds or more is critical
Queue backlogTotal number of waiting tasks across queuesAbove 100 is a warning, and above 1000 is critical
Time rangePurpose
1 hourReal-time isolation
24 hoursRoutine inspection
7 daysTrend analysis

The overview summary refreshes automatically every 30 seconds; the "Collect Now" button triggers one manual metric collection and refreshes the summary and trends.

System Information​

/monitor/status lists application and host information.

FieldDescription
Version, build date, build timeApplication build information
Node.js versionRuntime version
UptimeTime the process has been running
Hostname, Operating System, ArchitectureHost information
CPU cores, Total MemoryHost resources

Background Tasks​

/monitor/jobs manages the tasks of two queues.

QueueNameTasks handled
System queueiojobsSystem-level tasks such as data preprocessing
Export queueioexportsData export tasks
Task statusDescription
waitingWaiting
activeRunning
completedCompleted
failedFailed
delayedDelayed
pausedPaused
ActionEffectConstraint
Pause QueuePauses processing of the queueAffects the execution of new tasks
Resume QueueResumes processing of the queueNone
Clear WaitingDeletes all waiting tasks of the queueCannot be undone
Clean HistoryDeletes completed and failed tasks older than 24 hoursNone
Retry FailedRetries failed tasks in bulkUp to 1000 per operation
RetryRe-runs a single failed taskFailed tasks only
StopStops a running taskRunning tasks only
RemoveDeletes a waiting taskWaiting tasks only
warning

Pausing a queue affects the execution of new tasks, and clearing waiting tasks deletes the waiting tasks.

WebRTC Monitoring​

/monitor/webrtc lists the currently active rooms.

ColumnDescription
Agent IDDevice Agent ID and publisher IP of the room
StatusOnline, Disconnect
Start timeSession start time
Track countNumber of media tracks in the room
ViewersNumber of viewers and their IPs
ActionsForce disconnect

Force disconnect requires confirmation and a reconnect-ban duration in hours; a value of 0 means no ban.

Record Queries​

System Log​

SubpageRouteContentFilter fields
Log overview/monitor/logsToday's failed logins, active users, key operations, and data browsing; recent failed logins and locked usersNone
Access Log/monitor/logs/visitData, account, viewing IP, viewing timeData, account, IP, time
Current active users/monitor/logs/activeUsername, active time, IP addressTime range 1 day, 7 days, 30 days
Login Logs/monitor/logs/loginUsername, result, IP address, login type, error message, timeUser, username, IP, time range, result
Operation Logs/monitor/logs/operationUsername, operation content, IP address, timeUser, IP, time range
Workflow logs/monitor/logs/workflowRule ID, time, descriptionWorkflow, dataset, match rule, action rule, time range

The Log overview provides an immediate unlock entry for locked users. On the Current active users page, an Administrator disables an account. Module permission changes are written to a separate audit record, and the Operations module provides no page to view that record.

Export Records​

/monitor/exports requires the "View Export List" permission, and re-exporting requires the "Create Export Job" permission.

FieldDescription
ID, filename, typeExport task identifier and artifact
Export parameters, status, user, dataset, creation time, completion timeTask information
StatusQueued, Processing, Running, Completed, Failed
Type filterlerobot, hdf5, mcap
ActionsRe-export, which requeues the task; completed records allow downloading the artifact

Troubleshooting​

SymptomPossible causeActionOwner
No data in the overviewMetrics not yet collected, or Redis is unavailableClick "Collect Now"; check the Redis connectionOperations
Database or Redis metric marked criticalThe corresponding service responds slowly, the connection pool is exhausted, or the network jittersCheck the load and connections of the corresponding serviceOperations
Queue backlog keeps growingTask volume exceeds capacity, the Worker is not running, or a single task takes too longCheck the Worker status and, if necessary, pause the queue and clear waiting tasksOperations
A task stays running for a long timeWorker failure, or the task is blockedStop the task and retryOperations
No data on a log pageNo records in the time range, or the filter is too narrowWiden the time range or clear the filterAdministrator
WebRTC room cannot be force-disconnectedThe request failedRetry the operation and check the WebRTC service statusOperations
PagePurpose
System SettingsSystem parameters and log-related configuration
Dataset ExportCreation and quota of export tasks
Module PermissionsConfiguration of module permissions
Data ManagementLocating a specific dataset
TrashRestoring deleted data