Tâches planifiées Admin : historique des exécutions cron

Vérifiez si une tâche de fond a tourné, combien de temps elle a pris et si elle a échoué : filtrez l’historique des exécutions cron de votre organisation par tâche, état et date dans Admin → Tâches planifiées.

Une partie du travail dans Docklify se fait en arrière-plan selon un horaire : personne ne clique sur un bouton, la tâche tourne simplement quand son heure arrive. Admin → Tâches planifiées est l’endroit où vous vérifiez ces exécutions après coup : chaque exécution laisse une ligne avec l’heure de début, la durée, le succès ou l’échec, un court résumé de ce qu’elle a fait et le message d’erreur en cas d’échec. La page n’affiche que les exécutions de votre propre organisation. Seuls les rôles Owner et Admin peuvent l’ouvrir.

Étape 1 : ouvrir l’historique et lire une ligne#

1. Ouvrez Admin → Tâches planifiées (/admin/cron-runs). La liste des exécutions se charge toute seule : il n’y a rien à démarrer ni à configurer ici.
2. Choisissez une ligne et lisez-la de gauche à droite : heure de début, nom de la tâche, durée, état, résumé, erreur.
3. Si la liste est longue, utilisez la pagination au bas du tableau pour la parcourir : la page affiche 50 exécutions à la fois par défaut.

• Début est le moment où cette exécution a commencé, affiché à la seconde près : servez-vous-en pour relier une exécution à l’heure où quelque chose devait se produire.
• Tâche est le nom de la tâche planifiée, affiché exactement comme le système la nomme.
• Résumé est une courte liste de ce que l’exécution a produit : des comptes et des résultats sous forme simple clé-valeur. Les résumés longs sont coupés dans le tableau, donc considérez la ligne comme le titre, pas comme le rapport complet.
• Erreur est vide (un tiret) sur les exécutions qui n’ont pas échoué. Sur une exécution échouée, il affiche le message d’erreur, coupé dans le tableau : survolez-le pour lire le texte complet.

Une ligne est une exécution, pas une tâche. La même tâche réapparaît à chaque exécution, donc une tâche en bonne santé accumule une longue série de lignes au fil des jours. Quand vous parcourez le tableau dans Admin → Tâches planifiées, vous lisez en fait cette série : les lignes proches du moment qui vous intéresse, dans l’ordre que le tableau donne après filtrage.

Étape 2 : filtrer par tâche, état et date#

1. Dans la carte de filtres au-dessus du tableau, choisissez une Tâche, ou laissez Tous pour voir toutes les tâches ensemble.
2. Choisissez un État si seul un type de résultat vous intéresse — par exemple Échoué, pour ne voir que les exécutions qui ont mal tourné.
3. Définissez une date De et À pour réduire la liste à une période : une nuit, une semaine, le moment où le problème a été remarqué.
4. Cliquez sur Rechercher. La liste se recharge depuis la première page avec vos filtres appliqués.

Le sélecteur de tâches dans Admin → Tâches planifiées liste les tâches planifiées qui rapportent des exécutions pour votre organisation : employee-term-sweep, abc-analysis et sequence-runner. En choisir une est le moyen le plus rapide de répondre à « cette tâche précise a-t-elle tourné récemment ? » : si ses lignes continuent d’apparaître à l’heure avec Succès, oui.

Étape 3 : lire l’état et la durée#

• success (vert) : l’exécution s’est terminée et a fait son travail.
• failed (rouge) : l’exécution s’est arrêtée sur une erreur. Lisez la colonne Erreur de la même ligne avant toute autre chose.
• running (jaune) : l’exécution a commencé et n’est pas encore terminée. Revenez voir un peu plus tard ; une exécution terminée bascule en success ou failed.
• Durée s’affiche en secondes, ou en minutes et secondes pour les exécutions plus longues (par exemple 2m5s). Un tiret signifie que l’exécution n’a pas encore de durée enregistrée : typique tant qu’elle est encore en cours.

Lisez l’état et la durée ensemble. Un success qui prend soudain dix fois plus de temps que ses exécutions habituelles mérite d’être noté même s’il est passé, et un failed à la durée très courte s’est en général arrêté tôt : le texte d’erreur de cette même ligne dira où. Comparer une exécution avec les lignes précédentes de la même tâche dans Admin → Tâches planifiées est le moyen le plus rapide de repérer l’un ou l’autre de ces schémas.

Étape 4 : vérifier une tâche que vous soupçonnez de ne pas avoir tourné#

1. Filtrez par cette tâche et réglez la période sur le moment où elle aurait dû tourner, puis cliquez sur Rechercher.
2. S’il n’y a aucune ligne dans cette période, aucune exécution n’a été enregistrée pour ce moment : la tâche n’a pas tourné, ou n’a pas rapporté d’exécution.
3. Une ligne en failed signifie qu’elle a tourné et a rencontré un problème : copiez le nom de la tâche, l’heure de début et le texte complet de l’erreur (survolez pour tout voir) — c’est ce trio que le support demandera.
4. Une ligne toujours en running longtemps après son début mérite un second regard plus tard : relancez la recherche et voyez si elle a basculé en success ou failed.

Fonctionnalités Docklify utilisées dans cet article#

• Historique des exécutions cron de votre organisation (début / tâche / durée / état / résumé / erreur) — Admin → Tâches planifiées (/admin/cron-runs)
• Filtres des exécutions par tâche, état et période de dates, avec Rechercher — Admin → Tâches planifiées (/admin/cron-runs)
• Lecture de l’état d’un coup d’œil (running / success / failed, par couleurs) — Admin → Tâches planifiées (/admin/cron-runs)
• Texte complet de l’erreur sur les exécutions échouées (survolez la cellule Erreur) — Admin → Tâches planifiées (/admin/cron-runs)