백로그가 작을 때 잡아내세요
크론 작업에 한 줄짜리 깊이 체크를 넣으면 Pocket Alert를 호출해요. 평소에는 지켜보지 않을 숫자를 바로 대응할 수 있는 푸시 알림으로 바꿔 줘요.
깊이 기준선
크론 스크립트의 기준선은 큐 깊이가 설정한 값을 넘는 순간 알림을 보내요.
정체 감지
백로그가 계속 쌓이거나 소비자가 완전히 멈추면 푸시 알림을 보내고, 잠깐의 변동은 기준선 아래에서 무시해요.
메시지에 깊이 표시
큐 이름과 현재 깊이를 호출의 제목과 메시지에 바로 넣을 수 있어요.
모든 브로커 지원
redis-cli LLEN, rabbitmqctl list_queues, SQS용 AWS CLI 모두 알림으로 보낼 수 있는 숫자를 반환해요.
큐별 채널
큐마다 고유한 application_id를 받아서, 결제와 이메일 알림이 섞이지 않아요.
1초 미만 전달
푸시 알림은 1초 안에 도착해요. 백로그가 커지기 전에 바로 대응할 수 있어요.
큐 알림 설정 3단계
큐 측정
크론 스크립트에서 redis-cli LLEN, rabbitmqctl, AWS CLI로 큐 깊이를 읽어요.
기준선에서 발송
깊이가 기준선을 넘으면 pocketalert send를 호출하거나 메시지 API에 curl 요청을 보내요.
제때 대응
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를 지정하면 결제와 이메일 알림이 서로 다른 채널로 전달돼요. 대상 지정과 애플리케이션별 채널에 대한 자세한 내용은 문서에서 확인할 수 있어요.
궁금한 점을 답해드려요
큐 깊이를 읽고 기준선을 넘으면 `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에 연결하고, 사용자가 먼저 알아채기 전에 백로그를 잡아내세요.