Информация о потоках, опубликованных на наблюдаемых узлах, может быть получена от бэкенд-сервера по REST API
Информация о потоках, опубликованных в данный момент
Информацию о потоках, опубликованных на наблюдаемых узлах в данный момент, можно получить при помощи REST API запроса /api/stream/list
https://hostname:8090/api/stream/list { "node":"", "mediaId":"", "name":"", "publisher":"", "status":"" }
Здесь:
- node – идентификатор узла (обязательное поле)
- media – идентификатор медиасессии на узле
- name – имя потока
- publisher - идентификатор публикатора потока (для воспроизводимых потоков)
- status – статус потока (PENDING, PUBLISHING, PLAYING, UNPUBLISHED, STOPPED, FAILED)
Информация в ответ на запрос выбирается из кэша полученных метрик.
Ответ содержит следующие поля
[ { "mediaId": "ba3b3950-8060-11e9-90b4-df338db69136", "name": "test", "publisher": null, "age": 413, "status": "PUBLISHING", "VIDEO_SYNC": 3767942629345, "AUDIO_SYNC": 3767942629304, "VIDEO_NACK": 81, "METRIC_RESOURCE": 0, "AUDIO_RATE": 28560, "STREAM_RESOURCE": 0, "AUDIO_LOST": 184, "VIDEO_CODEC": 119, "HEADER_RESOURCE": 0, "VIDEO_PLI": 1, "VIDEO_RATE": 619904, "AUDIO_CODEC": 111, "VIDEO_WIDTH": 320, "VIDEO_HEIGHT": 240, "VIDEO_FPS": 17, "KEEP_ALIVE": 0 } ]
Здесь
- name – имя потока
- status – статус потока
- mediaId – идентификатор медиасессии потока
- age – возраст записи кэша для данного потока в миллисекундах
- publisher - идентификатор публикатора (для воспроизводимых потоков)
Ответ также содержит текущие мгновенные значения метрик из кэша
Статистика потоков
Статистику потоков, опубликованных на наблюдаемых узлах, можно получить при помощи REST API запроса /api/stream/history
https://hostname:8090/api/stream/history { "node":"", "mediaId":"", "name":"", "publisher":"", "status":"" }
Здесь:
- node – идентификатор узла
- mediaId – идентификатор медиасессии на узле
- name – имя потока
- publisher - идентификатор публикатора потока (для воспроизводимых потоков)
- status – статус потока (PENDING, PUBLISHING, PLAYING, UNPUBLISHED, STOPPED, FAILED)
Если указан идентификатор узла, то ответ будет содержать информацию только о потоках на этом узле, в противном случае информацию о потоках на всех наблюдаемых узлах, соответствующих другим критериям запроса.
Ответ содержит следующие поля
[ { "id": 16, "name": "test", "status": "PUBLISHING", "mediaId": "010934f0-0766-11e9-a950-59983a9de3c8", "createDate": 1545647031908, "endDate": null, "publisher": 0, "subscribers": [], "node": 15 } ]
Здесь
- id – идентификатор потока в БД бэкенда
- name – имя потока
- status – статус потока
- mediaId – идентификатор медиасессии потока
- createDate – дата создания потока
- endDate – дата завершения публикации или воспроизведения потока
- publisher - идентификатор публикатора (для воспроизводимых потоков)
- subscribers - список идентификаторов подписчиков (для публикуемых потоков)
- node – идентификатор узла в БД бэкенда