# ジョブが例外を投げた瞬間 に。

> バックグラウンドジョブやワーカーの失敗をプッシュ通知でお知らせ。Pocket Alert を Sidekiq、Celery、Laravel のキュー、BullMQ に連携すれば、ワーカーの失敗をすぐスマホで確認できます。

<!-- source: https://pocketalert.app/ja/use-cases/background-job-alerts -->

最終更新日:2026-08-11

Sidekiq、Celery、Laravel、BullMQ の失敗フックから Pocket Alert を呼び出しましょう。エラーで止まったワーカーのジョブ名、引数、例外がスマホに届き、重要なジョブの完了時には完了通知も届きます。

## バックグラウンドジョブのアラートを設定する 3 ステップ

1. **API キーまたは CLI を取得** — API キーを作成するか、シェルで動くワーカー向けに Pocket Alert CLI をインストールしてください。
2. **失敗フックに接続** — キューフレームワークの失敗フックから Pocket Alert を呼び出し、ジョブ名とエラーを渡してください。
3. **停止したワーカーを検知** — 失敗するジョブを実行してみてください。どのワーカーがなぜ停止したかがスマホに届きます。

## 停止したワーカーを見逃さない

静かに停止したワーカーは、ジョブ全体を道連れにします。タスクが例外を投げたら通知を受け取りましょう。

- **どのキューにも接続可能** — Sidekiq、Celery、Laravel、BullMQ、Hangfire は、既存の失敗フックから Pocket Alert を呼び出せます。
- **失敗時に通知** — death handler に組み込めば、失敗したジョブだけが通知されます。
- **失敗の詳細をすべて** — ジョブのクラス、引数、例外がメッセージに含まれるため、エラートラッカーを開かずに初期対応できます。
- **実行されたことを確認** — 重要なジョブの完了時に通知します。夜間インポートの通知が来なければ、実行されていないと判断できます。
- **ワーカーごとのチャンネル** — ワーカーごとに個別のアプリケーションを割り当てると、詰まったキューを一目で見分けられるチャンネルに届きます。
- **エラー発生と同時に通知** — ワーカーがエラーで停止すると、ログを確認するより前にスマホへプッシュ通知が届きます。

## ジョブハンドラーからそのままアラートを送信

### 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}`,
    }),
  });
});
```

対象のアプリケーションやデバイスの指定方法は[ドキュメント](https://info.pocketalert.app/getting-started.html)をご覧ください。

## よくある質問

### バックグラウンドジョブの失敗をアラートで受け取るには？

ジョブの失敗ハンドラーや 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 を使うと、音を鳴らさず履歴にだけ残せます。
