Ночью бэкап и перезагрузка — Zabbix молчит: настройка окон обслуживания без потери данных
Чтобы Zabbix не будил вас ночью из-за плановой перезагрузки, используйте периоды обслуживания (maintenance). Они подавляют проблемы в заданное время, сохраняя историю или отключая запись. Я покажу, как настроить daily/weekly окна, использовать теги для точечного подавления и автоматизировать процесс через API, чтобы не терять данные о сбоях.
Почему Zabbix кричит ночью и как это мешает работе
Представьте: мониторинг настроен идеально. Но каждую ночь в 02:00 запускается бэкап или обновление. Сервер недоступен пару минут, службы останавливаются. Zabbix видит это как аварию и шлет уведомление. Утром — три десятка писем об одном событии. Через неделю уведомления уходят в спам, и вы перестаете реагировать даже на реальные сбои. Классический «крик волка», убивающий доверие к системе. Это не фича, это баг вашей логики.
В компании «Северный ларёк», торговой фирме с 24 рабочими местами, была именно эта боль. Ночью файловый сервер уходил в перезагрузку для бэкапа. Администратор получал вал: «Сервер недоступен», «SMB не отвечает», «Диск заполнен». Он пытался игнорировать их вручную, но это не работало системно. Проблема не в падении сервера — он падал по плану. Проблема в том, что Zabbix не знал об этом плане. Мы внедрили окна обслуживания (maintenance periods), чтобы система знала, когда молчать, а когда бить тревогу. Результат: тишина в почтовом ящике и спокойствие в голове.
Я помню, как админ «Северного ларёка» показывал мне папку «Входящие» с тысячами дублей. «Это нормально, привыкли», — сказал он. Я привыкать не стал. Мы настроили maintenance, и шум прекратился. Проще простого, если знать, куда нажать. Не нужно быть хакером, нужно просто понимать инструмент. Maintenance в Zabbix 7.0 — это механизм подавления проблем в заранее определённые временные интервалы для конкретных хостов или групп хостов. Это не просто «выключить звук», это интеллектуальное управление состоянием системы.
Два типа окон: с данными и без них
В Zabbix 7.0 есть два принципиально разных типа периодов обслуживания. Первый — «With data collection» (с сбором данных). Zabbix принимает данные, триггеры срабатывают, события создаются. Но если в Действии (Action) включена опция «Pause operations for suppressed problems», уведомления и удаленные команды не отправляются. Идеально для плановых перезагрузок: вы видите пропажу данных на графике, но телефон не звонит. Если проблема возникла внутри окна обслуживания, recovery-сообщение не отправится, даже после окончания окна, если проблема разрешилась внутри него. Это золотая середина для большинства сценариев.
Второй тип — «No data collection» (без сбора данных). Zabbix принимает данные, но не сохраняет их в базу. Триггеры не срабатывают вообще, включая те, что зависят от отсутствия данных (nodata()). Полезно при замене диска или миграции, когда данные ложны. Но помните: после окончания такого окна триггеры nodata() начнут ждать следующего периода проверки, а не сработают мгновенно. Для большинства офисных задач я рекомендую первый вариант: сохранять историю, но не пугать людей. История — это ваша страховка, не выбрасывайте её на ветер.
В «Северный ларёк» мы выбрали вариант с сбором данных. Нам было важно видеть, сколько времени заняла перезагрузка. Если бы мы выбрали режим без данных, график загрузки диска остался бы пустым, что вызвало бы вопросы при аудите. Я всегда говорю: история — это ваша страховка. Не выбрасывайте её на ветер. Пустой график выглядит подозрительно, даже если причина понятна. Сервер и прокси всегда собирают данные; при режиме «No data collection» сервер просто игнорирует полученные значения, но агент всё равно их шлёт. Значения с метками времени, присланные в этот период, отбрасываются, а значения за истёкший период принимаются.
- With data collection: события создаются, уведомления паузируются, история сохраняется.
- No data collection: данные не пишутся, триггеры не срабатывают, график пустой.
- Выбор зависит от задачи: скрыть шум или исключить мусор из базы.
Настройка периодов: расписание и охват
Создание окна начинается в разделе Data collection > Maintenance. Укажите название, тип, время начала (Active since) и конца (Active till). Просто указать время недостаточно — нужно нажать кнопку «Add» в блоке Periods и задать паттерн. Доступны типы: One time only, Daily, Weekly, Monthly. Для ежедневного окна указываете интервал, время старта и длительность. Для еженедельного — день недели, время и длительность. Recurring-периоды работают в часовом поясе сервера Zabbix, одноразовые — в часовом поясе пользователя. Ошибка в часовом поясе — классическая причина того, что окно не срабатывает, когда нужно.
В «Северный ларёк» нам нужно было ежедневное окно с 02:00 до 02:30. Создали период типа Daily, установили «Every 1 day», старт 02:00, длительность 30 минут. В поле Host groups указали группу файлового сервера. Обратите внимание: включение вложенных групп работает автоматически при выборе родительской группы. Если вы укажете родительскую группу, все вложенные хосты попадут в окно. Если ошибетесь и добавите группу «Все серверы» без фильтрации, ночью замолчит весь парк. Лучше создавать отдельные группы для хостов, требующих обслуживания, или использовать теги. Одна лишняя группа в списке может привести к тому, что вы не узнаете о реальном взломе.
Изменения в окнах применяются не мгновенно. Процесс timer проверяет состояние на 0-й секунде каждой минуты. Если вы добавили хост в активное окно, он попадет в него в начале следующей минуты. Также изменения вступают в силу после синхронизации кэша конфигурации (по умолчанию каждые 10 секунд). Не ждите мгновенного эффекта при редактировании активного окна. Я сам однажды пытался «починить» окно на ходу и полминуты смотрел, как Zabbix игнорирует мои правки. Терпение — добродетель, особенно когда ты админ. При смене летнего времени длительность окна не меняется. Если окно начинается в пропущенный час, оно не стартует.
- Путь: Data collection > Maintenance > Create maintenance period.
- Обязательно добавьте период (Periods), иначе окно не активируется.
- Recurring-периоды используют часовой пояс сервера.
Теги и точечное подавление проблем
Иногда нужно отключить уведомления не для всего сервера, а только для конкретной услуги. Например, при обновлении MySQL Zabbix должен молчать про базу, но кричать, если упал веб-сервер. Для этого в окне обслуживания задаются теги (Tags). В интерфейсе теги доступны только для типа «With data collection». Однако через API теги можно задать независимо от типа окна, если вы знаете, что делаете. Можно указать операторы Contains (подстрока) или Equals (точное совпадение) для имени и значения тега. Имена тегов чувствительны к регистру. Если теги не заданы, подавляются все проблемы хостов в окне, но только если тип maintenance «With data collection». Логика расчета: условия объединяются через AND/OR. Это мощный инструмент, если уметь им пользоваться.
В «Северный ларёк» мы использовали теги для разделения мониторинга. Триггеры имели теги service:mysql и service:web. В окне обслуживания указали тег service:mysql с оператором Equals. Когда база перезапускалась, уведомлений не было. Если бы упал Apache, админ получил бы алерт немедленно. Это позволяет сохранить контроль над критической инфраструктурой. Без тегов пришлось бы либо молчать совсем, либо получать шум. Выбор за вами, но я рекомендую теги. Они дают хирургическую точность.
Я видел, как новички пишут Service:MySQL вместо service:mysql. Zabbix не прощает ошибок регистров. Проверьте теги дважды, иначе ваше «тихое окно» станет громким. Регистр важен, как в коде, так и в конфиге мониторинга. Не ленитесь проверять, иначе придется объяснять заказчику, почему база молчала, а веб-сервер орал. Условия с одним именем тегов группируются через OR, а разные имена — через AND.
- Теги доступны только для типа With data collection в UI.
- Операторы: Contains (подстрока) и Equals (точное совпадение).
- Если теги не заданы, подавляются ВСЕ проблемы хоста.
Автоматизация через API: окна под скрипты обновлений
Иногда расписание неизвестно заранее. Обновление может занять 10 минут или 2 часа. Статическое окно не подойдет. Здесь на помощь приходит Zabbix API. Скрипт обновления может создать окно непосредственно перед работами и удалить его после. Метод maintenance.create требует указать maintenance_type (0 — с данными, 1 — без), active_since и active_till (в Unix timestamp, округляются до минуты), а также массив timeperiods. Для одноразового окна (timeperiod_type 0) нужно указать start_date (секунды от эпохи) и period (длительность в секундах). Это позволяет гибко управлять процессом без участия человека.
Пример вызова: скрипт генерирует текущее время и добавляет ожидаемую длительность. Формирует JSON-запрос к endpoint /api_jsonrpc.php с методом maintenance.create. Авторизация осуществляется через заголовок Authorization: Bearer <token>. Параметр auth в теле запроса считается устаревшим (deprecated) в Zabbix 7.0, хотя технически может работать, но полагаться на него не стоит. После завершения работ скрипт вызывает maintenance.delete, передавая ID созданного окна. При обновлении окна (maintenance.update) параметры groups, hosts, timeperiods и tags полностью заменяют старые значения. Если забудете передать теги при обновлении, они исчезнут. Поэтому для одноразовых окон лучше сразу создавать и удалять их. API — это не магия, это просто код, который делает рутину за вас.
В «Северный ларёк» мы внедрили bash-скрипт перед apt upgrade. Он создает окно на 60 минут, выполняет обновление и удаляет окно. Если обновление затянулось, админ может вручную продлить окно. Это исключило ложные срабатывания. Автоматизация — это не магия, это просто дисциплина. Я не люблю писать скрипты, но здесь без них не обойтись. Лучше потратить час на скрипт, чем тратить месяцы на разбор ложных тревог. Помните, что duration (period) в API указывается в секундах, а не минутах.
- API endpoint: /api_jsonrpc.php, метод POST.
- Авторизация: Authorization: Bearer <token>; параметр auth в теле запроса deprecated.
- maintenance_type: 0 (с данными), 1 (без данных).
- active_since и active_till обязательны, округляются до минуты.
Отличие от подавления (Suppression) и нюансы действий
Не путайте окна обслуживания (Maintenance) с подавлением проблемы (Suppression). Suppression — это ручное или программное действие над конкретным событием. Можно сделать через интерфейс или API event.acknowledge с битовой маской 32 (suppress). При этом можно указать срок подавления (suppress_until). Maintenance работает глобально для хоста или группы по расписанию. Если хост в maintenance, все его проблемы считаются подавленными, и операции эскалации приостанавливаются, если включена опция в Действии. Разница в масштабе: одно событие против целого периода.
В настройках Действия есть галочка «Pause operations for suppressed problems». Если она включена, все шаги эскалации пропустятся на время окна. Если выключена — уведомления будут приходить даже во время maintenance. Важно уточнить: эта опция влияет только на операции эскалации, а не на recovery-уведомления. Recovery-уведомления не отправляются, если проблема возникла внутри окна, независимо от этой галочки. Есть условие «Problem is suppressed», которое можно использовать в логике Действий. Но помните: suppression работает и для одиночных событий, и для maintenance, механизм приостановки операций общий. Настройка действий — это финальный штрих, без которого окно бесполезно.
Если хотя бы один хост в выражении триггера не в maintenance, уведомление будет отправлено. Следите за составом хостов в триггере. Я часто вижу, как триггеры срабатывают на «здоровые» хосты, потому что один из группы ушел в maintenance, а другой — нет. Это не баг, это логика. Zabbix честен: если кто-то кричит, он услышит. Проверьте свои триггеры, чтобы избежать сюрпризов.
- Maintenance: глобальное окно по расписанию для хостов/групп.
- Suppression: точечное подавление конкретного события на срок.
- Опция Pause operations нужна для отключения уведомлений в окне (только эскалации).
Частые вопросы
Как настроить Zabbix, чтобы не шло уведомление при перезагрузке?
Создайте период обслуживания (Maintenance) типа Daily или Weekly в разделе Data collection > Maintenance, укажите время перезагрузки и группу хостов. Выберите тип 'With data collection' и включите 'Pause operations' в Действиях.
Сохраняются ли данные в Zabbix во время maintenance?
Да, если выбран тип 'With data collection'. Данные сохраняются, триггеры срабатывают, но уведомления блокируются. При типе 'No data collection' данные не пишутся.
Можно ли создать окно обслуживания через API?
Да, используя метод maintenance.create. Нужно указать active_since, active_till, массив timeperiods и список хостов или групп.
Что делать, если обновление заняло больше времени, чем окно?
Расширьте окно вручную через интерфейс или настройте скрипт, который продлевает окно через API, если процесс еще идет.
Как отключить уведомления только для базы данных?
Используйте теги в окне обслуживания. Укажите тег, присвоенный триггерам базы данных, и выберите тип 'With data collection'.
Источники
- Zabbix Documentation 7.0: Maintenance — Официальная документация по настройке периодов обслуживания, типам сбора данных и работе с тегами. URL: https://www.zabbix.com/documentation/7.0/ru/manual/configure/maintenance
- Zabbix API Reference: maintenance object — Справочник API для методов maintenance.create, maintenance.update, maintenance.delete. URL: https://www.zabbix.com/documentation/7.0/ru/manual/api/reference/maintenance/object
- Zabbix Configuration: Action operations — Настройка операций в действиях, включая паузу для подавленных проблем. URL: https://www.zabbix.com/documentation/7.0/ru/manual/configure/actions/operations
- Zabbix API Reference: event.acknowledge — Метод API для подтверждения и подавления событий. URL: https://www.zabbix.com/documentation/7.0/ru/manual/api/reference/event/acknowledge
