Skip to content

Управление стримерами

Стримеры в Agora являются исполнительными узлами, на которых выполняются прием сигнала, публикация, работа с аппаратными устройствами и сбор эксплуатационной статистики. Управление стримерами нужно для того, чтобы подключить реальные серверы к платформе, контролировать их состояние и использовать их в потоках и IO-устройствах.

Через раздел стримеров администратор:

  • регистрирует серверы origin и edge в системе;
  • задает параметры подключения к ним;
  • контролирует их загрузку и текущее состояние;
  • подготавливает инфраструктуру для настройки потоков и IO-устройств.

Список стримеров

Список стримеров

На странице списка стримеров отображаются все зарегистрированные узлы. Для каждого стримера видны:

  • hostname;
  • количество работающих потоков и общее количество сконфигурированных потоков;
  • количество подключенных клиентов;
  • загрузка CPU;
  • использование диска.

Из списка можно:

  • открыть карточку конкретного стримера;
  • добавить новый стример;
  • обновить список вручную.

Этот экран используется как быстрый обзор состояния инфраструктурных узлов Agora.

Создание стримера

При создании нового стримера в текущем интерфейсе достаточно указать:

  • hostname.

После создания стример получает внутренний идентификатор и становится доступен для дальнейшей настройки.

Карточка стримера

Карточка стримера

В карточке стримера администратор может:

  • изменить hostname;
  • выбрать схему подключения: HTTP или HTTPS;
  • указать API-порт;
  • настроить config_api_key;
  • настроить edit_auth;
  • сохранить изменения;
  • перезагрузить данные стримера;
  • удалить стример.

Если на странице есть несохраненные изменения, интерфейс предупреждает об этом при попытке уйти со страницы.

Параметры подключения

Для работы с удаленным узлом задаются:

  • схема подключения HTTP / HTTPS;
  • порт API;
  • config_api_key для доступа к внешней конфигурации;
  • edit_auth для операций редактирования.

Эти параметры определяют, как контроллер взаимодействует со стримером.

config_api_key нужен для того, чтобы на стримере можно было указать config_external и получить оттуда полную конфигурацию сервера. Иными словами, этот ключ используется как пароль для централизованной конфигурации

Работа с секретами

В интерфейсе для секретных параметров доступны дополнительные действия:

  • скрытие и отображение значения;
  • копирование config_api_key;
  • генерация нового config_api_key.

Это упрощает первичную настройку и ротацию ключей доступа.

Получение команды для внешней конфигурации

Для уже созданного стримера интерфейс может показать готовую curl-команду для обращения к endpoint внешней конфигурации.

Это помогает:

  • проверить какая конфигурация будет доступна стримеру;
  • быстро проверить правильность URL для конфигурации;
  • убедиться, что config_api_key настроен корректно.

Связь с другими разделами

Настроенные стримеры используются в других частях Agora:

  • при привязке IO-устройств;
  • при настройке аппаратного захвата HDMI / SDI;
  • при проектировании кластерных режимов приема и публикации;
  • при мониторинге состояния инфраструктуры.