Отчёты

Зачем нужна эта вкладка#

Вкладка «Отчёты» — это инструмент управленческой и аудиторской сводки. Если вкладки Хосты, Linux, OVAL отвечают на вопрос «что сделать прямо сейчас», то «Отчёты» отвечают на вопрос «как у нас вообще обстоят дела?».

Типичные сценарии:

• Регулярная сводка руководителю — «за месяц обновлено 240 машин из 250, 10 в очереди».
• Подготовка к аудиту — «вот список машин, не обновлявшихся больше 30 дней, и вот почему».
• Доказательство безопасности — «парк соответствует требованиям, уязвимостей, не устранённых обновлением, нет».
• Анализ «слабых мест» — какие коллекции хостов постоянно отстают, где ошибки повторяются.

Фильтры отчётов#

Перед выбором типа отчёта укажите общие параметры:

• Тип отчёта — выбирается из списка ниже.
• Период — 7 / 30 / 90 / 365 дней. Актуален для отчётов с журналами (история установок, недоступные хосты).
• Коллекция хостов — ограничить выборку одной коллекцией (например, «только серверы»).

Типы отчётов#

Отчёты сгруппированы в три категории, как на вкладке (хеш-адрес каждого — #reports/<категория>/<тип>).

Операционные#

Отчёт	Код	Что показывает	Когда использовать
Обзор обновлений	updates_overview	Сводное состояние обновлений парка за период.	Быстрый общий срез «как дела с обновлениями».
Сводка по обновлениям	updates_summary	Снимок парка: сколько хостов с обновлениями, сколько без, KPI обновлённости.	Ежедневный/еженедельный срез для руководителя.
Результаты установок	update_operations	Успехи и ошибки по операционным системам за период; хосты с ошибками установки.	Разбор системных проблем: если много ошибок на одной ОС — что-то не так.
Недоступные хосты	offline_hosts	Машины, не выходившие на связь за выбранный период.	Поиск «потерянных» машин — возможно, списаны, выключены или нет сети.
Проверка соответствия репозиторию	foreign_packages	Пакеты на хосте, отсутствующие в выбранных локальных репозиториях.	Поиск «чужих» пакетов — кто ставил то, что не из корпоративных репозиториев.
Проблемные хосты	host_health	Хосты с ошибками: сбои heartbeat, ошибки обновлений, проблемы с агентом.	Быстрый поиск машин, требующих внимания администратора.
Windows — неустановленные KB	windows_kb_compliance	Windows-хосты с неустановленными обновлениями KB (в т.ч. Critical).	Контроль Windows-парка после Patch Tuesday.
Windows — раскатка обновлений	windows_kb_rollout	Ход раскатки KB по кампаниям за период.	Контроль волн и пилотных групп кампаний Windows.
Пользователи и входы	user_sessions	Сессии пользователей на хостах: кто, когда, с какой машины.	Учёт рабочего времени, розыск «кто за чем сидит».

Информационная безопасность#

Отчёт	Код	Что показывает
Конфигурации — соответствие	config_compliance	Соответствие хостов назначенным конфигурациям.
Соответствие требованиям регулятора	config_requirements	Выполнение требований регулятора на хостах.
OVAL — статус хостов	oval_host_security	Уязвимости по хостам из OVAL-сканирования.
Инциденты USB	usb_events	События с отказом или блокировкой USB за период. Полный журнал — на вкладке USB.
Активность администраторов	admin_audit	Журнал действий администраторов LSUS за период.

Инвентаризация#

Отчёт	Код	Что показывает
Инвентаризация — хосты	inv_hosts	Живая таблица хостов с CPU, RAM, дисками, NIC. Свои фильтры (поиск, ОС, «есть данные»); выгрузка CSV/JSON/PDF через шестерёнку в панели списка.
Инвентарь парка	host_inventory	Сводка по ОС + детализация по хостам (версии клиента, compliance репозиториев).
Изменения инвентаризации	inventory_changes	Что изменилось в инвентаризации хостов за период (ПО, оборудование).

Детализация установок#

Подробный журнал отдельных установок с текстом ошибок находится во вкладке Администрирование → Журнал (см. 3.10). В отчётах — только агрегаты и списки хостов, требующих внимания. Такое разделение сделано осознанно: отчёт — это «верхний срез» для руководителя, а журнал — рабочая таблица для разбора конкретных инцидентов.

Экспорт#

Через кнопку-шестерёнку (⚙):

• CSV — для Excel и Google Sheets. С BOM для корректного открытия в русских Excel.
• JSON — для интеграции с другими системами.
• PDF — для печати и официальных отчётов (требуется python3-reportlab на сервере).

Экспортируются отфильтрованные данные с учётом выбранного периода и коллекции. Для «Инвентаризация — хосты» шестерёнка своя, в тулбаре таблицы: выгружается вся выборка по текущим фильтрам списка.

API#

Метод	Путь
GET	/api/v1/admin/reports/<type>?period=30&group_id=
GET	/api/v1/admin/reports/<type>/pdf?period=30&group_id=
GET	/api/v1/admin/reports/foreign-packages?local_repo_ids=&host_ids=

Типы <type>: updates_summary, offline_hosts, update_operations, host_inventory, inv_hosts, inventory_changes, windows_kb_compliance, host_health, admin_audit, user_sessions, usb_events.

Права доступа#

Действие	Permission key
Просмотр отчётов	reports.view