Actividad y Logbook
Monitoriza tu cuenta de SteadyCron desde el CLI con steadycron report (resumen de actividad) y steadycron logbook (historial completo de eventos).
El CLI ofrece dos comandos para monitorizar la actividad de la cuenta. Ambos reflejan sus equivalentes en el dashboard web, usando los mismos cálculos y terminología para que los números sean siempre coherentes.
steadycron report — resumen de actividad
steadycron report # Últimas 24 h (por defecto)
steadycron report --hours 168 # Últimos 7 días (plan Developer y superior)
steadycron report --hours 720 # Últimos 30 días (plan Team)
steadycron report --verbose # Incluir cuerpos de respuesta HTTP y lista completa de alertas
steadycron report --json # Salida legible por máquina para CI o dashboards
Llama a /api/reports/summary y muestra las mismas cifras que la página de Resumen del
dashboard. La tasa de éxito se calcula como successful_checks / total_checks (cubriendo
tanto ejecuciones HTTP como pings de heartbeat), por lo que el CLI y el dashboard siempre
coinciden para el mismo intervalo de tiempo.
| Sección | Contenido |
|---|---|
| Fila de KPIs | Comprobaciones totales, Exitosas + tasa de éxito %, Incidentes, Alertas (entregadas / fallidas / suprimidas), Jobs reportando |
| Problemas activos | Jobs con fallos o check-ins perdidos, ordenados por gravedad (perdido → abandonado → fallido → retrasado) |
| Monitores silenciosos | Jobs sin actividad en el intervalo — posible mala configuración |
| Pie de página | Veredicto de salud; sale con código no cero si hay fallos o alertas no entregadas |
--json emite la respuesta bruta de la API, útil para alertas con scripts o dashboards personalizados.
Límites por plan
| Plan | Máximo --hours |
|---|---|
| Free | 24 |
| Developer | 168 (7 días) |
| Team | 720 (30 días) |
steadycron logbook — historial completo de eventos
steadycron logbook # Últimas 24 h, todos los tipos
steadycron logbook --hours 168 # Últimos 7 días
steadycron logbook --domain executions # Filtrar por categoría
steadycron logbook --domain executions --domain alerts # Múltiples categorías (repetible)
steadycron logbook --severity critical # Solo eventos críticos
steadycron logbook --job my-job-key # Eventos de un job concreto
steadycron logbook --page 2 --page-size 100 # Paginar resultados
steadycron logbook --all # Obtener todas las páginas
steadycron logbook --verbose # Metadatos completos por evento
steadycron logbook --all --json # Salida legible por máquina
Refleja la página Logbook del dashboard. Cada evento muestra un indicador de gravedad,
marca de tiempo, etiqueta del evento, nombre del job (donde aplique) y un texto de detalle
breve. --verbose añade campos de metadatos: código de estado HTTP, tipo de error,
fragmento del cuerpo de respuesta, IP de origen y más.
Dominios
Filtra por categoría de evento con --domain (repetible):
| Dominio | Eventos incluidos |
|---|---|
executions | Ejecución HTTP exitosa, Ejecución HTTP fallida |
heartbeats | Heartbeat perdido, Heartbeat recuperado, Ping recibido, Ejecución iniciada, Ejecución abandonada |
alerts | Alerta entregada, Fallo en entrega de alerta, Alerta suprimida, Alerta pendiente |
jobs | Job creado, Job eliminado, Job pausado, Job reanudado |
keys | Clave API creada, Clave API revocada |
rules | Regla de alerta creada, Regla de alerta eliminada |
channels | Canal de alerta creado, Canal de alerta actualizado, Canal de alerta eliminado |
subscription | Plan actualizado, Plan rebajado, Suscripción cancelada, Suscripción vencida, Suscripción pausada |
Gravedad
Filtra por gravedad con --severity (repetible): info, warning o critical.
Paginación
Por defecto, logbook devuelve los primeros 50 eventos (ajusta con --page-size, máx. 100).
Usa --page N para navegar por páginas o --all para obtener todos los eventos en una sola
operación.
Filtro por job
--job acepta un job key (preferido), nombre de job o id de job (GUID). El job key es el
identificador estable que aparece en la columna Key de steadycron jobs list y se mantiene
estable entre renombrados.