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ónContenido
Fila de KPIsComprobaciones totales, Exitosas + tasa de éxito %, Incidentes, Alertas (entregadas / fallidas / suprimidas), Jobs reportando
Problemas activosJobs con fallos o check-ins perdidos, ordenados por gravedad (perdido → abandonado → fallido → retrasado)
Monitores silenciososJobs sin actividad en el intervalo — posible mala configuración
Pie de páginaVeredicto 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

PlanMáximo --hours
Free24
Developer168 (7 días)
Team720 (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):

DominioEventos incluidos
executionsEjecución HTTP exitosa, Ejecución HTTP fallida
heartbeatsHeartbeat perdido, Heartbeat recuperado, Ping recibido, Ejecución iniciada, Ejecución abandonada
alertsAlerta entregada, Fallo en entrega de alerta, Alerta suprimida, Alerta pendiente
jobsJob creado, Job eliminado, Job pausado, Job reanudado
keysClave API creada, Clave API revocada
rulesRegla de alerta creada, Regla de alerta eliminada
channelsCanal de alerta creado, Canal de alerta actualizado, Canal de alerta eliminado
subscriptionPlan 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.