# Nel momento in cui un cron job fallisce.

> Ricevi una notifica push quando un cron job o un'attività programmata fallisce. Aggiungi una riga al tuo crontab o al timer systemd e gli avvisi di errore arrivano sul tuo telefono in meno di un secondo.

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

Ultimo aggiornamento: 2026-10-17

Pocket Alert invia una notifica push sul tuo telefono nel momento in cui un cron job fallisce. Collega una riga a qualsiasi comando pianificato con && o || — avviso in caso di errore, di successo o di entrambi, e la push arriva nel momento in cui il job termina, output dell'errore incluso.

## Tre passaggi per avvisi di errore dei cron job

1. **Ottieni l'URL o la CLI** — Copia l'URL del webhook in entrata per la tua applicazione, oppure installa la CLI di Pocket Alert.
2. **Aggiungi una riga** — Collega una chiamata curl o pocketalert send alla tua riga cron, con || per gli errori o && per il successo.
3. **Ricevi l'avviso** — Esegui il job. Se fallisce, il telefono vibra con il titolo e l'output dell'errore che hai impostato.

## Non perdere più un job fallito

Un import fallito dovrebbe avvisarti subito, ore prima che tu apra i log.

- **Una riga nel crontab** — Collega una push a qualsiasi riga cron con && o ||. È una sola chiamata curl, senza daemon da tenere in vita.
- **Avviso solo in caso di errore** — Con ||, l'avviso scatta solo quando il comando termina con un codice diverso da zero.
- **Includi l'errore** — Invia stderr o il codice di uscita nel messaggio, così la push arriva con l'errore già allegato.
- **Qualsiasi scheduler** — crontab, timer systemd, lo scheduler di Laravel, Sidekiq e K8s CronJobs funzionano tutti, perché ognuno esegue comandi.
- **Heartbeat al successo** — Invia un heartbeat dopo un'esecuzione riuscita. Quando smette di arrivare, sai che il job si è fermato in silenzio e puoi indagare.
- **Immediata alla fine** — La push arriva nel momento in cui il job termina, ore prima che qualcuno controlli i log.

## Collega un avviso al tuo cron job

### Installa e autentica la CLI

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

### Avvisa solo se il job fallisce

Concatena l'avviso con `||` così scatta solo con un codice di uscita diverso da zero:

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

### Includi l'output dell'errore

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

### Heartbeat al successo

Aggiungi un ping con `&&` dopo un'esecuzione pulita. Quando smette di arrivare, il job si è fermato in silenzio:

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

### Niente CLI? Chiama l'API con 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 [documentazione](https://info.pocketalert.app/getting-started.html) spiega come scegliere i destinatari e i canali per applicazione.

## FAQ

### Come ricevo notifiche dai cron job?

Concatena una notifica al comando cron nella shell. `&&` scatta dopo un'esecuzione riuscita, `||` scatta dopo un errore, e Pocket Alert invia la notifica push quando il job termina.

### Posso ricevere avvisi solo in caso di errore?

Usa `||` così l'avviso scatta solo quando il comando termina con un codice diverso da zero: `mybackup.sh || curl ...`. Ti arrivano solo i job falliti, il resto resta silenzioso.

### Posso includere l'output dell'errore?

Sì. Cattura il codice di uscita o l'output e inseriscilo nel corpo del messaggio. La CLI di Pocket Alert invia direttamente stderr nella notifica.

### Funziona anche oltre crontab?

Funziona con qualsiasi scheduler: crontab, timer systemd, lo scheduler di Laravel, cron di Rails o Sidekiq, Utilità di pianificazione di Windows, Kubernetes CronJobs. Se esegue un comando, puoi collegarci un avviso.

### Posso rilevare un job che non è mai partito?

Invia un ping di completamento con `&&` dopo ogni esecuzione riuscita. Quando il ping smette di arrivare, sai che il job ha smesso di girare, senza strumenti aggiuntivi.

### Un job notturno fallito può svegliarmi, mentre i ping di successo restano silenziosi?

Aggiungi level=critical all'avviso di errore e supererà Non disturbare su Android e Full immersion su iPhone. Per i ping heartbeat usa level=silent: finiscono nella cronologia senza suono, quindi la traccia c'è ma il telefono resta silenzioso.
