# Мониторинг задач по расписанию: как поймать сбой, если скрипт молчит

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

URL: https://posts.danashkin.ru/guides/monitoring-zadach-po-raspisaniyu
Обновлено: 2026-11-19

---

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

Запланированная задача могла не запуститься, застрять на выгрузке или закончить работу со старым файлом. Мониторинг задач по расписанию нужен именно для такого случая: он сообщает, когда к ожидаемому сроку нет подтверждённого результата.

**Главное**

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

## Зачем нужен мониторинг задач по расписанию?

**Главное**

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

Возьмём условную ежедневную выгрузку для команды продаж. В восемь утра она должна взять данные за вчера и сохранить новый файл. Скрипт ловит часть исключений и пишет в чат.

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

Вместо одного канала «если упало, сообщи» добавь ожидание результата извне. Наблюдатель знает, что отчёт нужен к определённому времени. Он получает отметку о завершении, а при её отсутствии сообщает о пропуске.

Если задача работает на одном сервере, наблюдателю полезно быть в другом контуре, чтобы не выключиться вместе с источником. Так устроен мониторинг периодических заданий через контрольные отметки, описанный у Healthchecks.io.

В блоге есть пример похожего различия на работе [ИИ-агента](/concepts/ai-agent): [«готово» в чате и фактический результат](/guides/agent-otchitalsya-a-rezultata-net) проверяются разными способами. В задаче по расписанию отсутствие новой строки в чате тем более не заменяет проверку.

## Отметка после проверки результата

**Главное**

Отправляй сигнал после сохранения и минимальной проверки результата. Для отчёта подтверждай нужный период, доступность файла и основные поля. Когда отсутствие новых строк допустимо, зафиксируй, что источники действительно прочитаны.

Условный утренний отчёт должен содержать данные за 11 ноября. Скрипт запросил их, получил таблицу и записал файл. Для сигнала успеха открой полученный файл, прочитай дату внутри и проверь, что нужные столбцы есть.

Дата изменения файла недостаточна. Процесс мог заново сохранить вчерашнюю копию, и дата на диске обновится, хотя содержимое осталось старым.

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

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

Если результатов несколько, выбери, что считается целым заданием. Утренний отчёт в папке и копия в чате могут быть двумя разными этапами. Если люди берут файл с диска, возможно, файл готов, а доставку стоит отметить отдельным состоянием.

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

| Что увидел наблюдатель | О чём говорит сигнал |
|---|---|
| Старт есть, окончания нет | Возможны зависание, ошибка после старта или сбой отправки сигнала. Проверь время и журнал |
| Нет старта и окончания | Возможно, не сработало расписание, упала машина или не прошёл сам сигнал |
| Окончание есть, период старый | Проверка результата пропустила устаревшие данные |
| Окончание есть, данных за день нет | Это нормальный ноль, если источник ответил и период проверен |
| Файл готов, получатель его не видит | Проверяй доставку отдельно от подготовки |

## Как задать срок без постоянных ложных тревог?

**Главное**

Возьми расписание и время, когда результат впервые нужен людям. Допуск должен вмещать обычные задержки и оставлять время для реакции. Храни время запуска, контрольный срок и часовой пояс отдельно.

Пусть условная выгрузка стартует в 08:00 МСК, обычно готова к 08:12, а встреча начинается в 09:00. Если самый долгий штатный запуск занимает до 25 минут, тревога в 08:10 создаст лишний шум.

Срок 08:35 даёт запас и оставляет время для ручной выгрузки. Это расчёт под конкретный процесс. Возьми реальные длительности из журнала перед тем, как выставлять такой срок на своей задаче.

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

Тогда одиночную ошибку можно оставить в журнале, а тревогу привязать к отсутствию свежего результата к сроку. Такую логику для периодических работ рекомендует документация Prometheus.

В отчёте о сбое назови, за какой период не хватило результата. «Нет запуска с восьми» выглядит странно, если сервер и команда живут в разных часовых поясах. «Нет проверенного отчёта за 11 ноября к 08:35 МСК» позволяет действовать без перевода времени в голове.

Если файл сформировал агент, попроси его открыть результат и назвать проверенный период. Это один из способов [проверить работу в её обычном сценарии](/guides/kak-proveryat-ai-kod-bez-teh-bekgraunda).

## Уведомление для ответственного

**Главное**

Сообщение должно назвать задачу, последний проверенный результат, опоздание, идентификатор прогона при наличии и первое действие ответственного. Длинные журналы лучше открывать отдельно.

«Ошибка автоматизации» заставляет человека угадывать, с чего начать. Пример сообщения:

```text
Утренний отчёт продаж за 11 ноября не готов к 08:35 МСК. Последний проверенный файл за 10 ноября. Старт 08:00 получен, окончания нет.
Проверь чтение источника и статус текущего запуска.
```

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

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

Уровень срочности выбирай по последствиям: пропуск к совещанию отличается от задержки внутренней статистики на вечер. Если это [пилот автоматизации](/guides/pilot-ii-v-kompanii), договорись с владельцем процесса, какие сбои войдут в итог пилота и какие потребуют вмешательства сразу.

**Проверь владельца сигнала**

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

## Как проверить сам мониторинг?

**Главное**

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

Делай проверки на отдельной тестовой задаче. Первый раз не запускай её вовсе и дождись срока. Второй раз отправь старт и оставь процесс без завершения.

В третьем запуске пусть скрипт успешно сохранит файл, но за другой период. Посмотри, считается ли это успехом. Если да, проверь, где ставится отметка: перед проверкой результата или после неё.

Затем проведи обычный успешный запуск. Получатель должен увидеть восстановление, а в результате должен быть правильный период. Отдельно проверь доставку: увидел ли человек сообщение в том канале, которым пользуется в рабочее время.

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

После переноса задач на другую машину или изменения времени повтори проверку пропуска и восстановления. Такой тест показывает, что расписание, отсчёт срока и канал продолжают работать вместе. Команде, которая поручает агентам фоновые задачи, пригодится [программа практикума по ИИ-агентам](https://danashkin.ru/agents/). Для своей задачи зафиксируй проверяемый результат и адресата уведомления.

## Как это выглядит на проверке календаря блога?

**Главное**

Проверка очереди блога предупреждает, если до последней запланированной публикации осталось меньше 48 часов. Если календарь недоступен, приходит отдельное сообщение. Флаг `--dry` выводит текст без отправки.

На моём блоге работает отдельный сторож очереди публикаций. Если публиковать нечего, задача публикации сама об этом не сообщает. Сторож запускается через launchd на рабочем Mac. При выключенном Mac он тоже замолчит. Чтобы обнаружить пропуск запуска, внешний монитор должен ждать сигнал от самого сторожа после проверки.

У сторожа два повода для сообщения. Если календарь удалось прочитать, скрипт проверяет время последней запланированной публикации: при пустом расписании сообщает об этом, а при непустом предупреждает, когда до последнего запланированного выхода меньше 48 часов. При ошибке чтения он прямо сообщает, что календарь не удалось проверить.

Чтобы увидеть, какое сообщение получилось, запусти скрипт с `--dry`. В этом режиме сообщение, если оно сформировано, печатается вместо отправки. Для пробного вывода сводки при полной очереди есть `--dry --test`. Это проверяет чтение и формирование текста, а доставку сообщения нужно проверять отдельно.

Контроль очереди и контроль состоявшейся публикации отвечают на разные вопросы. Для проверки самого выпуска открой ожидаемый адрес после назначенного времени и проверь статус статьи. По той же схеме у утреннего отчёта можно проверить наличие входных данных и отдельно убедиться, что готовый файл появился за нужный период.

Если от сторожа пришло сообщение об ошибке чтения, сначала открой календарь вручную. Если он открывается, ищи сбой в доступе самого скрипта или в формате полученного ответа. Если календарь не открывается и вручную, проверь доступность CMS. Не смешивай этот инцидент с пустой очередью: при недоступном календаре данных о ней пока нет. После восстановления снова запусти проверку с `--dry --test` и сверь число и последнюю публикацию с календарём.

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

**Главное**

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

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

**Нужен ли отдельный сервис для одного отчёта?**

Иногда достаточно независимой проверки свежести файла с отметкой о пропуске. Главное, чтобы проверка не зависела целиком от той же машины и того же запуска.

**Что делать, если опаздывает источник данных?**

Запиши, за какой период источник ответил в последний раз. Выдели состояние «ждём данные» и поставь срок, после которого владелец решит, выпускать ли неполный отчёт.

**Можно считать успехом код завершения процесса?**

Код выхода полезен для диагностики. Для отчёта проверь хотя бы период и наличие результата: процесс может завершиться без ошибки и оставить старый файл.

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

### Источники

- [Мониторинг отсутствующего сигнала и причин, по которым работа не дошла до конца](https://healthchecks.io/docs/monitoring_cron_jobs/)
- [Сигнал старта и измерение времени выполнения](https://healthchecks.io/docs/measuring_script_run_time/)
- [Оповещение по наблюдаемому эффекту и проверка системы оповещений](https://prometheus.io/docs/practices/alerting/)
