Zabbix maintenance: окна без ночных тревог
Москва, Щёлковское шоссе, д. 92, корп. 7 · Пн–Пт 9:00–19:00 · +7 903 729-62-41
АйТи Фреш
Linux, Docker и DevOps

Ночью бэкап и перезагрузка — Zabbix молчит: настройка окон обслуживания без потери данных

Автор: , директор ООО «АйТи-Фреш» · · ~12 мин чтения
Серверная комната ночью, часы 02:00, красный сигнал тревоги гаснет, появляется зеленая галочка, символ wrench.
Окна обслуживания превращают ночные тревоги в спокойный сон.

Чтобы Zabbix не будил вас ночью из-за плановой перезагрузки, используйте периоды обслуживания (maintenance). Они подавляют проблемы в заданное время, сохраняя историю или отключая запись. Я покажу, как настроить daily/weekly окна, использовать теги для точечного подавления и автоматизировать процесс через API, чтобы не терять данные о сбоях.

Почему Zabbix кричит ночью и как это мешает работе

Представьте: мониторинг настроен идеально. Но каждую ночь в 02:00 запускается бэкап или обновление. Сервер недоступен пару минут, службы останавливаются. Zabbix видит это как аварию и шлет уведомление. Утром — три десятка писем об одном событии. Через неделю уведомления уходят в спам, и вы перестаете реагировать даже на реальные сбои. Классический «крик волка», убивающий доверие к системе. Это не фича, это баг вашей логики.

В компании «Северный ларёк», торговой фирме с 24 рабочими местами, была именно эта боль. Ночью файловый сервер уходил в перезагрузку для бэкапа. Администратор получал вал: «Сервер недоступен», «SMB не отвечает», «Диск заполнен». Он пытался игнорировать их вручную, но это не работало системно. Проблема не в падении сервера — он падал по плану. Проблема в том, что Zabbix не знал об этом плане. Мы внедрили окна обслуживания (maintenance periods), чтобы система знала, когда молчать, а когда бить тревогу. Результат: тишина в почтовом ящике и спокойствие в голове.

Я помню, как админ «Северного ларёка» показывал мне папку «Входящие» с тысячами дублей. «Это нормально, привыкли», — сказал он. Я привыкать не стал. Мы настроили maintenance, и шум прекратился. Проще простого, если знать, куда нажать. Не нужно быть хакером, нужно просто понимать инструмент. Maintenance в Zabbix 7.0 — это механизм подавления проблем в заранее определённые временные интервалы для конкретных хостов или групп хостов. Это не просто «выключить звук», это интеллектуальное управление состоянием системы.

Важно: если вы просто отключите уведомления, вы потеряете контекст. Окна обслуживания — это не глушитель, это управление ситуацией.
Обратите внимание: Почему Zabbix кричит ночью и как это мешает работе — схема
Обратите внимание: Почему Zabbix кричит ночью и как это мешает работе. Открыть схему в полном размере

Два типа окон: с данными и без них

В Zabbix 7.0 есть два принципиально разных типа периодов обслуживания. Первый — «With data collection» (с сбором данных). Zabbix принимает данные, триггеры срабатывают, события создаются. Но если в Действии (Action) включена опция «Pause operations for suppressed problems», уведомления и удаленные команды не отправляются. Идеально для плановых перезагрузок: вы видите пропажу данных на графике, но телефон не звонит. Если проблема возникла внутри окна обслуживания, recovery-сообщение не отправится, даже после окончания окна, если проблема разрешилась внутри него. Это золотая середина для большинства сценариев.

Второй тип — «No data collection» (без сбора данных). Zabbix принимает данные, но не сохраняет их в базу. Триггеры не срабатывают вообще, включая те, что зависят от отсутствия данных (nodata()). Полезно при замене диска или миграции, когда данные ложны. Но помните: после окончания такого окна триггеры nodata() начнут ждать следующего периода проверки, а не сработают мгновенно. Для большинства офисных задач я рекомендую первый вариант: сохранять историю, но не пугать людей. История — это ваша страховка, не выбрасывайте её на ветер.

В «Северный ларёк» мы выбрали вариант с сбором данных. Нам было важно видеть, сколько времени заняла перезагрузка. Если бы мы выбрали режим без данных, график загрузки диска остался бы пустым, что вызвало бы вопросы при аудите. Я всегда говорю: история — это ваша страховка. Не выбрасывайте её на ветер. Пустой график выглядит подозрительно, даже если причина понятна. Сервер и прокси всегда собирают данные; при режиме «No data collection» сервер просто игнорирует полученные значения, но агент всё равно их шлёт. Значения с метками времени, присланные в этот период, отбрасываются, а значения за истёкший период принимаются.

Осторожно: сервер Zabbix всегда собирает данные. Режим «No data collection» означает, что сервер игнорирует полученные значения, но агент всё равно их шлёт.
Ночью бэкап и перезагрузка — Zabbix молчит: настройка окон обслуживания без потери данных — схема
Схема к статье. Открыть схему в полном размере

Настройка периодов: расписание и охват

Создание окна начинается в разделе 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 игнорирует мои правки. Терпение — добродетель, особенно когда ты админ. При смене летнего времени длительность окна не меняется. Если окно начинается в пропущенный час, оно не стартует.

При смене летнего времени длительность окна не меняется. Если окно начинается в пропущенный час, оно не стартует.
Цифры и версии: Настройка периодов: расписание и охват — схема
Цифры и версии: Настройка периодов: расписание и охват. Открыть схему в полном размере

Теги и точечное подавление проблем

Иногда нужно отключить уведомления не для всего сервера, а только для конкретной услуги. Например, при обновлении 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.

Проверьте регистр букв в тегах. Zabbix чувствителен к нему, и Service:MySQL не совпадет с service:mysql.

Автоматизация через 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 maintenance.update полностью перезаписывает списки хостов и групп. Не забудьте вернуть теги, если обновляете существующее окно.
Если вы не хотите возиться с API и скриптами, мы можем настроить окна обслуживания под ваши процессы за 1 час. Это стоит от 7 000 ₽ в рамках абонентского обслуживания или как разовая услуга. Обсудить задачу
Цифры и версии: Автоматизация через API: окна под скрипты обновлений — схема
Цифры и версии: Автоматизация через API: окна под скрипты обновлений. Открыть схему в полном размере

Отличие от подавления (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, уведомление будет отправлено. Следите за составом хостов в триггере.

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

Как настроить 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'.

Столкнулись с похожей задачей? Обращайтесь — решим

Если у вас происходит что-то из описанного в этой статье — или любая другая проблема с ИТ-инфраструктурой, — обращайтесь в любое время. Мои специалисты и я лично разберём ситуацию, найдём настоящую причину и доведём до решения.

Возьмёмся и за разовую задачу, и за постоянное обслуживание. Первичная консультация — бесплатно и без обязательств.

📞 +7 903 729-62-41 ✈ Telegram @ITfresh_Boss

С уважением, Семёнов Евгений Сергеевич, директор «АйТи Фреш» — IT-аутсорсинг для компаний до 50 рабочих мест, 15+ лет практики

Источники

© ООО «АйТи-Фреш» · Москва · Все статьи
АйТи-Фреш (ООО «АЙТИ-ФРЕШ») · г. Москва, Щёлковское шоссе, д. 92, корп. 7 · +7 903 729-62-41 · info@itfresh.ru · Пн–Пт 9:00–19:00