バックログが小さいうちに検知
cron の 1 行の件数チェックから Pocket Alert を呼び出します。普段は見ることのない数値を、対応に役立つプッシュ通知に変えます。
件数の閾値
cron スクリプト内の閾値を超えると、設定したラインを上回った時点でアラートが送信されます。
停止の検知
バックログの異常な増加やコンシューマーの完全な停止はプッシュ通知で知らせ、短時間の変動はラインを超えないため通知しません。
メッセージに件数を表示
キュー名と現在の件数を、呼び出しのタイトルとメッセージにそのまま入れられます。
あらゆるブローカーに対応
redis-cli LLEN、rabbitmqctl list_queues、SQS 用の AWS CLI はいずれも送信できる数値を返します。
キューごとのチャンネル
キューごとに個別の application_id が割り当てられるため、決済とメールの通知が混ざりません。
1 秒未満で配信
プッシュ通知は 1 秒以内に届くため、バックログが膨らむ前に対応できます。
キューのアラートを設定する 3 ステップ
キューを計測
cron スクリプトで redis-cli LLEN、rabbitmqctl、AWS CLI を使ってキューの件数を読み取ります。
閾値で通知
件数が閾値を超えたら pocketalert send(またはメッセージ API への curl)を呼び出します。
すぐに対応
1 秒以内にスマホが振動します。ユーザーが気づく前にバックログを解消しましょう。
滞留したキューをプッシュ通知で検知
Redis リストの件数 (LLEN)
小さな cron スクリプトが件数を読み取り、閾値を超えたら 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)を呼び出す小さな cron スクリプトを実行します。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` を指定すると、Android ではおやすみモードを貫通するチャンネルに投稿され、iPhone では集中モードを貫通する時間に敏感な通知として表示されます。定期的な件数レポートも送る場合は `level=silent` を指定すると、振動せず履歴にだけ残ります。