バックグラウンドジョブ & キュー

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

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

失敗時に通知ジョブ + エラーSidekiq · Celery · Laravel 更新
機能

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

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

どのキューにも接続可能

Sidekiq、Celery、Laravel、BullMQ、Hangfire は、既存の失敗フックから Pocket Alert を呼び出せます。

失敗時に通知

death handler に組み込めば、失敗したジョブだけが通知されます。

失敗の詳細をすべて

ジョブのクラス、引数、例外がメッセージに含まれるため、エラートラッカーを開かずに初期対応できます。

実行されたことを確認

重要なジョブの完了時に通知します。夜間インポートの通知が来なければ、実行されていないと判断できます。

ワーカーごとのチャンネル

ワーカーごとに個別のアプリケーションを割り当てると、詰まったキューを一目で見分けられるチャンネルに届きます。

エラー発生と同時に通知

ワーカーがエラーで停止すると、ログを確認するより前にスマホへプッシュ通知が届きます。

はじめ方

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

1

API キーまたは CLI を取得

API キーを作成するか、シェルで動くワーカー向けに Pocket Alert CLI をインストールしてください。

2

失敗フックに接続

キューフレームワークの失敗フックから Pocket Alert を呼び出し、ジョブ名とエラーを渡してください。

3

停止したワーカーを検知

失敗するジョブを実行してみてください。どのワーカーがなぜ停止したかがスマホに届きます。

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

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

対象のアプリケーションやデバイスの指定方法はドキュメントをご覧ください。

FAQ

よくある質問

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

誰にも知らされないまま落ちたワーカーを見逃さない。

ジョブハンドラーを Pocket Alert に接続しましょう。エラーで止まったワーカーは、誰も読まないログファイルではなくスマホに届きます。