Платформа 4.0 + BOX 3.2
Диагностика: видео, детекции, события и архив
Последовательность проверок BOX 3.x и Платформы 4.0: локализация сбоя по слоям, журналы и признаки типовых неисправностей.
На этой странице
Смотрите по слоям
Источник видео, медиасервис, inference, сценарий, event storage и интеграционный потребитель могут давать похожий пользовательский симптом. Диагностика должна идти последовательно по пути события.
Базовые сигналы
Статус камеры и сценария, входной и обработанный FPS, загрузка CPU/GPU и памяти, очереди, ошибки обработки, задержка события и доступность хранилищ образуют минимальный набор наблюдаемости.
Журналы и изменения
Сопоставляйте технический сбой с релизами, сменой версии модели, публикацией сценария, изменением камеры и действиями администратора.
Локализация по месту потери данных
Начните с одной камеры и конкретного времени сбоя. Для тестового запуска дополнительно зафиксируйте launch_uuid, версию модели и сценария. Эти идентификаторы позволяют сопоставить экран, логи и результаты обработки.
- 1Нет исходного видео↓ Видео есть
Проверьте источник, сеть, доступ и медиасервер.
- 2Нет детекций↓ Детекции есть
Проверьте активный пресет или сценарий, модель, ресурсы GPU/RAM и журнал inference.
- 3Нет событий↓ Событие сохранено
Проверьте зону и условия, отправку сообщений, Kafka, фильтрацию и event storage.
- 4Нет медиа или реакции
Проверьте видеоархив, MinIO, шлюз воспроизведения и отдельно нужный канал уведомления.
Типовые симптомы BOX 3.x
Ниже — направления проверки, а не однозначный диагноз. Сначала подтвердите причину в журналах и метриках. Перезапуск может временно устранить симптом, но сам по себе не объясняет сбой.
| Симптом | Что проверить | Следующее действие |
|---|---|---|
| Детекции исчезли после перезагрузки | Готовность Kafka к моменту старта inference. В старых версиях описана проблема порядка запуска | После готовности зависимостей перезапустите затронутый inference по регламенту |
| Нет детекций и трансляции нейросети | RAM, OOM-события, состояние DTS | Сохраните диагностику и проверьте совместимую версию DTS с DevOps |
| 502 при открытии архивного видео | Журналы ui-rest, upstream Nginx, доступ к архиву | В кластере проверьте маршрутизацию к узлам и схему получения видео |
| UI открывается, видео по WebRTC отсутствует | Доступность coturn из сети клиента, COTURN_HOST_IP | Исправьте сетевой маршрут и адрес coturn; проверьте поток повторно |
| Бесконечная загрузка UI после настройки | Наличие и валидность config.json, доступ к API | Восстановите корректный конфигурационный файл и проверьте ответ API |
Просмотр журналов в Grafana / Loki
В Grafana откройте Explore и выберите источник Loki. Начните с интервала сбоя, затем ограничьте выборку узлом и сервисом. Имена меток зависят от конфигурации сборщика; выберите существующие метки из списка Explore. Используйте выданную для вашего контура учётную запись.
После локализации проверьте соседние сервисы в том же временном интервале: успешный запрос к API не доказывает доставку сообщения или сохранение медиа.
- Время инцидента и часовой пояс
- Камера или объект
- Сервис, узел и версия образа
- Ошибка и предшествующий ей контекст
- Ресурсы CPU / GPU / RAM и заполнение дисков
- Изменения конфигурации непосредственно перед сбоем
Журнал действий в BOX 3.2 · открыть
