큐 모니터링

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

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

<1초 이내 푸시모든 브로커 지원Redis · RabbitMQ · SQS 업데이트
기능

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

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

깊이 기준선

크론 스크립트의 기준선은 큐 깊이가 설정한 값을 넘는 순간 알림을 보내요.

정체 감지

백로그가 계속 쌓이거나 소비자가 완전히 멈추면 푸시 알림을 보내고, 잠깐의 변동은 기준선 아래에서 무시해요.

메시지에 깊이 표시

큐 이름과 현재 깊이를 호출의 제목과 메시지에 바로 넣을 수 있어요.

모든 브로커 지원

redis-cli LLEN, rabbitmqctl list_queues, SQS용 AWS CLI 모두 알림으로 보낼 수 있는 숫자를 반환해요.

큐별 채널

큐마다 고유한 application_id를 받아서, 결제와 이메일 알림이 섞이지 않아요.

1초 미만 전달

푸시 알림은 1초 안에 도착해요. 백로그가 커지기 전에 바로 대응할 수 있어요.

시작하기

큐 알림 설정 3단계

1

큐 측정

크론 스크립트에서 redis-cli LLEN, rabbitmqctl, AWS CLI로 큐 깊이를 읽어요.

2

기준선에서 발송

깊이가 기준선을 넘으면 pocketalert send를 호출하거나 메시지 API에 curl 요청을 보내요.

3

제때 대응

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를 지정하면 결제와 이메일 알림이 서로 다른 채널로 전달돼요. 대상 지정과 애플리케이션별 채널에 대한 자세한 내용은 문서에서 확인할 수 있어요.

FAQ

궁금한 점을 답해드려요

큐 깊이를 읽고 기준선을 넘으면 `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`로 보내세요. 진동 없이 기록에만 남아요.

큐가 밀리기 시작하면 바로 알아채세요.

모니터링 도구나 간단한 깊이 체크 스크립트를 Pocket Alert에 연결하고, 사용자가 먼저 알아채기 전에 백로그를 잡아내세요.