Background jobs & queues

Begitu job melempar error.

Panggil Pocket Alert dari failure hook job Anda di Sidekiq, Celery, Laravel, atau BullMQ. Worker yang melempar error akan mengirim nama job, argumen, dan exception ke HP Anda, dan notifikasi penyelesaian masuk saat job penting selesai.

Terpicu saat gagalJob + errorSidekiq · Celery · LaravelDiperbarui
Fitur

Jangan lewatkan worker yang mati

Worker yang mati diam-diam akan ikut menjatuhkan job Anda. Dapatkan kabar saat sebuah tugas melempar error.

Terhubung ke antrean apa pun

Sidekiq, Celery, Laravel, BullMQ, dan Hangfire memanggil Pocket Alert dari failure hook yang sudah Anda miliki.

Notifikasi saat gagal

Hubungkan ke death handler, dan hanya job yang gagal yang sampai ke Anda.

Konteks kegagalan lengkap

Class job, argumen, dan exception dikirim dalam pesan, sehingga Anda bisa memilah masalah tanpa membuka tracker.

Pastikan job berjalan

Kirim ping saat selesai untuk job penting. Impor nightly yang senyap berarti job itu berhenti berjalan.

Satu channel per worker

Berikan setiap worker aplikasinya sendiri, sehingga antrean yang macet muncul di channel yang mudah dikenali sekilas.

Langsung saat error

Worker yang melempar error langsung mengirim push ke HP Anda, jauh sebelum Anda terpikir untuk memantau log.

Mulai

Tiga langkah menuju notifikasi background job

1

Dapatkan kunci API atau CLI

Buat kunci API, atau pasang CLI Pocket Alert untuk worker berbasis shell.

2

Hubungkan ke kegagalan

Panggil Pocket Alert dari failure hook framework antrean Anda, lalu sertakan nama job dan error.

3

Tangkap worker yang mati

Picu job yang gagal. HP Anda akan bergetar dan menampilkan worker mana yang mati beserta alasannya.

Kirim notifikasi langsung dari job handler Anda

Antrean Laravel — hook 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

Di config/initializers/sidekiq.rb, jalankan setelah percobaan ulang habis:

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

Panduan dokumentasi membahas cara menargetkan aplikasi atau perangkat tertentu.

FAQ

Pertanyaan yang sering diajukan

Panggil API atau CLI Pocket Alert dari failure handler atau blok rescue job Anda. Worker yang melempar error akan mengirim push notification ke HP Anda, lengkap dengan nama job dan pesan error.

Bisa. Sebagian besar framework antrean menyediakan callback saat gagal: death handler di Sidekiq, task_failure di Celery, dan failed() di Laravel. Tambahkan panggilan Pocket Alert di sana, dan hanya kegagalan sungguhan yang memicu notifikasi.

Sertakan class job, argumen, dan pesan exception di badan notifikasi. Notifikasi akan memberi tahu job mana yang gagal dan alasannya, sehingga Anda biasanya tidak perlu membuka error tracker.

Sidekiq, Resque, Celery, RQ, antrean Laravel, BullMQ, Hangfire, dan Kubernetes Jobs semuanya bisa digunakan, baik lewat failure hook maupun exit code non-nol.

Kirim notifikasi penyelesaian untuk job penting. Jika impor nightly tidak pernah mengirim notifikasi, kemungkinan worker berhenti memproses tanpa melempar error apa pun.

Bisa. Berikan level=critical di failure hook, maka di Android push akan dikirim lewat channel yang melewati Jangan Ganggu, sedangkan di iPhone notifikasi dikirim sebagai notifikasi sensitif waktu yang tetap tembus Fokus. Notifikasi penyelesaian untuk job rutin bisa memakai level=silent sehingga tetap tercatat di riwayat tanpa suara.

Tangkap worker yang error tanpa memberi tahu siapa pun.

Hubungkan handler job Anda ke Pocket Alert. Worker yang melempar error akan muncul di HP Anda, bukan di file log yang tidak pernah dibuka siapa pun.