Отчёты

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

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

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

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

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

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

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

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

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

Отчёт	Что показывает	Когда использовать
Сводка по обновлениям (updates_summary)	Снимок парка: сколько хостов с обновлениями, сколько без, KPI обновлённости.	Ежедневный/еженедельный срез для руководителя.
Недоступные хосты (offline_hosts)	Машины, не выходившие на связь за выбранный период.	Поиск «потерянных» машин — возможно, списаны, выключены или нет сети.
Результаты установок (update_operations)	Успехи и ошибки по коллекциям за период; хосты с ошибками установки.	Разбор системных проблем: если много ошибок на одной коллекции — что-то не так.
Инвентарь парка (host_inventory)	Сводка по ОС + детализация по хостам (версии клиента, compliance репозиториев).	Инвентаризация для целей ИБ, подготовка к закупке агентов и т.п.
Изменения инвентаризации (inventory_changes)	Что изменилось в инвентаризации хостов за период (ПО, оборудование).	Отслеживание дрейфа конфигураций, несанкционированных изменений.
Проблемные хосты (host_health)	Хосты с ошибками: сбои heartbeat, ошибки обновлений, проблемы с агентом.	Быстрый поиск машин, требующих внимания администратора.
Проверка соответствия репозиторию	Пакеты на хосте, отсутствующие в выбранных локальных репозиториях.	Поиск «чужих» пакетов — кто ставил то, что не из корпоративных репозиториев.

Windows¶

Отчёт	Что показывает
Windows — неустановленные KB (windows_kb_compliance)	Windows-хосты с неустановленными обновлениями KB (в т.ч. Critical).

Аудит и пользователи¶

Отчёт	Что показывает
Активность администраторов (admin_audit)	Журнал действий администраторов LSUS за период.
Пользователи и входы (user_sessions)	Сессии пользователей на хостах: кто, когда, с какой машины.

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

Отчёт	Что показывает
Инциденты USB (usb_events)	События с отказом или блокировкой USB за период. Полный журнал — на вкладке USB.

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

Подробный журнал отдельных установок с текстом ошибок находится во вкладке Администрирование → Журнал (см. 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, inventory_changes, windows_kb_compliance, host_health, admin_audit, user_sessions, usb_events.

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

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