Activité & Logbook

La CLI propose deux commandes pour surveiller l’activité du compte. Elles reflètent leurs équivalents dans le tableau de bord web, en utilisant les mêmes calculs et la même terminologie pour que les chiffres soient toujours cohérents.

steadycron report — synthèse d’activité

steadycron report                  # Dernières 24 h (par défaut)
steadycron report --hours 168      # 7 derniers jours (plan Developer et supérieur)
steadycron report --hours 720      # 30 derniers jours (plan Team)
steadycron report --verbose        # Corps de réponses HTTP et liste complète des alertes
steadycron report --json           # Sortie lisible par machine pour CI ou tableaux de bord

Appelle /api/reports/summary et affiche les mêmes chiffres que la page Aperçu du tableau de bord. Le taux de succès est calculé comme successful_checks / total_checks (couvrant les exécutions HTTP et les pings heartbeat), de sorte que la CLI et le tableau de bord s’accordent toujours pour une même fenêtre temporelle.

Section	Contenu
Ligne de KPIs	Vérifications totales, Réussies + taux de succès %, Incidents, Alertes (livrées / échouées / supprimées), Tâches remontant des données
Problèmes actifs	Tâches avec des échecs ou des check-ins manquants, classées par gravité (manqué → abandonné → échoué → en retard)
Moniteurs silencieux	Tâches sans activité dans la fenêtre — possible mauvaise configuration
Pied de page	Verdict de santé ; quitte avec un code non nul en cas d’échecs ou d’alertes non livrées

--json émet la réponse brute de l’API, utile pour des alertes scriptées ou des tableaux de bord personnalisés.

Limites par plan

Plan	Maximum --hours
Free	24
Developer	168 (7 jours)
Team	720 (30 jours)

steadycron logbook — historique complet des événements

steadycron logbook                                       # Dernières 24 h, tous types
steadycron logbook --hours 168                           # 7 derniers jours
steadycron logbook --domain executions                   # Filtrer par catégorie
steadycron logbook --domain executions --domain alerts   # Plusieurs catégories (répétable)
steadycron logbook --severity critical                   # Événements critiques uniquement
steadycron logbook --job my-job-key                      # Événements d'une tâche précise
steadycron logbook --page 2 --page-size 100             # Naviguer par pages
steadycron logbook --all                                 # Récupérer toutes les pages
steadycron logbook --verbose                             # Métadonnées complètes par événement
steadycron logbook --all --json                          # Sortie lisible par machine

Reflète la page Logbook du tableau de bord. Chaque événement affiche un indicateur de gravité, un horodatage, une étiquette d’événement, un nom de tâche (le cas échéant) et une courte chaîne de détail. --verbose ajoute des champs de métadonnées : code de statut HTTP, type d’erreur, extrait du corps de réponse, IP source, et plus encore.

Domaines

Filtrez par catégorie d’événement avec --domain (répétable) :

Domaine	Événements inclus
executions	Exécution HTTP réussie, Exécution HTTP échouée
heartbeats	Heartbeat manqué, Heartbeat rétabli, Ping reçu, Exécution démarrée, Exécution abandonnée
alerts	Alerte livrée, Échec de livraison d’alerte, Alerte supprimée, Alerte en attente
jobs	Tâche créée, Tâche supprimée, Tâche mise en pause, Tâche reprise
keys	Clé API créée, Clé API révoquée
rules	Règle d’alerte créée, Règle d’alerte supprimée
channels	Canal d’alerte créé, Canal d’alerte mis à jour, Canal d’alerte supprimé
subscription	Plan mis à niveau, Plan rétrogradé, Abonnement annulé, Abonnement en retard de paiement, Abonnement suspendu

Gravité

Filtrez par gravité avec --severity (répétable) : info, warning ou critical.

Pagination

Par défaut, logbook renvoie les 50 premiers événements (ajustez avec --page-size, max 100). Utilisez --page N pour naviguer dans les pages, ou --all pour récupérer tous les événements correspondants en une seule opération.

Filtre par tâche

--job accepte un job key (de préférence), un nom de tâche ou un id de tâche (GUID). Le job key est l’identifiant stable affiché dans la colonne Key de steadycron jobs list et reste stable entre les renommages.