# L’instant où une tâche cron échoue.

> Recevez une notification push dès qu’une tâche cron ou planifiée échoue. Ajoutez une ligne à votre crontab ou à votre timer systemd : les alertes d’échec arrivent sur votre téléphone en moins d’une seconde.

<!-- source: https://pocketalert.app/fr/use-cases/cron-job-alerts -->

Dernière mise à jour : 2026-10-17

Pocket Alert envoie une notification push sur votre téléphone dès qu’une tâche cron échoue. Enchaînez une ligne à n’importe quelle commande planifiée avec && ou || : déclenchement en cas d’échec, de succès ou des deux, et la notification arrive à la fin de la tâche, sortie d’erreur incluse.

## Trois étapes pour des alertes d’échec cron

1. **Récupérez votre URL ou la CLI** — Copiez l’URL webhook entrante de votre application, ou installez la CLI Pocket Alert.
2. **Ajoutez une ligne** — Ajoutez un appel curl ou pocketalert send à votre ligne cron, avec || pour les échecs ou && pour les succès.
3. **Recevez l’alerte** — Lancez la tâche. En cas d’échec, votre téléphone vibre avec le titre et la sortie d’erreur que vous avez définis.

## Ne manquez plus jamais une tâche en échec

Un import en échec doit vous parvenir immédiatement, des heures avant que vous n’ouvriez les journaux.

- **Une ligne dans crontab** — Enchaînez une notification push à n’importe quelle ligne cron avec && ou ||. Il s’agit d’un seul appel curl, sans démon à surveiller.
- **Alerte uniquement en cas d’échec** — Avec ||, l’alerte ne se déclenche que si la commande renvoie un code de sortie non nul.
- **Inclure l’erreur** — Envoyez stderr ou le code de sortie dans le message : la notification arrive avec l’erreur déjà jointe.
- **Tous les planificateurs** — crontab, timers systemd, le planificateur Laravel, Sidekiq et les CronJobs K8s fonctionnent tous, car chacun exécute des commandes.
- **Signal de vie en cas de succès** — Envoyez un signal de vie après chaque exécution réussie. Quand il cesse d’arriver, vous savez que la tâche s’est arrêtée en silence et vous pouvez enquêter.
- **Instantané à la fin** — La notification arrive dès que la tâche se termine, des heures avant que quelqu’un ne consulte les journaux.

## Intégrer une alerte à votre tâche cron

### Installer et authentifier la CLI

```
sudo mv pocketalert /usr/local/bin/ && chmod +x /usr/local/bin/pocketalert
pocketalert auth YOUR_API_KEY
```

### Alerter uniquement en cas d’échec

Enchaînez l’alerte avec `||` pour qu’elle ne se déclenche que sur un code de sortie non nul :

```
0 3 * * * /usr/local/bin/mybackup.sh || pocketalert send \
  -t "Cron failed: mybackup" -m "Exited non-zero at $(date)"
```

### Inclure la sortie d’erreur

```
0 3 * * * /usr/local/bin/mybackup.sh 2>/tmp/cron.err || pocketalert send \
  -t "Cron failed: mybackup" -m "$(tail -n 3 /tmp/cron.err)"
```

### Signal de vie en cas de succès

Ajoutez un signal avec `&&` après une exécution réussie. Quand il cesse d’arriver, la tâche s’est arrêtée en silence :

```
0 3 * * * /usr/local/bin/mybackup.sh && pocketalert send "Cron OK: mybackup" "Finished cleanly"
```

### Pas de CLI ? Appelez l’API avec curl

```
0 3 * * * /usr/local/bin/mybackup.sh || curl -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Cron failed: mybackup","message":"Exited non-zero","level":"high"}'
```

La [documentation](https://info.pocketalert.app/getting-started.html) détaille le ciblage et les canaux par application.

## FAQ

### Comment recevoir des alertes depuis mes tâches cron ?

Enchaînez une notification à votre commande cron dans le shell. `&&` se déclenche après une exécution réussie, `||` après un échec, et Pocket Alert envoie la notification push dès que la tâche se termine.

### Puis-je n’être alerté qu’en cas d’échec ?

Utilisez `||` pour que l’alerte ne se déclenche que si la commande renvoie un code de sortie non nul : `mybackup.sh || curl ...`. Les tâches en erreur vous parviennent, le reste reste silencieux.

### Puis-je inclure la sortie d’erreur ?

Oui. Capturez le code de sortie ou la sortie de la commande et placez-les dans le corps du message. La CLI Pocket Alert envoie directement la sortie d’erreur (stderr) dans la notification.

### Cela fonctionne-t-il au-delà de crontab ?

Tous les planificateurs fonctionnent : crontab, timers systemd, le planificateur Laravel, les tâches cron de Rails ou Sidekiq, le Planificateur de tâches Windows, les CronJobs Kubernetes. Si un outil exécute une commande, vous pouvez y enchaîner une alerte.

### Puis-je détecter une tâche qui ne s’est jamais exécutée ?

Envoyez une notification de fin avec `&&` après chaque exécution réussie. Dès que ces notifications cessent d’arriver, vous savez que la tâche ne tourne plus, sans outil supplémentaire.

### Un échec de tâche nocturne peut-il me réveiller, tandis que les succès restent silencieux ?

Ajoutez level=critical à l’alerte d’échec : elle passe outre le mode Ne pas déranger sur Android et perce le mode Concentration sur iPhone. Pour les signaux de vie, utilisez level=silent : ils figurent dans votre historique sans son, et votre téléphone reste silencieux.
