Обслуживание и чек-листы
Периодическое обслуживание PrimeCast, уровни инцидентов P1–P4, правила сбора данных для обращения в поддержку, контрольный лист приёмки модуля, памятки по ролям и глоссарий.
Регулярное обслуживание снижает количество инцидентов: короткие проверки выполняются еженедельно, полные — ежемесячно и ежеквартально. Здесь же собраны классификация инцидентов, правила оформления обращения в поддержку, контрольный лист приёмки модуля, краткие памятки по ролям и глоссарий.
Периодическое обслуживание
Еженедельно
- визуальная проверка;
- тест запуска трансляции;
- проверка кабелей;
- проверка времени;
- проверка свободного места.
Ежемесячно
- установка утверждённых обновлений безопасности;
- аудит предупреждений журналов;
- проверка температуры и питания;
- тест резервного канала;
- проверка резервных копий.
Ежеквартально
- тест восстановления;
- аудит аккаунтов и групп;
- ротация паролей по политике;
- проверка срока сертификатов;
- инвентаризация модулей и версий.
После транспортировки
- проверить корпус;
- проверить фиксацию платы и захвата;
- проверить разъёмы;
- проверить экран и джойстик;
- выполнить полный тест трансляции.
Уровни инцидентов
| Уровень | Пример | Реакция |
|---|---|---|
| P1 — критический | Недоступна платформа или все трансляции | Немедленная эскалация |
| P2 — высокий | Не работает критически важный модуль | Срочная диагностика |
| P3 — средний | Деградация качества, обходной путь есть | Плановое исправление |
| P4 — низкий | Вопрос, улучшение, косметическая ошибка | Очередь поддержки |
Когда сразу эскалировать
- подозрение на утечку ключа;
- неизвестный сертификат;
- повторная перезагрузка устройства;
- запах гари или перегрев;
- повреждение файловой системы;
- массовый отказ авторизации;
- доступ пользователя к чужой компании;
- потеря production-данных.
Что приложить к обращению
Не отправляйте сообщение «не работает» без контекста.
Минимальный набор:
Дата и время:
Компания/площадка:
Номер модуля (пароль не указывать):
Версия клиента:
Тип клиента: браузер / Android / Windows / Linux
Тип сети: LAN / Wi‑Fi / LTE
Источник: HDMI / аналог через AV2HDMI
Состояние на экране:
Ожидаемое поведение:
Фактическое поведение:
Когда началось:
Повторяется ли после перезапуска:
Работает ли с другого клиента:
Что уже проверено:
Команды для диагностического отчёта
date --iso-8601=seconds
uname -a
systemctl is-active \
primecast-agent primecast-localrelay primecast-osd NetworkManager
nmcli -t -f DEVICE,TYPE,STATE,CONNECTION device status
ip -br address
ip route show default
v4l2-ctl --list-devices
vcgencmd measure_temp
vcgencmd get_throttled
df -h /
Логи собираются отдельно и очищаются от секретов — см. Сервер, безопасность и обновления.
Контрольный лист приёмки модуля
Оборудование
- Корпус не повреждён.
- Блок питания соответствует требованиям.
- Экран работает.
- Джойстик работает.
- USB-захват определяется.
- HDMI-источник определяется.
Сеть
- Получен IP.
- Есть маршрут по умолчанию.
- Работает DNS.
- Сервер доступен.
- SRT-публикация не блокируется.
Трансляция
- Агент запускается.
- На экране «Стрим идёт».
- Изображение появляется у пользователя.
- Автопереподключение работает после краткого отключения HDMI.
- Выключение стрима прекращает просмотр.
Доступ
- Ключ отображается.
- Пароль отображается.
- Неверный пароль отклоняется.
- Правильный пароль открывает только нужный модуль.
- Пользователь не видит чужие группы.
Клиенты
- Браузер.
- Android.
- Windows.
- Linux.
Краткая памятка пользователю
1. Подключите источник HDMI.
2. Убедитесь, что на PrimeCast есть интернет.
3. Выберите «Трансляция» и нажмите OK.
4. Дождитесь «Стрим идёт».
5. Откройте PrimeCast.
6. Войдите в аккаунт.
7. Введите ключ и пароль устройства.
8. Если изображения нет — сообщите точный текст с экрана.
Краткая памятка модератору
1. Не запрашивайте у пользователя SSH-пароль.
2. Разделите аккаунт и пароль устройства.
3. Проверьте физическое подключение.
4. Проверьте экран PrimeCast.
5. Проверьте ошибку с другого клиента.
6. Проверьте группу и роль.
7. Соберите системные статусы.
8. Перед отправкой логов удалите секреты.
9. Эскалируйте с заполненным шаблоном.
Краткая памятка системному администратору
Физика → OSD → V4L2 → агент → SRT → MediaMTX → API/WHEP → клиент
На каждом этапе должно быть отдельное доказательство исправности. Не переходите к следующему этапу, пока предыдущий не подтверждён.
Глоссарий
| Термин | Значение |
|---|---|
| AV/CVBS | Аналоговый композитный видеосигнал |
| AV2HDMI | Активный преобразователь аналогового AV в HDMI |
| Bitrate | Объём видеоданных в секунду |
| Caddy | HTTPS-сервер и reverse proxy |
| FPS | Количество кадров в секунду |
| GOP | Интервал между ключевыми кадрами |
| HDMI capture | Устройство преобразования HDMI в V4L2/USB-видео |
| HLS | Потоковый протокол на основе HTTP |
| MediaMTX | Медиареле PrimeCast |
| OSD | Локальный экран состояния модуля |
| SRT | Протокол надёжной передачи видео по нестабильной сети |
| TURN | Реле для WebRTC, когда прямой медиаканал невозможен |
| UVC | Стандарт USB-видеоустройств |
| V4L2 | Видеоинтерфейс Linux |
| WebRTC | Низколатентная доставка аудио и видео в клиент |
| WHEP | HTTP-протокол получения WebRTC-потока |