# Мгновенное уведомление, как только задание падает.

> Получайте push-уведомления, когда фоновая задача или воркер падает с ошибкой. Подключите Pocket Alert к Sidekiq, Celery, очередям Laravel или BullMQ, и сбои воркеров быстро придут на телефон.

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

Обновлено: 2026-08-11

Вызывайте Pocket Alert из обработчика сбоя заданий в Sidekiq, Celery, Laravel или BullMQ. Упавший воркер передаст на ваш телефон имя задания, аргументы и исключение, а уведомление о завершении придёт, когда завершатся критичные задания.

## Три шага до уведомлений о фоновых заданиях

1. **Получите API-ключ или CLI** — Создайте API-ключ или установите CLI Pocket Alert для воркеров, которые работают из командной строки.
2. **Подключите обработку сбоев** — Вызовите Pocket Alert из обработчика сбоя вашего фреймворка очереди и передайте имя задания и ошибку.
3. **Ловите упавшие воркеры** — Запустите падающее задание. Телефон завибрирует и покажет, какой воркер упал и почему.

## Не пропустите упавший воркер

Воркер, который падает тихо, тянет за собой и ваши задания. Получайте уведомление, как только задача выбрасывает ошибку.

- **Подключение к любой очереди** — Sidekiq, Celery, Laravel, BullMQ и Hangfire вызывают Pocket Alert из уже существующего обработчика сбоя.
- **Уведомления о сбое** — Подключите обработчик отказов, и до вас дойдут только упавшие задания.
- **Полный контекст сбоя** — Класс задания, аргументы и исключение приходят в сообщении, поэтому можно разобрать проблему, не открывая трекер.
- **Подтверждение выполнения** — Уведомляйте о завершении критичных заданий. Если ночной импорт молчит, значит, он перестал выполняться.
- **Отдельный канал для каждого воркера** — Назначьте каждому воркеру своё приложение, чтобы зависшая очередь попадала в канал, который видно с первого взгляда.
- **Мгновенная реакция на сбой** — Упавший воркер отправит push-уведомление на телефон гораздо раньше, чем вы додумаетесь посмотреть логи.

## Уведомления прямо из обработчика задания

### Очередь 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 — событие 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) описано, как выбрать конкретное приложение или устройство.

## Частые вопросы

### Как настроить уведомления о сбоях фоновых заданий?

Вызовите Pocket Alert API или CLI из обработчика ошибок задания или блока rescue. Упавший воркер отправит push-уведомление на ваш телефон с именем задания и текстом ошибки.

### Можно ли подключиться к фреймворку очереди?

Да. Большинство фреймворков очередей предоставляют callback на сбой: death handlers в Sidekiq, task_failure в Celery и failed() в Laravel. Добавьте туда вызов Pocket Alert, и вы получите уведомление только о реальных сбоях.

### Можно ли добавить в уведомление задание и ошибку?

Укажите в теле класс задания, аргументы и сообщение исключения. Уведомление скажет, какое задание упало и почему, что обычно избавляет от похода в трекер ошибок.

### Какие системы очередей поддерживаются?

Sidekiq, Resque, Celery, RQ, очереди Laravel, BullMQ, Hangfire и Kubernetes Jobs работают через обработчик сбоя или ненулевой код выхода.

### Можно ли убедиться, что задание действительно выполнилось?

Отправляйте уведомление о завершении для критичных заданий. Если ночной импорт не присылает сигнал, воркер, вероятно, перестал обрабатывать задачи, даже не выбросив ошибку.

### Может ли уведомление о падении воркера обойти режим «Не беспокоить»?

Да. Передайте level=critical в обработчик сбоя, и на Android push-уведомление пойдёт через канал, который обходит режим «Не беспокоить», а на iPhone будет доставлено как срочное уведомление, которое пробивается через Фокусирование. Уведомления о завершении для рутинных заданий могут использовать level=silent и сохраняться в истории без звука.
