Отчёт по кластеру как артефакт, а не как экран

Панель мониторинга отвечает на вопрос «что сейчас». Это её сила и её единственное умение: она живая, и в ней нет прошлого в виде объекта.

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

Что попадает в отчёт

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

Это не «дашборд в PDF». Это набор проверок, каждая из которых даёт результат вида «прошло», «не прошло» или «требует внимания», с указанием, чего именно.

Зачем это нужно, если есть панель

Три причины.

Первая: сравнение. Вопрос «стало ли лучше после наших изменений» на панели решается памятью. С отчётами это дифф.

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

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

Почему это работает только на своих данных

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

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

Что генерируется, а что решает человек

Генерируются части, относящиеся к наблюдаемости, целям уровня обслуживания и панелям. На выходе — обычные артефакты Prometheus, Grafana и Alertmanager, а не проприетарный формат.

Решает человек: какие цели ставить, какие оповещения оставить, что считать приемлемым. Генерация даёт заготовку, соответствующую составу кластера; смысл в неё вкладывает тот, кто отвечает за сервис.

Это то же разделение, что и во всём остальном: расчёт совещательный, решение за человеком.

Самое полезное свойство отчёта

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

Сервис, у которого нет ни метрик, ни оповещений, на панели никак не выглядит — его там просто нет. В отчёте он появляется строкой «наблюдение отсутствует», и это самая ценная строка во всём документе.