/docs/tags/burn-rate/ Recent content in burn rate on Документация Proto Observability Platform Hugo -- gohugo.io ru /docs/guides/slo/ Mon, 01 Jan 0001 00:00:00 +0000 /docs/guides/slo/ <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%BB%D1%8E%D1%87%D0%B5%D0%B2%D1%8B%D0%B5-%D0%BF%D0%BE%D0%BD%D1%8F%D1%82%D0%B8%D1%8F">Ключевые понятия</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-slo">Список SLO</a></li> <li><a href="#%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5-slo">Создание SLO</a></li> <li><a href="#%D0%B4%D0%B5%D1%82%D0%B0%D0%BB%D0%B8-slo">Детали SLO</a></li> <li><a href="#%D0%B0%D0%B2%D1%82%D0%BE%D0%BC%D0%B0%D1%82%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%B8%D0%B5-%D0%B0%D0%BB%D0%B5%D1%80%D1%82%D1%8B-%D0%BF%D0%BE-slo">Автоматические алерты по SLO</a></li> <li><a href="#%D0%BE%D1%82%D1%87%D1%91%D1%82-%D0%BE-%D1%81%D0%BE%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D1%81%D1%82%D0%B2%D0%B8%D0%B8-slo">Отчёт о соответствии SLO</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> </ul> <h2 id="введение">Введение</h2> <p><strong>SLO (Service Level Objectives)</strong> — раздел платформы Proto Observability для формального определения и отслеживания целей уровня обслуживания. С его помощью команды могут:</p> <ul> <li><strong>Формализовать цели надёжности</strong> — задать минимально допустимые уровни доступности и времени отклика для сервисов и операций.</li> <li><strong>Отслеживать соответствие</strong> — видеть текущий процент соответствия (compliance) и оставшийся бюджет ошибок в любой момент.</li> <li><strong>Управлять инцидентами по данным</strong> — получать алерты о быстром или медленном сжигании бюджета ошибок до того, как цель окажется недостижимой.</li> <li><strong>Отчитываться перед бизнесом</strong> — формировать отчёты о соответствии за произвольный период времени.</li> </ul> <div class="alert alert-info" role="alert"> <h4 class="alert-heading">Версия</h4> Данный функционал доступен начиная с версии 200. </div> <hr> <h2 id="ключевые-понятия">Ключевые понятия</h2> <table> <thead> <tr> <th>Термин</th> <th>Описание</th> </tr> </thead> <tbody> <tr> <td><strong>SLI</strong> (Service Level Indicator)</td> <td>Измеряемый показатель — например, доля успешных запросов или время отклика</td> </tr> <tr> <td><strong>SLO</strong> (Service Level Objective)</td> <td>Целевое значение SLI, например «99,5% успешных запросов за последние 30 дней»</td> </tr> <tr> <td><strong>Error Budget</strong> (бюджет ошибок)</td> <td>Сколько «плохих» событий допустимо, чтобы не нарушить SLO — равен <code>1 − SLO</code> от общего объёма</td> </tr> <tr> <td><strong>Compliance Window</strong> (окно соответствия)</td> <td>Период, за который вычисляется соответствие: катящееся окно (например, последние 30 дней) или календарное (например, текущий месяц)</td> </tr> <tr> <td><strong>Burn Rate</strong> (скорость сжигания)</td> <td>Во сколько раз быстрее обычного расходуется бюджет ошибок</td> </tr> </tbody> </table> <hr> <h2 id="как-открыть">Как открыть</h2> <p>Перейдите в раздел <strong>Алерты</strong> &gt; <strong>SLO</strong> в основном меню навигации платформы.</p> <!-- TODO: confirm menu path --> <hr> <h2 id="список-slo">Список SLO</h2> <p>Страница списка отображает все SLO, определённые в платформе.</p> <!-- TODO: screenshot --> <p><strong>Столбцы таблицы:</strong></p> <table> <thead> <tr> <th>Столбец</th> <th>Описание</th> </tr> </thead> <tbody> <tr> <td><strong>Имя</strong></td> <td>Название SLO</td> </tr> <tr> <td><strong>Сервис</strong></td> <td>Сервис, к которому относится SLO</td> </tr> <tr> <td><strong>Тип</strong></td> <td>Доступность (availability) или Время отклика (latency)</td> </tr> <tr> <td><strong>Цель</strong></td> <td>Целевое значение в процентах (например, 99.5%)</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> <tr> <td><strong>Владелец</strong></td> <td>Ответственная команда или сотрудник</td> </tr> </tbody> </table> <p><strong>Возможности таблицы:</strong></p> <ul> <li>Поиск по имени SLO;</li> <li>Фильтрация по сервису, типу и владельцу;</li> <li>Сортировка по столбцам;</li> <li>Кнопка <strong>Создать SLO</strong> для добавления новой цели.</li> </ul> <hr> <h2 id="создание-slo">Создание SLO</h2> <p>Форма создания SLO состоит из нескольких блоков.</p> <!-- TODO: screenshot --> <p><strong>Основные параметры:</strong></p> <table> <thead> <tr> <th>Поле</th> <th>Описание</th> <th style="text-align:center">Обязательное</th> </tr> </thead> <tbody> <tr> <td><strong>Имя SLO</strong></td> <td>Уникальное название, например <code>payment-api-availability-99-5</code></td> <td style="text-align:center">Да</td> </tr> <tr> <td><strong>Описание</strong></td> <td>Пояснение назначения SLO</td> <td style="text-align:center">Нет</td> </tr> <tr> <td><strong>Сервис</strong></td> <td>Сервис, для которого определяется SLO</td> <td style="text-align:center">Да</td> </tr> <tr> <td><strong>Владелец</strong> (owner)</td> <td>Команда или сотрудник — ответственное лицо</td> <td style="text-align:center">Да</td> </tr> <tr> <td><strong>Теги</strong> (labels)</td> <td>Произвольные метки, которые прокинутся в алерты</td> <td style="text-align:center">Нет</td> </tr> </tbody> </table> <p><strong>Тип SLI:</strong></p> <table> <thead> <tr> <th>Тип</th> <th>Что измеряется</th> <th>Пример цели</th> </tr> </thead> <tbody> <tr> <td><strong>Доступность</strong> (availability)</td> <td>Доля успешных запросов (без серверных ошибок)</td> <td>99.5% запросов без ошибок</td> </tr> <tr> <td><strong>Время отклика</strong> (latency)</td> <td>Доля запросов, время выполнения которых не превышает порог</td> <td>95% запросов быстрее 300 мс</td> </tr> </tbody> </table> <p>Для SLO по времени отклика платформа автоматически предлагает порог (threshold) на основе исторических данных — его можно скорректировать вручную.</p> <p><strong>Окно соответствия:</strong></p> <table> <thead> <tr> <th>Тип окна</th> <th>Описание</th> </tr> </thead> <tbody> <tr> <td><strong>Катящееся</strong> (rolling)</td> <td>Окно «последние N дней» — соответствие всегда считается за скользящий период</td> </tr> <tr> <td><strong>Календарное</strong> (calendar)</td> <td>Фиксированные календарные периоды: неделя, месяц, квартал</td> </tr> </tbody> </table> <p>Доступные длины окна: 7 дней, 14 дней, 28 / 30 дней, 90 дней.</p> <p><strong>Предпросмотр SLI:</strong></p> <p>Под формой отображается график SLI за текущее окно с наложенной областью порога. Это позволяет убедиться, что выбранный порог реалистичен до сохранения SLO.</p> <p>После заполнения всех обязательных полей нажмите <strong>Сохранить</strong>. Правила алертинга по скорости сжигания бюджета генерируются автоматически при создании SLO.</p> <hr> <h2 id="детали-slo">Детали SLO</h2> <p>Страница деталей открывается при переходе по имени SLO в списке.</p> <!-- TODO: screenshot --> <p><strong>Индикатор соответствия (Compliance Gauge)</strong></p> <p>Карточка в верхней части страницы отображает текущий процент соответствия с цветовой индикацией:</p> <table> <thead> <tr> <th>Зона</th> <th>Цвет</th> <th>Условие</th> </tr> </thead> <tbody> <tr> <td><strong>Норма</strong></td> <td>Зелёный</td> <td>Соответствие выше целевого значения, бюджет расходуется в пределах допустимого</td> </tr> <tr> <td><strong>Предупреждение</strong></td> <td>Жёлтый</td> <td>Бюджет расходуется быстрее среднего темпа</td> </tr> <tr> <td><strong>Критическое</strong></td> <td>Красный</td> <td>Бюджет близок к исчерпанию или SLO уже нарушен</td> </tr> </tbody> </table> <p><strong>Карточки скорости сжигания (Burn Rate)</strong></p> <p>Две карточки показывают текущую скорость сжигания бюджета за короткий и длинный интервалы:</p> <ul> <li><strong>Быстрое сжигание (1 час)</strong> — мониторит внезапные всплески ошибок;</li> <li><strong>Медленное сжигание (6 часов)</strong> — помогает выявить постепенную деградацию.</li> </ul> <p>Цвет карточки меняется в зависимости от значения скорости (норма / предупреждение / критическое).</p> <p><strong>График сжигания бюджета (Burn-down Chart)</strong></p> <p>Показывает, как расходовался бюджет ошибок с начала окна соответствия. Линия идёт вниз по мере потребления бюджета — при штатной работе она должна оставаться выше диагонали равномерного расхода.</p> <p><strong>График SLI</strong></p> <p>Линейный график текущего значения SLI за окно соответствия с наложенной целевой линией. Для SLO времени отклика доступно переключение между перцентилями <strong>P50 / P90 / P95 / P99</strong>.</p> <hr> <h2 id="автоматические-алерты-по-slo">Автоматические алерты по SLO</h2> <p>При создании SLO платформа автоматически формирует четыре правила алертинга (vmalert) из шаблонов:</p> <table> <thead> <tr> <th>Алерт</th> <th>Условие</th> <th>Назначение</th> </tr> </thead> <tbody> <tr> <td><strong>Быстрое сжигание</strong></td> <td>Скорость сжигания &gt; 14.4× за последний 1 час</td> <td>Предупреждает о внезапной деградации — при такой скорости бюджет исчерпается за 2 часа</td> </tr> <tr> <td><strong>Медленное сжигание</strong></td> <td>Скорость сжигания &gt; 6× за последние 6 часов</td> <td>Выявляет устойчивую деградацию до полного исчерпания бюджета</td> </tr> <tr> <td><strong>Контроль объёма</strong> (volume guard)</td> <td>Резкое падение количества событий</td> <td>Защита от ложноотрицательных — при малом трафике метрика SLI может давать некорректные значения</td> </tr> <tr> <td><strong>Исчерпание бюджета</strong></td> <td>Остаток бюджета ≤ 0</td> <td>Сигнализирует о нарушении SLO</td> </tr> </tbody> </table> <p>Метки <code>owner</code> и произвольные теги, заданные при создании SLO, автоматически прокидываются в алерты — это позволяет маршрутизировать оповещения нужным командам.</p> <div class="alert alert-info" role="alert"> <h4 class="alert-heading">Редактирование правил</h4> Правила алертинга, сгенерированные по SLO, нельзя редактировать напрямую. Для изменения условий скорректируйте параметры SLO — правила будут перегенерированы автоматически. </div> <hr> <h2 id="отчёт-о-соответствии-slo">Отчёт о соответствии SLO</h2> <p>Раздел <strong>Алерты</strong> &gt; <strong>SLO</strong> &gt; <strong>Отчёт о соответствии</strong> позволяет проанализировать соответствие всех SLO за произвольный период.</p> <!-- TODO: screenshot --> <p><strong>Выбор периода</strong></p> <p>В верхней части страницы — стандартный таймпиккер платформы с пресетами (последние 7 / 30 дней, текущий / прошлый месяц и т.д.) и возможностью задать произвольный диапазон. По умолчанию выбраны последние <strong>3 месяца</strong>.</p> <p><strong>Таблица отчёта</strong></p> <p>Каждая строка — отдельное SLO:</p> <table> <thead> <tr> <th>Столбец</th> <th>Описание</th> </tr> </thead> <tbody> <tr> <td><strong>SLO</strong></td> <td>Имя и тип SLO</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> <tr> <td><strong>Использовано бюджета</strong></td> <td>Доля израсходованного бюджета ошибок</td> </tr> <tr> <td><strong>Статус</strong></td> <td>Цветной индикатор: норма / нарушения / критическое</td> </tr> </tbody> </table> <p>Отчёт удобно использовать для регулярных встреч по надёжности и отчётности перед бизнесом.</p> <hr> <h2 id="права-доступа">Права доступа</h2> <p>SLO — отдельный тип ресурса (<code>slo</code>) в модели RBAC. Для работы с SLO пользователю требуются права:</p> <table> <thead> <tr> <th>Действие</th> <th>Право</th> </tr> </thead> <tbody> <tr> <td>Просмотр списка и деталей SLO</td> <td><code>slo:read</code></td> </tr> <tr> <td>Создание и редактирование</td> <td><code>slo:write</code></td> </tr> <tr> <td>Удаление</td> <td><code>slo:delete</code></td> </tr> </tbody> </table> <p>Права на SLO можно ограничивать по сервисам — в этом случае пользователь увидит только SLO разрешённых ему сервисов. Подробнее см. <a href="../rbac_admin/">Администрирование RBAC</a>.</p>