Фоновые задания и очереди

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

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

Срабатывает при сбоеЗадание + ошибкаSidekiq · Celery · LaravelОбновлено
Возможности

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

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

Подключение к любой очереди

Sidekiq, Celery, Laravel, BullMQ и Hangfire вызывают Pocket Alert из уже существующего обработчика сбоя.

Уведомления о сбое

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

Полный контекст сбоя

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

Подтверждение выполнения

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

Отдельный канал для каждого воркера

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

Мгновенная реакция на сбой

Упавший воркер отправит push-уведомление на телефон гораздо раньше, чем вы додумаетесь посмотреть логи.

Быстрый старт

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

1

Получите API-ключ или CLI

Создайте API-ключ или установите CLI Pocket Alert для воркеров, которые работают из командной строки.

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 — событие 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

Ответы на вопросы

Вызовите 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 и сохраняться в истории без звука.

Узнайте о падении воркера, даже если никто не сообщил.

Подключите обработчик заданий к Pocket Alert. Упавший воркер появится на вашем телефоне, а не в лог-файле, который никто не читает.