System Status

Logs

Read and download the log tail of C21 Live Control and its managed Encoders, filtered by file and severity, with a separate verbose debug view.

What it does

System status → Logs reads the log tail of any Device this C21 Live Control instance manages — the Control host itself or a registered Encoder — straight in the browser. The view polls for new lines (a "Last updated at …" timestamp shows the last refresh) and lets you filter by severity and download the full file.

Two tabs split the everyday log from the verbose one:

  • Logs — the operational log (control.log): start/stop events, scheduler activity, warnings and errors. This is the tab you read day to day.
  • Debug logs — the verbose diagnostic log (control.log.debug): low-level internal trace, useful when working through an issue with Cires21 support. Much higher volume; paginated.

UI Interface

ControlPurpose
DeviceWhose log to read — this Live Control instance or a registered Encoder.
Log fileThe log file on the selected Device (control.log on the Logs tab, control.log.debug on the Debug logs tab).
LevelSeverity chips — Error, Warning, Info — filter which entries are shown. Remove a chip to hide that level.
DownloadDownloads the selected log file.
Show N entriesHow many lines to fetch per page (default 100).
PaginationPages back through the file beyond the current window.

Entries are color-coded by severity (Info neutral, Warning amber, Error red) and prefixed with their timestamp and the emitting component.

API surface

The view polls a single endpoint for the tail, selecting the Device by ip (the Control answers on 127.0.0.1; an Encoder on its LAN address):

ActionRequest
Read the log tailPOST /c21apiv2/system/command{ "action": "readLog", "ip": "<device-ip>", "file": "control.log", "numLines": 100, "offset": 0 }
  • file is control.log for the Logs tab and control.log.debug for the Debug logs tab.
  • numLines maps to the Show N entries selector; offset advances the pagination window.
  • The Device picker is populated by GET /c21apiv2/devices?includeControl=1.

FAQ

Copyright © 2026