# 큐를 지켜보세요 쌓이기 전에.

> 메시지 큐가 밀리는 즉시 푸시 알림을 받아보세요. Pocket Alert는 RabbitMQ나 SQS의 큐 깊이와 컨슈머 랙을 1초 안에 휴대폰 알림으로 전달해요.

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

마지막 업데이트: 2026-08-11

백로그는 메시지가 쌓이고 사용자가 지연을 느끼기 전까지 놓치기 쉬워요. 작은 크론 작업이 redis-cli, rabbitmqctl, AWS CLI로 깊이를 읽고 Pocket Alert를 호출하면, 멈춘 워커의 알림이 1초 안에 휴대폰에 도착해요.

## 큐 알림 설정 3단계

1. **큐 측정** — 크론 스크립트에서 redis-cli LLEN, rabbitmqctl, AWS CLI로 큐 깊이를 읽어요.
2. **기준선에서 발송** — 깊이가 기준선을 넘으면 pocketalert send를 호출하거나 메시지 API에 curl 요청을 보내요.
3. **제때 대응** — 1초 안에 휴대폰이 울려요. 사용자가 눈치채기 전에 백로그를 해소하세요.

## 백로그가 작을 때 잡아내세요

크론 작업에 한 줄짜리 깊이 체크를 넣으면 Pocket Alert를 호출해요. 평소에는 지켜보지 않을 숫자를 바로 대응할 수 있는 푸시 알림으로 바꿔 줘요.

- **깊이 기준선** — 크론 스크립트의 기준선은 큐 깊이가 설정한 값을 넘는 순간 알림을 보내요.
- **정체 감지** — 백로그가 계속 쌓이거나 소비자가 완전히 멈추면 푸시 알림을 보내고, 잠깐의 변동은 기준선 아래에서 무시해요.
- **메시지에 깊이 표시** — 큐 이름과 현재 깊이를 호출의 제목과 메시지에 바로 넣을 수 있어요.
- **모든 브로커 지원** — redis-cli LLEN, rabbitmqctl list_queues, SQS용 AWS CLI 모두 알림으로 보낼 수 있는 숫자를 반환해요.
- **큐별 채널** — 큐마다 고유한 application_id를 받아서, 결제와 이메일 알림이 섞이지 않아요.
- **1초 미만 전달** — 푸시 알림은 1초 안에 도착해요. 백로그가 커지기 전에 바로 대응할 수 있어요.

## 백로그가 쌓인 큐에 알림 받기

### Redis 리스트 깊이 (LLEN)

작은 크론 스크립트가 깊이를 읽고, 기준선을 넘으면 CLI를 한 번 호출해요:

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

### 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"
```

### API로 SQS 대략적인 깊이 확인

```
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\"}"
```

큐마다 고유한 `application_id`를 지정하면 결제와 이메일 알림이 서로 다른 채널로 전달돼요. 대상 지정과 애플리케이션별 채널에 대한 자세한 내용은 [문서](https://info.pocketalert.app/getting-started.html)에서 확인할 수 있어요.

## 자주 묻는 질문

### 큐에 메시지가 쌓였을 때 알림은 어떻게 받나요?

큐 깊이를 읽고 기준선을 넘으면 `pocketalert send`를 호출하거나 메시지 API에 curl 요청을 보내는 작은 크론 스크립트를 실행하세요. Redis `LLEN`, RabbitMQ `list_queues`, SQS `ApproximateNumberOfMessages`와 함께 쓸 수 있어요.

### 실제 정체와 잠깐의 백로그를 구분할 수 있나요?

스크립트에서 기준선을 설정하세요. 금방 해소되는 짧은 백로그는 기준선을 넘지 않으므로, 실제로 처리가 멈췄거나 깊이가 계속 늘어날 때만 푸시 알림이 전송돼요.

### 어떤 브로커의 큐 깊이를 읽을 수 있나요?

셸에서 조회할 수 있는 브로커라면 모두 사용할 수 있어요. `redis-cli LLEN queue:emails`, `rabbitmqctl list_queues`, SQS용 AWS CLI 모두 비교하고 알림을 보낼 수 있는 숫자를 반환해요.

### 큐 이름과 깊이는 알림에 어떻게 표시되나요?

큐 이름과 현재 깊이를 호출의 제목과 메시지에 그대로 넣으면, 추가 코드 없이 `emails: 18420 pending`처럼 푸시 알림에 표시돼요.

### 큐나 서비스별로 알림을 나눌 수 있나요?

큐마다 다른 `application_id`를 지정하세요. emails 큐와 payments 워커의 알림이 서로 다른 채널로 전달되어, 알림만 보고도 어디를 확인해야 할지 알 수 있어요.

### 정체된 큐 알림이 무음 모드를 뚫고 올 수 있나요?

네. 알림에 `level=critical`을 지정하면 안드로이드에서는 방해 금지 모드를 무시하는 채널로 전달되고, 아이폰에서는 집중 모드를 뚫고 나오는 시간 민감 알림으로 표시돼요. 정기적인 깊이 리포트도 함께 보낸다면 `level=silent`로 보내세요. 진동 없이 기록에만 남아요.
