/docs/tags/%D0%BF%D0%BE%D0%B4%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BE%D0%BF%D0%BE%D0%B2%D0%B5%D1%89%D0%B5%D0%BD%D0%B8%D0%B9/Recent content in подавление оповещений on Документация Proto Observability PlatformHugo -- gohugo.ioru/docs/alerting/maintenance-windows/Mon, 01 Jan 0001 00:00:00 +0000/docs/alerting/maintenance-windows/ <div class="alert alert-info" role="alert"> <h4 class="alert-heading">Начиная с версии 202</h4> Раздел <strong>Окна обслуживания</strong> доступен начиная с версии 202. </div> <p>На этой странице:</p> <ul> <li><a href="#%d0%b2%d0%b2%d0%b5%d0%b4%d0%b5%d0%bd%d0%b8%d0%b5">Введение</a></li> <li><a href="#%d0%ba%d0%b0%d0%ba-%d0%be%d1%82%d0%ba%d1%80%d1%8b%d1%82%d1%8c">Как открыть</a></li> <li><a href="#%d1%81%d0%bf%d0%b8%d1%81%d0%be%d0%ba-%d0%be%d0%ba%d0%be%d0%bd">Список окон</a></li> <li><a href="#%d1%81%d0%be%d0%b7%d0%b4%d0%b0%d0%bd%d0%b8%d0%b5-%d0%be%d0%ba%d0%bd%d0%b0">Создание окна</a></li> <li><a href="#%d0%be%d0%b1%d0%bb%d0%b0%d1%81%d1%82%d1%8c-%d0%b4%d0%b5%d0%b9%d1%81%d1%82%d0%b2%d0%b8%d1%8f">Область действия</a></li> <li><a href="#%d1%80%d0%b0%d1%81%d0%bf%d0%b8%d1%81%d0%b0%d0%bd%d0%b8%d0%b5">Расписание</a></li> <li><a href="#%d0%bf%d1%80%d0%b5%d0%b4%d0%bf%d1%80%d0%be%d1%81%d0%bc%d0%be%d1%82%d1%80-%d0%be%d1%85%d0%b2%d0%b0%d1%82%d0%b0">Предпросмотр охвата</a></li> <li><a href="#%d1%87%d1%82%d0%be-%d0%bf%d1%80%d0%be%d0%b8%d1%81%d1%85%d0%be%d0%b4%d0%b8%d1%82-%d0%b2%d0%be-%d0%b2%d1%80%d0%b5%d0%bc%d1%8f-%d0%be%d0%ba%d0%bd%d0%b0">Что происходит во время окна</a></li> <li><a href="#%d0%be%d0%ba%d0%bd%d0%b0-%d0%bd%d0%b0-%d0%b3%d1%80%d0%b0%d1%84%d0%b8%d0%ba%d0%b0%d1%85">Окна на графиках</a></li> <li><a href="#%d0%be%d1%82%d0%bc%d0%b5%d0%bd%d0%b0-%d0%b8-%d1%83%d0%b4%d0%b0%d0%bb%d0%b5%d0%bd%d0%b8%d0%b5-%d0%be%d0%ba%d0%bd%d0%b0">Отмена и удаление окна</a></li> <li><a href="#%d0%bf%d1%80%d0%b0%d0%b2%d0%b0-%d0%b4%d0%be%d1%81%d1%82%d1%83%d0%bf%d0%b0">Права доступа</a></li> <li><a href="#%d1%82%d0%b8%d0%bf%d0%b8%d1%87%d0%bd%d1%8b%d0%b5-%d1%81%d1%86%d0%b5%d0%bd%d0%b0%d1%80%d0%b8%d0%b8">Типичные сценарии</a></li> </ul> <h2 id="введение">Введение</h2> <p>Плановые работы — перезапуск сервиса, обновление базы данных, миграция стенда, работы на площадке — выглядят для системы мониторинга так же, как авария: метрики проседают, источники замолкают, правила алертинга срабатывают. Дежурная смена получает поток оповещений, о котором и так знала заранее.</p> <p><strong>Окно обслуживания</strong> — заранее объявленный период работ по конкретным объектам. Пока окно активно, срабатывания по этим объектам <strong>не поднимают инциденты и не рассылаются</strong> по каналам оповещения, но остаются в истории алертов с пометкой <strong>«Обслуживание»</strong> — данные для последующего разбора и аудита не теряются.</p> <h2 id="как-открыть">Как открыть</h2> <p>Главное меню → <strong>Инциденты и алерты</strong> → <strong>Окна обслуживания</strong>.</p> <h2 id="список-окон">Список окон</h2> <p>Таблица со всеми окнами; доступны поиск по названию и фильтр по статусу.</p> <table> <thead> <tr> <th>Колонка</th> <th>Описание</th> </tr> </thead> <tbody> <tr> <td><strong>Название</strong></td> <td>Название окна</td> </tr> <tr> <td><strong>Область действия</strong></td> <td>Сводка объектов, попадающих в окно; при большом числе — «+N ещё»</td> </tr> <tr> <td><strong>Расписание</strong></td> <td><strong>Однократно</strong> с датами начала и окончания либо <strong>Регулярно</strong> с днями недели, временем, длительностью и часовым поясом</td> </tr> <tr> <td><strong>Статус</strong></td> <td><strong>Активно</strong>, <strong>Запланировано</strong>, <strong>Завершено</strong> или <strong>Отменено</strong></td> </tr> <tr> <td><strong>Следующий запуск</strong></td> <td>Ближайшее срабатывание — для регулярных окон</td> </tr> </tbody> </table> <h2 id="создание-окна">Создание окна</h2> <p>Кнопка <strong>Создать окно</strong> открывает форму.</p> <table> <thead> <tr> <th>Поле</th> <th>Описание</th> </tr> </thead> <tbody> <tr> <td><strong>Название</strong></td> <td>Обязательно. Отображается в списке, в пометке подавленного алерта и на графиках</td> </tr> <tr> <td><strong>Описание</strong></td> <td>Необязательно. Здесь удобно указать номер заявки на изменение и ответственного</td> </tr> <tr> <td><strong>Область действия</strong></td> <td>Обязательно. См. <a href="#%d0%be%d0%b1%d0%bb%d0%b0%d1%81%d1%82%d1%8c-%d0%b4%d0%b5%d0%b9%d1%81%d1%82%d0%b2%d0%b8%d1%8f">Область действия</a></td> </tr> <tr> <td><strong>Расписание</strong></td> <td>Обязательно. См. <a href="#%d1%80%d0%b0%d1%81%d0%bf%d0%b8%d1%81%d0%b0%d0%bd%d0%b8%d0%b5">Расписание</a></td> </tr> </tbody> </table> <h2 id="область-действия">Область действия</h2> <p>Область действия описывает, <strong>какие объекты</strong> попадают под подавление. Можно добавить несколько областей — они объединяются по <strong>ИЛИ</strong>.</p> <table> <thead> <tr> <th>Тип области</th> <th>Описание</th> </tr> </thead> <tbody> <tr> <td><strong>Хосты</strong></td> <td>Выбор из обнаруженных хостов</td> </tr> <tr> <td><strong>Сервисы</strong></td> <td>Выбор из известных платформе сервисов</td> </tr> <tr> <td><strong>Группы сервисов</strong></td> <td>Бизнес-приложения; под окно попадают все входящие в группу сервисы</td> </tr> <tr> <td><strong>Расширенный (метки)</strong></td> <td>Условия по меткам алерта: метка, оператор и значение — для нестандартных срезов (окружение, кластер, экземпляр)</td> </tr> </tbody> </table> <p>Правила комбинирования:</p> <ul> <li>Несколько хостов или сервисов <strong>в одной области</strong> — «любой из перечисленных».</li> <li>Условия по меткам <strong>внутри одной области</strong> объединяются по <strong>И</strong>.</li> <li>Разные области объединяются по <strong>ИЛИ</strong>.</li> </ul> <h2 id="расписание">Расписание</h2> <p>Поддерживаются три режима.</p> <h3 id="сейчас">Сейчас</h3> <p>Окно начинается немедленно — режим для незапланированных работ, о которых стало известно в момент начала. Название и область действия задаются как обычно.</p> <h3 id="однократно">Однократно</h3> <p>Разовые работы: указываются <strong>начало</strong> (дата и время) и <strong>длительность в часах</strong>; время окончания сразу показывается под полем. Доступны кнопки-предустановки типовой длительности.</p> <h3 id="регулярно">Регулярно</h3> <p>Повторяющиеся работы: <strong>дни недели</strong> (с предустановками «Будни», «Выходные», «Все дни»), <strong>время начала</strong>, <strong>длительность в минутах</strong>, <strong>часовой пояс</strong> и необязательное поле <strong>Повторять до</strong> — дата окончания серии повторений. Без него серия бессрочна.</p> <div class="alert alert-info" role="alert"> <h4 class="alert-heading">Часовой пояс</h4> Расписание регулярного окна считается в выбранном часовом поясе, а не в поясе браузера и не в UTC. Для распределённых площадок это принципиально: окно «02:00 будни» должно означать ночь на площадке, а не в другом регионе. </div> <h2 id="предпросмотр-охвата">Предпросмотр охвата</h2> <p>Ещё до сохранения формы под областью действия показывается строка вида:</p> <blockquote> <p>Под окно попадёт 14 алертов (3 активных) из 250 за 24 ч</p> </blockquote> <p>Это оценка по фактическим срабатываниям за последние сутки: сколько алертов заглушило бы такое окно. Список можно раскрыть и посмотреть конкретные алерты и их состояние («активен» / «снят»).</p> <p>Предпросмотр закрывает главный риск неверно заданной области: слишком широкая область заглушит лишнее, слишком узкая — не заглушит ничего. Если строка сообщает, что <strong>совпадений не найдено</strong>, область почти наверняка задана неверно.</p> <h2 id="что-происходит-во-время-окна">Что происходит во время окна</h2> <p>Пока окно активно, для попавших в область объектов:</p> <ul> <li>Срабатывания <strong>не создают инциденты</strong>.</li> <li>Оповещения <strong>не отправляются</strong> ни по одному каналу (email, Telegram, вебхуки и др.).</li> <li>Срабатывания <strong>записываются в историю алертов</strong> с пометкой <strong>«Обслуживание»</strong>; в карточке алерта видно, каким именно окном вызвано подавление.</li> <li>Правила <a href="../#%d0%be%d0%b1%d0%bd%d0%b0%d1%80%d1%83%d0%b6%d0%b5%d0%bd%d0%b8%d0%b5-%d0%bf%d1%80%d0%be%d0%bf%d0%b0%d0%b4%d0%b0%d0%bd%d0%b8%d1%8f-%d0%b4%d0%b0%d0%bd%d0%bd%d1%8b%d1%85-no-data">обнаружения пропадания данных (No-Data)</a> не поднимают оповещений: остановленный на время работ источник — ожидаемое молчание, а не сбой.</li> </ul> <p>Объекты вне области действия окна обрабатываются как обычно — окно на одном сервисе не глушит остальную инсталляцию.</p> <h2 id="окна-на-графиках">Окна на графиках</h2> <p>Активные и запланированные окна отображаются полосой на графиках дашбордов вместе с <a href="../../guides/event_markers/">отметками изменений</a> — релизами и развёртываниями. Регулярные окна показываются на весь период повторений в пределах видимого интервала времени.</p> <p>Это снимает типовой вопрос при разборе: «провал на графике — это авария или плановые работы?». Ответ виден на самом графике, без перехода в другой раздел.</p> <h2 id="отмена-и-удаление-окна">Отмена и удаление окна</h2> <ul> <li><strong>Отменить окно</strong> — прекращает текущее или ближайшее срабатывание. Само окно сохраняется в списке со статусом <strong>Отменено</strong>; для регулярного окна серия повторений продолжается со следующего срабатывания.</li> <li><strong>Удалить</strong> — удаляет окно целиком. Если окно было активно, подавление прекращается немедленно.</li> </ul> <p>Отмену стоит предпочитать удалению: она сохраняет след того, что работы планировались.</p> <h2 id="права-доступа">Права доступа</h2> <p>Раздел управляется RBAC-ресурсом <strong>«Окна обслуживания»</strong> (<code>maintenance_window</code>). Пользователи без права просмотра раздел не видят.</p> <p>Создание, изменение, отмена и удаление окон фиксируются в <a href="../../guides/rbac_admin/#%d0%b6%d1%83%d1%80%d0%bd%d0%b0%d0%bb-%d0%b0%d1%83%d0%b4%d0%b8%d1%82%d0%b0">журнале аудита</a> с состоянием «до» и «после» — видно, кто и как менял область действия или расписание.</p> <h2 id="типичные-сценарии">Типичные сценарии</h2> <ul> <li><strong>Ночной регламент базы данных.</strong> Регулярное окно «Будни, 02:00, 90 минут» с областью «Хосты» по узлам СУБД — ночные перезапуски не поднимают дежурную смену.</li> <li><strong>Релиз сервиса.</strong> Окно «Сейчас» длительностью в час с областью «Сервисы» на выкатываемый сервис — всплески ошибок на время выкатки остаются в истории, но не создают инцидент.</li> <li><strong>Работы на площадке.</strong> Однократное окно с областью «Группы сервисов» на бизнес- приложение — заглушается всё приложение целиком, перечислять хосты не требуется.</li> <li><strong>Разбор постфактум.</strong> История алертов с фильтром по пометке «Обслуживание» показывает, что происходило во время работ, — полезно, если после регламента осталась деградация.</li> </ul> <h2 id="см-также">См. также</h2> <ul> <li><a href="../configuration/">Настройка оповещений</a> — каналы, политики и правила алертинга.</li> <li><a href="../viewing-alerts/">Просмотр алертов и событий</a> — история алертов, где видны подавленные срабатывания.</li> <li><a href="../incidents/">Инциденты</a> — корреляция алертов в инциденты.</li> <li><a href="../../guides/event_markers/">Отметки событий</a> — релизы и изменения на графиках рядом с окнами обслуживания.</li> </ul>