Skip to content

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

Начните с наблюдаемого симптома и проверяйте цепочку по порядку: сохранённое расписание → реальный видеокадр → EPG → доступ зрителя. Ответ API или правильная программа передач сами по себе не подтверждают эфир.

Для проверок нужны доступ оператора к плейауту и его стриму, а для последнего шага — учётная запись абонента. Как открыть HLS-ссылку, описано в разделе Проверьте стрим.

Состояние плейаута можно уточнить через management API. Задайте адрес установки, учётную запись оператора и имя стрима; пароль передавайте только по HTTPS:

BASE='https://catena.example.com'
API_USER='operator'
read -rsp 'Operator password: ' API_PASSWORD; echo
STREAM='playout_<id>'
curl -fsS -u "$API_USER:$API_PASSWORD" \
  "$BASE/central/api-v4/streams/stats/$STREAM" |
  jq '.input.playout'

В ответе проверьте health и problems. Затем откройте нужный раздел ниже.

Эфир и расписание

В эфире заглушка

  • Признак: вместо фильма или live идёт заглушка слота, общая заглушка либо цветные полосы.
  • Возможные причины: текущее время не покрыто слотом, VOD закончился раньше конца слота либо содержимое недоступно.
  • Проверка: в редакторе откройте Playout и сверьте Сейчас и далее с сеткой. Если текущего слота нет, проверьте границы соседних слотов. Если слот есть, проверьте его длительность и доступность ассета. Запрос состояния выше помогает отличить ошибку ассета от паузы в расписании.
  • Действие: для паузы добавьте или перенесите слот и нажмите общую Сохранить, как описано в разделе Соберите расписание из VOD. Если VOD закончился естественно, оставьте заглушку до следующего слота либо измените длительность и содержимое слота. При ошибке ассета перейдите к разделу Контент и источники.
  • Контроль результата: если вы добавили или исправили слот, Сейчас показывает его, HLS или WebTV — его кадр, а EPG — его передачу. Если после естественного конца VOD вы намеренно оставили заглушку, проверьте, что она идёт до границы следующего слота, а затем начинается содержимое следующего слота. Для исправленного источника health должен вернуться к on_air, а список problems — очиститься.

Не тот слот или сохранённая правка не появилась в эфире

  • Признак: в плеере идёт прежняя передача или не тот слот, который вы только что изменили.
  • Возможные причины: изменён будущий слот, правка осталась в черновике, время слота задано неверно либо открытая WebTV держит прежнюю EPG.
  • Проверка: сравните Сейчас и далее с сеткой и проверьте начало и длительность слота. Если кнопка в окне слота уже нажата, проверьте, завершилась ли общая Сохранить над сеткой без ошибки. Сверьте свежую EPG в карточке канала и реальный кадр по HLS.
  • Действие: нажмите общую Сохранить. Для будущего слота дождитесь его начала; для неверного времени исправьте границы и снова сохраните расписание. После правки EPG перезагрузите открытую WebTV. Не перезапускайте стрим для применения расписания.
  • Контроль результата: Сейчас, свежая EPG и видеокадр соответствуют одному слоту. Правка будущего слота видна в его передаче, но не меняет текущий эфир до назначенного времени.

Общая заглушка не сохраняется

  • Признак: после выбора Заглушка канала общая Сохранить возвращает HTTP 422 с сообщением «missing field fps».
  • Возможная причина: в проверенной версии редактор отправляет неполный выходной конфиг при изменении общей заглушки. Сохранение расписания и заглушки слота — отдельный рабочий путь.
  • Проверка: откройте плейаут повторно и проверьте, что прежняя общая заглушка не изменилась. Не повторяйте ту же отправку из редактора.
  • Действие: сохраните полный существующий config с изменённым полем filler через management API по инструкции Задайте общую заглушку через API. Инструкция сохраняет fps, размер, звук и остальные параметры и использует If-Match против перезаписи чужой правки.
  • Контроль результата: ответ API содержит новый filler и прежние параметры выхода. Проверьте выбранную заглушку по HLS в ближайшей паузе расписания; не удаляйте текущий слот ради этой проверки.

Контент и источники

VOD-файл недоступен

  • Признак: слот с VOD есть в Сейчас, но в эфире заглушка; состояние стрима может быть degraded с ошибкой ассета.
  • Возможные причины: файл или хранилище недоступны, размещение ассета не готово либо Catena ещё не прочитала сведения о видео.
  • Проверка: откройте ассет в VOD → Каталог. Проверьте статус доступен, видео- и аудиодорожки в Media info, готовую копию и доступное хранилище в блоке Копии. Выполните запрос состояния стрима из начала страницы.
  • Действие: восстановите файл или хранилище и дождитесь готовности размещения. Удалите отказавший слот и нажмите общую Сохранить, затем создайте его заново с прежними содержимым, началом, длительностью и метаданными и снова сохраните расписание: так плейаут заново откроет ассет. Порядок удаления и восстановления описан в разделе Правьте текущий эфир. Если хранилище недоступно, используйте Диагностику стримера и сведения о размещении VOD, не пересоздавая плейаут. Если восстановить ассет сейчас нельзя, замените содержимое слота другим доступным VOD и нажмите общую Сохранить.
  • Контроль результата: ассет доступен, health вернулся к on_air, ошибка ассета исчезла из problems, а свежий HLS или WebTV показывает содержимое слота вместо заглушки.

Live-источник не играет

  • Признак: live-слот сохранён и виден в Сейчас, но в эфире заглушка. EPG при этом может показывать правильную live-передачу.
  • Возможные причины: сам live-источник недоступен либо срабатывает ограничение проверенной версии: работающий источник может не попасть в эфир плейаута даже без ошибки ассета.
  • Проверка: воспроизведите исходный live-стрим отдельно от плейаута и проверьте его входы по Диагностике источника. Затем сверьте реальный кадр плейаута по HLS и состояние problems. Не используйте EPG как доказательство live-эфира.
  • Действие: если источник недоступен, восстановите его вход и дождитесь отдельного воспроизведения live. Удалите отказавший live-слот и нажмите общую Сохранить, затем создайте его заново с прежними параметрами и снова сохраните расписание. Если источник играет отдельно, а плейаут остаётся на заглушке, замените live-слот доступным VOD-ассетом и нажмите общую Сохранить, как описано в разделе Добавьте live-источник. Другого подтверждённого восстановления live-эфира в этой версии нет.
  • Контроль результата: плеер показывает реальный кадр, а не только событие EPG. После перехода на VOD проверьте содержимое нового слота и обновлённую передачу.

Программа передач

EPG пустая

  • Признак: в карточке канала, WebTV или XMLTV нет текущей и следующей передач.
  • Возможные причины: в выбранном интервале нет слота, событие удалено вместе со слотом, канал ссылается на другой стрим либо канал недоступен абоненту.
  • Проверка: сверьте интервал с сохранённым расписанием. Проверьте программу в карточке канала и его поле Стрим, затем Доступные каналы в карточке абонента. Учтите, что паузы между слотами событий не создают, а при следующем сохранении удаляются события, закончившиеся больше суток назад.
  • Действие: добавьте или восстановите слот и нажмите общую Сохранить. Если канал связан не с тем стримом, исправьте связь по разделу Создайте канал. Если программы нет только у абонента, восстановите цепочку канал → пакет → подписка по разделу Канал не виден зрителю. Перезагрузите WebTV.
  • Контроль результата: карточка канала показывает передачу с нужными названием и временем; после перезагрузки WebTV или нового запроса XMLTV видны те же данные.

EPG устарела или содержит неверные данные

  • Признак: название, описание, время или порядок передач не совпадают с последней правкой.
  • Возможные причины: правка осталась в черновике, в слоте сохранены неверные поля либо открытая WebTV показывает ранее загруженную программу.
  • Проверка: откройте слот и сверьте сохранённые поля. Проверьте свежую программу в карточке канала или новым запросом XMLTV: если там данные уже правильные, устарела только открытая WebTV.
  • Действие: если свежая карточка канала или XMLTV уже показывает правильные данные, только перезагрузите WebTV — новая правка и сохранение расписания не нужны. Если сохранённые поля неверны или правка осталась в черновике, исправьте поля слота, сохраните окно и нажмите общую Сохранить по инструкции Обновите программу после правки. Для карточки канала обновите страницу консоли.
  • Контроль результата: свежая карточка канала, WebTV и XMLTV показывают исправленные название, границы и описание. Сезон, Серия и постер в EPG не переносятся; номер эпизода для зрителя укажите в названии.

EPG правильная, но в эфире заглушка

  • Признак: текущая передача в WebTV совпадает с расписанием, а видеокадр показывает заглушку.
  • Возможная причина: EPG отражает сохранённое намерение оператора, а не фактический кадр. Недоступный VOD или live и ограничение live-эфира не обязаны менять событие.
  • Проверка: откройте прямую HLS-ссылку и проверьте health и problems стрима. Затем проверьте ассет текущего слота и отдельное воспроизведение live-источника.
  • Действие: выполните маршрут VOD-файл недоступен или Live-источник не играет. Если live-источник работает отдельно, но плейаут остаётся на заглушке, используйте подтверждённый переход на VOD.
  • Контроль результата: свежий плеер показывает содержимое текущего слота. Если выбран VOD вместо live, EPG после сохранения и перезагрузки WebTV тоже соответствует новому слоту.

Доступ зрителя

Прямая HLS работает, но канал не виден зрителю

  • Признак: оператор смотрит стрим по прямой ссылке, а WebTV сообщает No channels available или не показывает нужный канал.
  • Возможная причина: прямая HLS проверяет стрим, но не публикацию. Канал не связан с этим стримом, не входит в пакет либо пакет не входит в подписки абонента.
  • Проверка: в Каналах проверьте точное имя стрима playout_<id>, в Пакетах — состав пакета, в карточке абонента — Подписки и итоговый блок Доступные каналы.
  • Действие: восстановите три связи по инструкции Опубликуйте канал: канал → стрим, канал → пакет, абонент → подписка на пакет. После изменения перезагрузите WebTV.
  • Контроль результата: канал появился в Доступных каналах и в WebTV, а зритель видит кадр и текущую передачу. Подписка влияет на доступные каналы; работающая прямая HLS её не заменяет.

Канал виден, но не играет

  • Признак: канал есть в списке, но плеер показывает отказ или не начинает воспроизведение.
  • Возможные причины: каналу не назначен стрим, назначен другой стрим либо воспроизведение не начинается в сеансе WebTV, хотя назначенный стрим работает.
  • Проверка: прочитайте сообщение плеера и проверьте поле Стрим канала. This channel has no broadcast configured означает отсутствие назначенного стрима. Сверьте точное имя назначенного стрима с playout_<id> нужного плейаута. Если правильный стрим уже назначен, не сохраняйте и не назначайте его повторно. Сначала сравните воспроизведение по прямой HLS того же стрима.
  • Действие: если стрим не назначен или назначен неверно, выберите правильный по разделу Создайте канал и сохраните канал. Если при правильном стриме прямая HLS не играет, перейдите к разделу Не играет и прямая HLS. Если прямая HLS играет, перезагрузите WebTV либо откройте новый сеанс WebTV в приватном окне браузера и снова войдите. Если плеер по-прежнему молчит без сообщения об ошибке, продолжите по разделу Прямая HLS играет, но WebTV молчит без ошибки. При явном сообщении о лимите экранов или входе устройства используйте раздел Зритель жалуется, что ничего не играет.
  • Контроль результата: новый сеанс WebTV показывает кадр канала со звуком и текущую передачу. Если WebTV молчит, сохраните для эскалации факт работающей прямой HLS: он не устанавливает причину отказа плеера.

Прямая HLS играет, но WebTV молчит без ошибки

  • Признак: правильный стрим назначен и прямая HLS играет, но в новом сеансе WebTV нет видео и сообщения об ошибке плеера.
  • Возможная причина: наблюдения ограничивают отказ воспроизведением в этом сеансе WebTV, но не называют его причину. Не объявляйте неисправность плейаута, транскодера, сети или браузера только по этому признаку.
  • Проверка: запишите, изменился ли результат после перезагрузки WebTV и открытия нового сеанса. В браузере на компьютере откройте инструменты разработчика перед перезагрузкой. Сохраните ошибки и предупреждения Console, неудачные запросы Network и HTTP-статусы страницы, HLS-манифестов и медиасегментов. Не меняйте код, флаги браузера или стрим. Если устройство не предоставляет таких инструментов, запишите это ограничение, не подключая отладчик.
  • Действие: не меняйте плейаут, транскодер и привязку канала только из-за этого признака. Передайте администратору сервиса или в поддержку пакет сведений ниже. Удалите из него пароли, cookie, токены доступа и секретные параметры запросов.
  • Пакет для эскалации:

  • Точный адрес страницы WebTV и URL без учётных данных и токенов.

  • Название и версию браузера, устройство и операционную систему.
  • Результат нового сеанса: загрузились ли список каналов и программа передач.
  • Сведения Console и Network либо отметку, что устройство не позволяет их собрать.
  • Факт, что прямая HLS уже работает: имя стрима и передача, которую удалось воспроизвести.

  • Контроль результата: если WebTV начала воспроизведение, проверьте картинку, звук и текущую передачу. Если плеер молчит, пакет фиксирует результат нового сеанса и сравнение с уже работающей прямой HLS без выдуманного диагноза.

Не играет и прямая HLS

  • Признак: стрим плейаута не воспроизводится ни в WebTV, ни по прямой ссылке; мастер-манифест может содержать только заголовок без качеств.
  • Возможная причина: плейаут отдаёт несжатые видео YUV и звук PCM, а для обычного HLS-плеера не настроен транскодер.
  • Проверка: откройте мастер-манифест и проверьте наличие качеств. На странице стрима откройте Транскодер и сверьте Предпросмотр: вход → выход. Если предупреждение говорит об ошибке транскодера, используйте профильную диагностику.
  • Действие: настройте пресет Стандартная лестница 1080/720/360 + AAC по разделу Выберите выход для зрителей и сохраните транскодер.
  • Контроль результата: мастер-манифест содержит качества, манифест качества — медиасегменты, а плеер показывает текущий слот со звуком. После этого отдельно проверьте доступ канала у абонента.

Что дальше