# Surveillez la file avant qu’elle ne s’accumule.

> Recevez une notification push dès qu’une file de messages s’engorge. Pocket Alert transforme la profondeur de file et le retard des consommateurs RabbitMQ ou SQS en alerte sur votre téléphone en moins d’une seconde.

<!-- source: https://pocketalert.app/fr/use-cases/queue-monitoring-alerts -->

Dernière mise à jour : 2026-08-11

Une file engorgée passe facilement inaperçue jusqu’à ce que les messages s’accumulent et que les utilisateurs ressentent le délai. Faites lire la profondeur par une petite vérification cron avec redis-cli, rabbitmqctl ou la AWS CLI, puis appelez Pocket Alert : un worker bloqué arrive sur votre téléphone en moins d’une seconde.

## Trois étapes pour les alertes de file

1. **Mesurer la file** — Lisez la profondeur de la file dans un script cron avec redis-cli LLEN, rabbitmqctl ou la AWS CLI.
2. **Déclencher au seuil** — Appelez pocketalert send (ou exécutez un curl sur l’API des messages) lorsque la profondeur dépasse votre seuil.
3. **Agir à temps** — Votre téléphone vibre en moins d’une seconde. Résorbez le retard avant que vos utilisateurs ne le remarquent.

## Repérez l’accumulation tant qu’elle est faible

Une vérification de profondeur d’une ligne dans cron appelle Pocket Alert. Elle transforme un chiffre que vous ne surveilleriez jamais en notification push exploitable.

- **Seuils de profondeur** — Un seuil défini dans votre script cron déclenche l’alerte dès que la profondeur dépasse la limite que vous avez fixée.
- **Détection de blocage** — Un backlog qui s’emballe ou un consommateur totalement bloqué envoient une notification push, tandis qu’un simple à-coup reste sous la limite.
- **Profondeur dans le message** — Ajoutez directement le nom de la file et la profondeur actuelle dans le titre et le message de l’appel.
- **Tous les brokers** — `redis-cli LLEN`, `rabbitmqctl list_queues` et la AWS CLI pour SQS renvoient tous un nombre que vous pouvez envoyer.
- **Canaux par file** — Chaque file dispose de son propre `application_id` : les paiements et les e-mails ne se mélangent jamais.
- **Livraison en moins d’une seconde** — La notification push arrive en moins d’une seconde, assez vite pour agir avant que le retard ne s’aggrave.

## Alerter sur une file engorgée

### Profondeur d’une liste Redis (LLEN)

Un minuscule script cron lit la profondeur et appelle la CLI dès que le seuil est franchi :

```
* * * * * depth=$(redis-cli LLEN queue:emails); \
  [ "$depth" -gt 10000 ] && pocketalert send \
    -t "Queue backed up" -m "emails: $depth pending"
```

### Longueur de file RabbitMQ

```
* * * * * depth=$(rabbitmqctl list_queues -p / name messages | awk '$1=="emails"{print $2}'); \
  [ "$depth" -gt 10000 ] && pocketalert send \
    -t "Queue backed up" -m "emails: $depth messages"
```

### Profondeur approximative SQS via l’API

```
depth=$(aws sqs get-queue-attributes --queue-url "$QUEUE_URL" \
  --attribute-names ApproximateNumberOfMessages \
  --query 'Attributes.ApproximateNumberOfMessages' --output text)
[ "$depth" -gt 10000 ] && curl -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"title\":\"Queue backed up\",\"message\":\"orders: $depth pending\",\"level\":\"critical\"}"
```

Donnez à chaque file son propre `application_id` pour que les paiements et les e-mails arrivent dans des canaux distincts. La [documentation](https://info.pocketalert.app/getting-started.html) détaille le ciblage et les canaux par application.

## FAQ

### Comment recevoir des alertes pour une file engorgée ?

Lancez un petit script cron qui lit la profondeur de la file et appelle `pocketalert send` (ou exécute un curl sur l’API des messages) lorsqu’elle dépasse votre seuil. Compatible avec `LLEN` de Redis, `list_queues` de RabbitMQ et `ApproximateNumberOfMessages` de SQS.

### Puis-je distinguer un vrai blocage d’un retard passager ?

Définissez le seuil dans le script. Un retard court et résorbable ne franchit jamais la limite : seul un blocage réel ou une profondeur qui s’emballe déclenche une notification push.

### Quels brokers peuvent fournir la profondeur ?

Tout broker interrogeable depuis le shell fonctionne. `redis-cli LLEN queue:emails`, `rabbitmqctl list_queues` ou la AWS CLI pour SQS renvoient tous un nombre que vous pouvez comparer et envoyer.

### Comment le nom de la file et sa profondeur apparaissent-ils ?

Placez directement le nom de la file et la profondeur actuelle dans le titre et le message de l’appel. La notification affiche ainsi `emails: 18420 pending` sans code supplémentaire.

### Puis-je séparer les alertes par file ou par service ?

Transmettez un `application_id` différent pour chaque file. La file des e-mails et le worker des paiements arrivent dans des canaux distincts, et vous savez immédiatement où regarder.

### Une alerte de file bloquée peut-elle passer le mode silencieux ?

Oui. Donnez à l’alerte `level=critical` : sur Android, elle est publiée sur un canal qui contourne le mode Ne pas déranger, tandis que sur iPhone elle s’affiche comme notification urgente qui passe la Concentration. Si vous envoyez aussi des rapports de profondeur routiniers, transmettez-les avec `level=silent` : ils apparaissent dans l’historique sans vibration.
