停止したワーカーを見逃さない
静かに停止したワーカーは、ジョブ全体を道連れにします。タスクが例外を投げたら通知を受け取りましょう。
どのキューにも接続可能
Sidekiq、Celery、Laravel、BullMQ、Hangfire は、既存の失敗フックから Pocket Alert を呼び出せます。
失敗時に通知
death handler に組み込めば、失敗したジョブだけが通知されます。
失敗の詳細をすべて
ジョブのクラス、引数、例外がメッセージに含まれるため、エラートラッカーを開かずに初期対応できます。
実行されたことを確認
重要なジョブの完了時に通知します。夜間インポートの通知が来なければ、実行されていないと判断できます。
ワーカーごとのチャンネル
ワーカーごとに個別のアプリケーションを割り当てると、詰まったキューを一目で見分けられるチャンネルに届きます。
エラー発生と同時に通知
ワーカーがエラーで停止すると、ログを確認するより前にスマホへプッシュ通知が届きます。
バックグラウンドジョブのアラートを設定する 3 ステップ
API キーまたは CLI を取得
API キーを作成するか、シェルで動くワーカー向けに Pocket Alert CLI をインストールしてください。
失敗フックに接続
キューフレームワークの失敗フックから Pocket Alert を呼び出し、ジョブ名とエラーを渡してください。
停止したワーカーを検知
失敗するジョブを実行してみてください。どのワーカーがなぜ停止したかがスマホに届きます。
ジョブハンドラーからそのままアラートを送信
Laravel キュー — failed() フック
public function failed(Throwable $e): void
{
Http::withHeaders(['Token' => 'YOUR_API_KEY'])
->post('https://api.pocketalert.app/v1/messages', [
'title' => 'Job failed: ' . class_basename($this),
'message' => $e->getMessage(),
'level' => 'critical',
]);
}
Sidekiq — death handler
config/initializers/sidekiq.rb に記述し、リトライが尽きたら発火させます:
Sidekiq.configure_server do |config|
config.death_handlers << ->(job, ex) do
Net::HTTP.post(
URI('https://api.pocketalert.app/v1/messages'),
{ title: "Job died: #{job['class']}",
message: "jid #{job['jid']}: #{ex.message}" }.to_json,
'Token' => 'YOUR_API_KEY', 'Content-Type' => 'application/json')
end
end
Celery — task_failure シグナル
import requests
from celery.signals import task_failure
@task_failure.connect
def notify_failure(sender=None, task_id=None, exception=None, **kw):
requests.post(
'https://api.pocketalert.app/v1/messages',
headers={'Token': 'YOUR_API_KEY'},
json={'title': f'Task failed: {sender.name}',
'message': f'{task_id}: {exception}'})
BullMQ — worker の failed イベント
worker.on('failed', async (job, err) => {
await fetch('https://api.pocketalert.app/v1/messages', {
method: 'POST',
headers: { 'Token': 'YOUR_API_KEY', 'Content-Type': 'application/json' },
body: JSON.stringify({
title: `Job failed: ${job?.name}`,
message: `${job?.id}: ${err.message}`,
}),
});
});
対象のアプリケーションやデバイスの指定方法はドキュメントをご覧ください。
よくある質問
ジョブの失敗ハンドラーや rescue ブロックから Pocket Alert API または CLI を呼び出してください。例外が発生すると、ジョブ名とエラー内容を添えたプッシュ通知がスマホに届きます。
はい。多くのキューフレームワークには失敗時のコールバックがあります。Sidekiq の death handler、Celery の task_failure、Laravel の failed() です。そこに Pocket Alert の呼び出しを置けば、本当に失敗したときだけ通知されます。
本文にジョブのクラス、引数、例外メッセージを入れてください。どのジョブがなぜ失敗したかが通知でわかるので、多くの場合エラートラッカーを開く手間が省けます。
Sidekiq、Resque、Celery、RQ、Laravel キュー、BullMQ、Hangfire、Kubernetes Jobs はいずれも、失敗フックまたはゼロ以外の終了コードを通じて対応しています。
重要なジョブには完了通知を送ってください。夜間のインポートが通知を送ってこなければ、例外を出さずに処理が止まっている可能性が高いです。
はい。失敗フックで level=critical を指定すると、Android ではおやすみモードを回避するチャンネル経由で通知が届き、iPhone では集中モードも突破する時間重視の通知として配信されます。定期ジョブの完了通知には level=silent を使うと、音を鳴らさず履歴にだけ残せます。