# Monitore a fila antes que ele se acumule.

> Receba uma notificação push assim que uma fila de mensagens começar a acumular. O Pocket Alert transforma a profundidade da fila e o consumer lag do RabbitMQ ou SQS em um alerta no seu celular em menos de um segundo.

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

Última atualização: 2026-08-11

Uma fila acumulada passa despercebida até que as mensagens se empilhem e os usuários sintam o atraso. Faça uma pequena verificação cron ler a profundidade com redis-cli, rabbitmqctl ou a AWS CLI e chamar o Pocket Alert, e um worker parado chega ao seu celular em menos de um segundo.

## Três passos para alertas de fila

1. **Meça a fila** — Leia a profundidade da fila em um script cron com redis-cli LLEN, rabbitmqctl ou a AWS CLI.
2. **Dispare ao atingir o limite** — Chame pocketalert send (ou faça uma requisição cURL à API de mensagens) quando a profundidade ultrapassar o seu limite.
3. **Aja a tempo** — Seu celular vibra em menos de um segundo. Esvazie o acúmulo antes que os usuários percebam.

## Perceba o acúmulo enquanto ele ainda é pequeno

Uma verificação de profundidade de uma linha no cron chama o Pocket Alert. Ela transforma um número que você nunca acompanharia em uma notificação push na qual você pode agir.

- **Limites de profundidade** — Um limite no seu script cron dispara o alerta assim que a profundidade ultrapassa a linha definida.
- **Detecção de paradas** — Um acúmulo descontrolado ou um consumidor totalmente parado envia uma push, enquanto uma oscilação breve fica abaixo da linha.
- **Profundidade na mensagem** — Coloque o nome da fila e a profundidade atual diretamente no título e na mensagem da chamada.
- **Qualquer broker** — `redis-cli LLEN`, `rabbitmqctl list_queues` e a AWS CLI para SQS retornam um número que você pode enviar.
- **Canais por fila** — Cada fila recebe seu próprio `application_id`, então pagamentos e emails nunca se misturam.
- **Entrega em menos de um segundo** — A push chega em menos de um segundo, rápido o suficiente para agir antes que o acúmulo cresça.

## Receba alertas de uma fila acumulada

### Profundidade de lista no Redis (LLEN)

Um pequeno script cron lê a profundidade e chama a CLI assim que ela ultrapassa o seu limite:

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

### Tamanho de fila no 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"
```

### Profundidade aproximada no SQS via 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\"}"
```

Dê a cada fila o seu próprio `application_id`, para que pagamentos e emails fiquem em canais separados. A [documentação](https://info.pocketalert.app/getting-started.html) cobre o direcionamento e os canais por aplicativo.

## Perguntas frequentes

### Como receber alertas de uma fila acumulada?

Execute um pequeno script cron que lê a profundidade da fila e chama `pocketalert send` (ou faz uma requisição cURL à API de mensagens) quando ela ultrapassar o seu limite. Funciona com `LLEN` do Redis, `list_queues` do RabbitMQ e `ApproximateNumberOfMessages` do SQS.

### Consigo separar uma parada real de um acúmulo passageiro?

Defina o limite no script. Um acúmulo curto e que se resolve sozinho nunca ultrapassa a linha, então apenas uma parada real ou uma profundidade descontrolada envia uma notificação push.

### De quais brokers posso ler a profundidade?

Qualquer broker que você possa consultar pelo shell funciona. `redis-cli LLEN queue:emails`, `rabbitmqctl list_queues` ou a AWS CLI para SQS retornam um número que você pode comparar e enviar.

### Como o nome da fila e a profundidade aparecem?

Coloque o nome da fila e a profundidade atual diretamente no título e na mensagem da chamada, para que a push leia `emails: 18420 pending` sem nenhum código extra de integração.

### Consigo separar os alertas por fila ou serviço?

Passe um `application_id` diferente para cada fila. A fila de emails e o worker de pagamentos ficam em canais separados, então você lê o alerta e já sabe onde procurar.

### Um alerta de fila parada consegue furar o modo silencioso?

Sim. Envie o alerta com `level=critical` e o Android o publica em um canal que ignora o Não perturbe, enquanto o iPhone o exibe como notificação sensível ao tempo, que fura o Foco. Se você também envia relatórios de profundidade de rotina, use `level=silent` para que cheguem ao histórico sem vibrar.
