Информация о нагрузке и ресурсах WCS-сервера доступна на порту 8081 по URL
http://test.flashphoner.com:8081/?action=stat
где test.flashphoner.com - это адрес WCS-сервера.
Она включает данные о публикуемых и воспроизводимых потоках, SIP-звонках и характеристиках сервера.
Статистические параметры
Connection | Соединения с WCS-сервером |
---|---|
connections | Общее количество соединений |
connections_rtmfp | Количество RTMFP-соединений (Flash) |
connections_websocket | Количество WebSocket-соединений |
Port | Порты, слушаемые WCS-сервером |
ports_media_free | Количество свободных медиапортов |
ports_media_busy | Количество занятых медиапортов |
ports_media_quarantine | Количество медиапортов в карантине |
ports_wcs_agents_free | Количество свободных портов, используемых в CDN |
ports_wcs_agents_busy | Количество занятых портов, используемых в CDN |
ports_wcs_agents_quarantine | Количество портов, используемых в CDN, находящихся в карантине |
Stream | Сессии аудио и видеопотоков на WCS-сервере |
streams_rtsp_in | Количество активных RTSP-сессий, раздающих трафик |
streams_rtsp_out | Количество активных RTSP-сессий, забирающих трафик |
streams_websocket_out | Количество активных потоков, воспроизводимых через WebSocket |
streams_rtmp_out | Количество активных RTMP-потоков |
streams_webrtc_in | Количество активных потоков, публикуемых через WebRTC |
streams_webrtc_out | Количество активных потоков, воспроизводимых через WebRTC |
streams_rtmfp_in | Количество активных потоков, публикуемых через RTMFP |
streams_rtmfp_out | Количество активных потоков, воспроизводимых через RTMFP |
streams_viewers | Количество активных клиентов, воспроизводящих опубликованные потоки |
streams_synchronization | Синхронизация в опубликованных потоках |
Native resources | Информация о потребляемых ресурсах |
native_resources | Информация о кодировании/декодировании медиапотока |
Core | Параметры системы (полученные с использованием методов Java) и параметры WCS-сервера |
core_threads | Количество активных потоков server-процесса WCS |
core_java_threads | Текущее количество живых потоков |
core_java_committedMemory | Количество гарантированно доступной виртуальной памяти, в байтах |
core_java_freePhysicalMemorySize | Количество свободной физической памяти, в байтах |
core_java_arch | Aрхитектура операционной системы |
core_java_availableProcessors | Количество процессоров доступных виртуальной машине Java |
core_java_freeSwapSpaceSize | Количество свободного swap-пространства, в байтах |
core_java_maxFileDescriptorCount | Максимальное количество файл-дескрипторов |
core_java_open_file_descriptors | Количество файл-дескрипторов, открытых в виртуальной машине Java |
core_java_cpu_usage | "Недавнее использование процессора" для процесса виртуальной машины Java |
core_java_totalPhysicalMemorySize | Количество физической памяти, в байтах |
core_java_totalSwapSpaceSize | Количество swap-пространства, в байтах |
core_java_uptime | Сколько времени прошло от запуска виртуальной машины Java, в миллисекундах |
core_heap_memory_used | Использование памяти в куче |
core_rss_memory | Использование памяти |
core_open_file_descriptors | Количество открытых файл-дескрипторов |
core_cpu_usage | Процент времени, затраченного на работу процессов |
core_gc | Информация о "сборке мусора" |
core_gc_manager | Информация о "сборке мусора" в административном модуле |
Call | SIP-звонки на WCS-сервере |
sip_calls | Количество SIP-звонков |
sip_calls_established | Количество активных SIP-звонков |
sip_calls_in | Количество входящих SIP-звонков |
sip_calls_out | Количество исходящих SIP-звонков |
sip_calls_per_second (cps) | Количество SIP-звонков в секунду |
SIP | |
sip_registered | Количество клиентов в состоянии REGISTERED |
Recording | Запись аудио и видеофайлов |
recording_sessions | Количество активных сессий записи |
System | Параметры системы |
system_java_cpu_usage | "Недавнее использование процессора" для всей системы (получено с использованием методов Java) |
system_java_load_average | Средняя нагрузка системы за последнюю минуту (получено с использованием методов Java) |
system_uptime | Сколько времени прошло от запуска Linux-сервера |
system_memory_total | Доступная к использованию RAM-память, в килобайтах |
system_memory_free | Количество физической RAM-памяти, не используемой системой, в килобайтах |
system_cpu_usage | Процент времени, затраченного на работу процессов ядра |
Network Stats (Mbit/s) | Статистика сетевого трафика |
global_bandwidth_in | Пропускная способность канала для входящих соединений |
global_bandwidth_out | Пропускная способность канала для исходящих соединений |
Version info | Информация о версии WCS |
wcs_version | Текущая версия WCS-сервера |
wcs_client_version | Текущая версия WCS API |
Errors info | Информация об ошибках (собирается на основании перехваченных исключений Java) |
java.io.IOException | Количество ошибок ввода-вывода |
java.lang.ArrayIndexOutOfBoundsException | Количество выходов за пределы массива |
java.lang.IllegalArgumentException | Количество ошибок в аргументах функций |
com.flashphoner.server.license.activation.A.C | Количество ошибок при активации лицензии |
java.lang.NullPointerException | Количество попыток перехода по нулевому указателю |
Degraded streams | Информация о деградации потоков |
degraded_streams | Количество деградировавших потоков |
degraded_streams_percent | Процент деградации от общего числа потоков на сервере |
Transcoding stats | Информация о транскодировании потоков |
transcoding_video_decoding_resolutions | Список декодируемых разрешений в виде "разрешение/количество потоков" |
transcoding_video_decoding_average_time | Среднее время декодирования по разрешениям в виде "разрешение/время в мс" |
transcoding_video_decoding_max_time | Максимальное время декодирования по разрешениям в виде "разрешение/время в мс" |
transcoding_video_decoding_average_queue_size | Средний размер очереди декодирования по разрешениям в виде "разрешение/размер очереди" |
transcoding_video_decoding_max_queue_size | Максимальный размер очереди декодирования по разрешениям в виде "разрешение/размер очереди" |
transcoding_video_encoding_resolutions | Список кодируемых разрешений в виде "разрешение/количество потоков" |
transcoding_video_encoding_average_time | Среднее время кодирования по разрешениям в виде "разрешение/время в мс" |
transcoding_video_encoding_max_time | Максимальное время кодирования по разрешениям в виде "разрешение/время в мс" |
transcoding_video_encoding_average_queue_size | Средний размер очереди кодирования по разрешениям в виде "разрешение/размер очереди" |
transcoding_video_encoding_max_queue_size | Максимальный размер очереди кодирования по разрешениям в виде "разрешение/размер очереди" |
transcoding_video_decoding_load | Интегральный показатель нагрузки декодирования |
transcoding_video_encoding_load | Интегральный показатель нагрузки кодирования |
Transcoding video full info | Подробная информация о транскодировании потоков (только в JSON формате) |
Buffer stats | Информация о выравнивающем буфере (только в JSON формате) |
CDN stats | Информация о CDN |
cdn_version | Версия CDN, поддерживаемая данным сервером |
cdn_role | Роль сервера в CDN |
cdn_group | Группа, в которую входит сервер |
Каждый параметр может быть запрошен отдельно, например
http://test.flashphoner.com:8081/?action=stat¶ms=native_resources
Статистику используемых ресурсов и информацию о нагрузке WCS-сервера, объединенную по группам, можно запросить по имени группы (доступны connections_stats, streams_stats, port_stats, call_stats, degraded_streams_stats, system_stats, core_stats)
http://test.flashphoner.com:8081/?action=stat&groups=call_stats
В запрос можно включить несколько наименований групп
http://test.flashphoner.com:8081/?action=stat&groups=call_stats,connections_stats
Параметры системы могут быть исключены из полной выборки при помощи настройки в файле flashphoner.properties
parse_system_stats=false
В этом случае параметры системы предоставляются только по запросу.
Форматы вывода статистики
По умолчанию, статистика выводится в plain text
Начиная со сборки 5.2.416, поддерживаются также форматы JSON и Prometheus. Для вывода статистики в формате JSON необходимо указать формат в URI запроса
curl -s 'http://localhost:8081/?action=stat&format=json'
Для вывода статистики в формате Prometheus необходимо указать формат в URI запроса
curl -s 'http://localhost:8081/?action=stat&format=prometheus'
Статистика транскодирования потоков
В сборке 5.2.443 добавлена возможность вывода краткой и подробной статистики транскодирования потоков. Краткая статистика группируется по разрешениям и доступна во всех форматах, например:
-----Transcoding info----- transcoding_video_decoding_resolutions=640x360/1 transcoding_video_decoding_average_time=640x360/2.0 transcoding_video_decoding_max_time=640x360/2 transcoding_video_decoding_average_queue_size=640x360/0.0 transcoding_video_decoding_max_queue_size=640x360/0 transcoding_video_encoding_resolutions=426x240/1;640x360/1;852x480/1 transcoding_video_encoding_average_time=426x240/2.0;640x360/2.0;852x480/6.0 transcoding_video_encoding_max_time=426x240/2;640x360/2;852x480/6 transcoding_video_encoding_average_queue_size=426x240/0.0;640x360/0.0;852x480/0.0 transcoding_video_encoding_max_queue_size=426x240/0;640x360/0;852x480/0
Здесь отображаются:
- разрешение и количество декодируемых и кодируемых потоков
- среднее и максимальное время декодирования и кодирования по разрешениям
- средний и максимальный размер очередей декодирования и кодирования
Подробная статистика выводится только в формате JSON, например
curl -s 'http://localhost:8081/?action=stat&format=json&groups=transcoding_stats' | jq
и группируется по опубликованным потокам
"transcoding_video_full_info": { "test1": { "codec": "H264", "queueSize": 0, "distributors": [ { "codec": "H264", "queueSize": 0, "resolution": "426x240", "averageProcessingTime": 3 }, { "codec": "H264", "queueSize": 0, "resolution": "640x360", "averageProcessingTime": 5 }, { "codec": "H264", "queueSize": 0, "resolution": "852x480", "averageProcessingTime": 10 } ], "resolution": "640x360", "averageProcessingTime": 3 } }
Здесь:
- codec - кодек потока
- queueSize - размер очереди
- resolution - разрешение потока
- averageProcessingTime - среднее время кодирования или декодирования
- distributors - параметры кодируемых (выходных) потоков
Интегральные показатели нагрузки транскодирования
В сборке 5.2.570 в статистику транскодирования добавлены интегральные показатели нагрузки декодирования и кодирования
-----Transcoding info----- ... transcoding_video_decoding_load=22118400 ... transcoding_video_encoding_load=7983360
Нагрузка декодирования рассчитывается следующим образом
transcoding_video_decoding_load = ∑ width * height * fps
Здесь
- width - ширина картинки декодируемого потока
- height - высота картинки декодируемого потока
- fps - FPS декодируемого потока
Нагрузка кодирования рассчитывается следующим образом
transcoding_video_encoding_load = ∑ width * height * fps
Здесь
- width - ширина картинки кодируемого потока согласно профилю
- height - высота картинки кодируемого потока согласно профилю
- fps - FPS заданный профилем кодирования, либо FPS транскодируемого (исходного) потока
Информация о CDN
В сборке 5.2.471 добавлен вывод информации о CDN, в которой участвует данный сервер
curl -s 'http://localhost:8081/?action=stat&groups=cdn_stats'
-----CDN info----- cdn_version=2.3 cdn_role=ORIGIN cdn_group=
Здесь:
cdn_version - версия CDN, поддерживаемая данным сервером
cdn_role - роль сервера в CDN
cdn_group - группа, к которой принадлежит сервер, либо пустая строка, если сервер не введен ни в одну группу
Синхронизация в опубликованных потоках
В сборке 5.2.508 в статистику потоков добавлен вывод информации о синхронизации аудио и видео в опубликованных потоках:
-----Stream Stats----- streams_synchronization=stream1/90,stream2/-11
Значение метрик вычисляется как разность между текущими значениями аудио и видео синхронизации
var metric = lastAudioSync - lastVideoSync;
Таким образом, положительное значение метрики показывает, что аудио в данный момент обгоняет видео, а отрицательное - что аудио отстает от видео.
Изменения данной метрики в небольших пределах являются нормой. Если метрика для потока остается высоким и постоянным по знаку, это может означать проблемы с данным потоком.
Информация о выравнивающих буферах
В сборке 5.2.543 добавлена возможность вывода информации об использовании выравнивающих буферов на выходе транскодеров. Информация доступна только в формате JSON
curl -s 'http://localhost:8081/?action=stat&format=json&groups=buffer_stats'
и группируется по транскодируемым потока и подписчикам на эти потоки
{ "buffer_stats": { "buffer_output_info": { "test": { "buffer_output_video_average": "0.0", "subscribers": { "25b94cd0-5eaf-11ea-a9b7-abda8d208547": { "overflows": 0, "buffer_output_audio": 4, "buffer_output_video": 0 }, ... }, "buffer_output_audio_average": "4.0" } } } }
Здесь
- buffer_output_audio_average - среднее количество аудио пакетов в буфере по всем подписчикам
- buffer_output_video_average - среднее количество видео пакетов в буфере по всем подписчикам
- buffer_output_audio - количество аудио пакетов в буфере для подписчика
- buffer_output_video - количество видео пакетов в буфере для подписчика
- overflows - количество переполнений буфера, при которых буфер очищается