# En el instante en que un cron job falla.

> Recibe una notificación push cuando falle una tarea cron o programada. Añade una línea a tu crontab o a tu systemd timer y las alertas de fallo llegan a tu teléfono en menos de un segundo.

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

Última actualización: 2026-10-17

Pocket Alert envía una notificación push a tu teléfono en el momento en que falla un cron job. Encadena una línea a cualquier comando programado con && o || — dispara con el fallo, con el éxito o con ambos, y el push llega al terminar el job, con la salida de error incluida.

## Tres pasos para alertas de fallos en cron

1. **Obtén tu URL o la CLI** — Copia la URL de webhook entrante de tu aplicación o instala la CLI de Pocket Alert.
2. **Añade una línea** — Encadena una llamada de curl o pocketalert send a tu línea de cron, con || para los fallos o && para los éxitos.
3. **Recibe la alerta** — Ejecuta el job. Si falla, tu teléfono vibrará con el título y la salida de error que configuraste.

## Nunca más pases por alto un job fallido

Una importación fallida debería avisarte al momento, horas antes de que abras los logs.

- **Una línea en crontab** — Encadena un push a cualquier línea de cron con && o ||. Es una sola llamada de curl, sin daemon que vigilar.
- **Alerta solo si falla** — Con ||, la alerta solo se dispara cuando el comando termina con código distinto de cero.
- **Incluye el error** — Envía stderr o el código de salida en el mensaje, así el push llega con el error ya adjunto.
- **Cualquier planificador** — crontab, timers de systemd, el scheduler de Laravel, Sidekiq y CronJobs de K8s funcionan, porque todos ejecutan comandos.
- **Latido en caso de éxito** — Envía un latido tras una ejecución correcta. Cuando deje de llegar, sabrás que el job murió en silencio y podrás investigar.
- **Inmediato al terminar** — El push llega en cuanto el job termina, horas antes de que alguien revise los logs.

## Añade una alerta a tu cron job

### Instala y autentica la CLI

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

### Alerta solo cuando el job falle

Encadena la alerta con `||` para que se dispare solo con un código de salida distinto de cero:

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

### Incluye la salida de error

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

### Latido en caso de éxito

Añade un ping con `&&` tras una ejecución correcta. Cuando deje de llegar, el job murió en silencio:

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

### ¿Sin CLI? Llama a la 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 [documentación](https://info.pocketalert.app/getting-started.html) explica la segmentación y los canales por aplicación.

## Preguntas frecuentes

### ¿Cómo recibo alertas de los cron jobs?

Encadena una notificación a tu comando cron en la shell. `&&` se ejecuta tras una ejecución correcta, `||` tras un fallo, y Pocket Alert envía la notificación push cuando el job termina.

### ¿Puedo recibir alertas solo cuando falle?

Usa `||` para que la alerta solo se dispare cuando el comando termine con código distinto de cero: `mybackup.sh || curl ...`. Los jobs que fallen te llegarán y el resto no hará ruido.

### ¿Puedo incluir el error en la alerta?

Sí. Captura el código de salida o la salida y pásalos al cuerpo del mensaje. La CLI de Pocket Alert envía stderr directamente a la notificación.

### ¿Funciona más allá de crontab?

Funciona con cualquier planificador: crontab, timers de systemd, el scheduler de Laravel, cron de Rails o Sidekiq, el Programador de tareas de Windows, CronJobs de Kubernetes. Si ejecuta un comando, puedes encadenar una alerta.

### ¿Puedo detectar un job que nunca se ejecutó?

Envía un ping de finalización con `&&` después de cada ejecución correcta. Cuando el ping deje de llegar, sabrás que el job dejó de ejecutarse, sin herramientas adicionales.

### ¿Puede un job nocturno fallido despertarme, y los pings de éxito quedar en silencio?

Añade level=critical a la alerta de fallo y atravesará No molestar en Android y Concentración en iPhone. Para los pings de latido, usa level=silent: quedan en tu historial sin sonido, así que el registro está ahí pero tu teléfono sigue en silencio.
