System Status

Logs

Lee y descarga el tail de logs de C21 Live Control y los Encoders que gestiona, filtrado por fichero y severidad, con una vista debug verbosa aparte.

Qué hace

System status → Logs lee el tail de logs de cualquier Device que gestione esta instancia de C21 Live Control — el propio host de Control o un Encoder registrado — directamente en el navegador. La vista hace polling de líneas nuevas (un timestamp "Last updated at …" muestra el último refresco) y permite filtrar por severidad y descargar el fichero completo.

Dos pestañas separan el log del día a día del verboso:

  • Logs — el log operativo (control.log): eventos de start/stop, actividad del scheduler, warnings y errores. Es la pestaña que lees a diario.
  • Debug logs — el log de diagnóstico verboso (control.log.debug): traza interna de bajo nivel, útil cuando trabajas un incidente con el soporte de Cires21. Mucho más volumen; paginado.

UI Interface

ControlPropósito
DeviceDe quién leer el log — esta instancia de Live Control o un Encoder registrado.
Log fileEl fichero de log del Device seleccionado (control.log en la pestaña Logs, control.log.debug en la pestaña Debug logs).
LevelChips de severidad — Error, Warning, Info — filtran qué entradas se muestran. Quita un chip para ocultar ese nivel.
DownloadDescarga el fichero de log seleccionado.
Show N entriesCuántas líneas traer por página (por defecto 100).
PaginaciónRetrocede por el fichero más allá de la ventana actual.

Las entradas están codificadas por color según severidad (Info neutro, Warning ámbar, Error rojo) y prefijadas con su timestamp y el componente que las emite.

API surface

La vista hace polling de un único endpoint para el tail, seleccionando el Device por ip (el Control responde en 127.0.0.1; un Encoder en su dirección LAN):

AcciónRequest
Leer el tail de logPOST /c21apiv2/system/command{ "action": "readLog", "ip": "<device-ip>", "file": "control.log", "numLines": 100, "offset": 0 }
  • file es control.log para la pestaña Logs y control.log.debug para la pestaña Debug logs.
  • numLines mapea al selector Show N entries; offset avanza la ventana de paginación.
  • El selector de Device se rellena con GET /c21apiv2/devices?includeControl=1.
  • Commands — ejecuta comandos de mantenimiento sobre los mismos Devices.
  • Devices — registra los Encoders cuyos logs aparecen aquí.
  • Instalar C21 Live Controllivecontrol logs lee el mismo log en el host.

FAQ

Copyright © 2026