# Begitu job melempar error.

> Dapatkan push notification saat background job atau worker gagal. Hubungkan Pocket Alert ke Sidekiq, Celery, Laravel queue, atau BullMQ, dan kegagalan worker langsung sampai ke HP Anda.

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

Terakhir diperbarui: 2026-08-11

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.

## 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.

## 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.

## 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](https://info.pocketalert.app/getting-started.html) membahas cara menargetkan aplikasi atau perangkat tertentu.

## FAQ

### Bagaimana cara mendapat notifikasi saat background job gagal?

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.

### Bisakah saya terhubung ke framework antrean saya?

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.

### Bisakah saya menyertakan job dan error?

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.

### Sistem antrean apa saja yang didukung?

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

### Bisakah saya memastikan job benar-benar berjalan?

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

### Bisakah notifikasi worker mati menembus Jangan Ganggu?

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.
