feat(portal): add agent data trust explain

This commit is contained in:
igor04091968
2026-06-04 11:59:50 +03:00
parent 95e7c0f314
commit e55b68868d
6 changed files with 280 additions and 39 deletions
+28 -19
View File
@@ -28,36 +28,45 @@
- WARN/FAIL подразделения;
- критические риски;
- недельный тренд;
- качество данных агента;
- достоверность данных агента;
- топ-5 лучших и проблемных подразделений;
- Heat Map;
- блок `Требует внимания`.
## Качество данных агента
## Достоверность данных агента
Портал показывает карточку `Качество данных агента` в `Обзор` и `Отчеты`.
Портал показывает карточку `Достоверность данных агента` в `Обзор` и
`Отчеты`. Это управленческий вывод о том, можно ли использовать текущий
`Индекс активности` и отчеты как подтвержденный KPI.
Карточка содержит:
API сохраняет старое поле `agent_quality` и дополнительно отдает
`agent_quality_explain`:
- `quality_status`;
- `collector_source`;
- `sessions_collected_total`;
- `active_sessions_total`;
- `rdp_sessions_total`;
- `collector_error`, если он есть.
- `status`;
- `title`;
- `summary`;
- `recommendation`;
- `kpi_accepted`.
Цвета статусов:
- `ok` - зеленый;
- `fallback` - желтый;
- `degraded` - оранжевый;
- `error` - красный;
- `unknown` - серый.
- `OK` - зеленый, KPI подтвержден основным источником;
- `WARNING` - желтый, данные собраны резервным способом;
- `DEGRADED` - оранжевый, данные нельзя использовать как доказательный KPI;
- `UNKNOWN` - серый, агент не передал diagnostics.
Для `fallback`, `degraded` и `error` портал показывает предупреждение о том,
что активность собрана не основным способом и точность RDP/worktime KPI может
быть снижена. Старые агенты без diagnostics не ломают API и отображаются как
`unknown`.
Карточка сначала показывает управленческий вывод, принято ли значение в KPI, и
рекомендацию. Технические поля доступны в раскрываемом блоке:
- источник коллектора;
- всего сессий;
- активных сессий;
- RDP-сессий;
- ошибка коллектора, если она есть.
Если diagnostics отсутствует, статус `UNKNOWN`, рекомендация - обновить Rust
agent и проверить поступление telemetry JSONL. Если источник `local_fallback`,
портал прямо пишет: `Диагностический режим, данные не засчитываются в KPI`.
## Risk -> Investigation