Диагностика неполадок

Быстрая диагностика PrimeCast за пять минут и дерево поиска неисправности: от физического подключения и экрана модуля до служб, сервера и клиента.

Диагностика PrimeCast строится как цепочка доказательств: физика → OSD → V4L2 → агент → SRT → MediaMTX → API/WHEP → клиент. На каждом этапе должно быть отдельное доказательство исправности — не переходите к следующему, пока предыдущий не подтверждён.

Быстрая диагностика за пять минут

Следуйте строго сверху вниз.

Шаг 1. Физическое подключение

Есть питание?
Работает экран?
HDMI вставлен?
Источник включён?
USB-захват подключён?
Сеть подключена?

Шаг 2. Состояние на экране

Есть интернет?
Есть HDMI?
Включена трансляция?
Показан IP?

Шаг 3. Тест с другого клиента

Ошибка повторяется в браузере и приложении?
Ошибка только у одного пользователя?
Ошибка только у одного устройства?

Шаг 4. Службы модуля

systemctl is-active primecast-agent
systemctl is-active primecast-localrelay
systemctl is-active primecast-osd

Шаг 5. Логи

sudo journalctl -u primecast-agent -n 100 --no-pager
sudo journalctl -u primecast-localrelay -n 100 --no-pager
sudo journalctl -u primecast-osd -n 100 --no-pager

Важно. Не публикуйте лог до удаления секретов.

Дерево поиска неисправности

Нет изображения у пользователя
│
├─ Экран PrimeCast не включён
│  └─ Проверить питание, БП, кабель, SD-карту
│
├─ Экран показывает «Нет HDMI»
│  ├─ Проверить источник
│  ├─ Проверить HDMI/AV2HDMI
│  ├─ Проверить USB-захват
│  └─ Проверить /dev/video0
│
├─ Экран показывает «Нет интернета»
│  ├─ Проверить профиль NetworkManager
│  ├─ Проверить IP и default route
│  ├─ Проверить DNS
│  └─ Проверить исходящий доступ к реле
│
├─ Экран показывает «Стрим выключен»
│  └─ Включить трансляцию
│
├─ Экран показывает «Стрим идёт»
│  ├─ Проверить пароль устройства
│  ├─ Проверить primecast-agent
│  ├─ Проверить сервер и MediaMTX
│  ├─ Проверить WHEP/WebRTC
│  └─ Проверить клиентскую сеть
│
└─ Работает только у части пользователей
   ├─ Проверить роль и группу
   ├─ Проверить браузер/приложение
   ├─ Проверить корпоративный firewall
   └─ Проверить TURN/WebRTC

Углублённая диагностика

Диагностика модуля по SSH — службы, логи, V4L2, USB, сеть, конфигурация.
Типовые неисправности — симптомы и решения по подсистемам.
Обновление модуля и восстановление — резервные копии, обновление OSD, откат.
Сервер, безопасность и обновления — диагностика серверной части и медиареле.

Сбор данных для обращения в поддержку описан в разделе Обслуживание и инциденты.