Связь операторов: SIP/WS и ошибки подключения

1. Описание

Дашборд для сетевой диагностики подключений операторов. Показывает, действительно ли оператор на связи (SIP-регистрация, WebSocket), перевела ли система его в offline из-за потери подключения, и какие попытки соединить с ним вызов не удались. Отвечает на вопрос «оператор online, а звонки и чаты на него не идут — почему».

Обновляется автоматически каждые 10 секунд.

Состоит из:

Фильтры: выпадающие списки «Команды», «Агенты», «Очереди», «Окно тревог, мин», «Лимит строк»;
Блок показателей текущего состояния (6 блоков);
Таблица «Агенты: SIP/WS прямо сейчас»;
График «Подтверждённые системные разрывы по минутам»;
График «Неуспешные agent legs по cause»;
Таблица «История системных auto-offline (WS/SIP)»;
Таблица «Неуспешные подключения к агентам — диагностический слой».

1.1. Выпадающие списки

Фильтр	Назначение
Команды	Выбор команд, информацию по которым нужно посмотреть
Агенты	Выбор операторов
Очереди	Выбор очередей. Влияет на панели неуспешных подключений
Окно тревог, мин	Интервал для блоков «Разрывы за окно» и «Ошибки agent leg за окно»: 5, 15, 30 или 60 минут. На остальные панели не влияет
Лимит строк	Максимальное количество строк, которое выводится в таблицах дашборда

1.2. Блок показателей текущего состояния

Блок	Что показывает	Цвета
Online / break_out	Количество операторов в статусе `online` или `break_out` — залогинены, независимо от того, принимают ли сейчас обращения. Текущее состояние, период Grafana на блок не влияет	Зелёный, если найден хотя бы один оператор; `0` — синий
Online без WS	Из операторов `online` / `break_out` — сколько сейчас без активного WebSocket-соединения.	`0` — зелёный; `1` и более — красный
Online без SIP	Из операторов `online` / `break_out` — сколько сейчас без активного SIP-соединения.	`0` — зелёный; `1` и более — красный
Auto-offline сейчас	Сколько операторов система прямо сейчас держит в offline из-за отсутствия WS или SIP (причины `system/ws`, `system/sip`, `system/ws/sip`). Это текущие незавершённые случаи, а не история за период	`0` — зелёный; `1` и более — красный
Разрывы за окно	Количество подтверждённых auto-offline событий за интервал, заданный фильтром «Окно тревог, мин». От глобального периода Grafana не зависит	`0` — зелёный; `1` и более — красный
Ошибки agent leg за окно	Количество неудачных попыток подключить вызов к оператору за тот же интервал. Учитываются `USER_NOT_REGISTERED`, `NO_USER_RESPONSE`, `NO_ANSWER`, `LOSE_RACE`, route/transport-ошибки, `GATEWAY_DOWN`, `NORMAL_TEMPORARY_FAILURE`	`0` — зелёный; `1` и более — оранжевый. Оранжевый, а не красный, потому что не каждая неудачная попытка подтверждает сетевой сбой

1.3. Таблица «Агенты: SIP/WS прямо сейчас»

image-20260805-080455-20260806-064605-20260812-090741.png

Состоит из колонок:

Колонка	Что означает
Агент / Agent ID	Имя и внутренний идентификатор оператора
Команда	Команда, к которой принадлежит оператор
Статус	Вычисленный статус: `online`, `offline`, `break_out` и т.д.
Канал call	Состояние голосового канала: `waiting`, `bridged`, `processing`, `wrap_time` и т.д.
WS	Состояние WebSocket-соединения: `CONNECTED` / `DISCONNECTED`
SIP	Состояние SIP-регистрации: `CONNECTED` / `DISCONNECTED`
Push	`ACTIVE`, если у оператора есть действующая мобильная Push-сессия Webitel, иначе пусто. Означает только, что приложение можно разбудить пушем: не подтверждает подключение по SIP или WS и не гарантирует доставку конкретного сообщения
Диагностика	Итоговая оценка состояния: `OK`, `WARNING` или `CRITICAL` с причиной (например, `CRITICAL: auto-offline`)
Статус с / Канал с	Время последнего изменения статуса и, отдельно, канала звонка
Последний WS / Последний SIP	Время последней активности по WebSocket и по SIP
Причина статуса	Технический payload (например, `system/ws/sip` — статус выставила система из-за одновременного разрыва WS и SIP)

Строки отсортированы: сначала CRITICAL, затем WARNING, затем OK; внутри группы — по команде и имени оператора.

Таблица показывает текущее состояние, поэтому глобальный период Grafana («Сегодня», «Last 6 hours») её не фильтрует. Дата в прошлом в колонках «Последний WS» и «Последний SIP» означает, что с того момента активности по этому подключению не было — это не ошибка отображения.

1.4. График «Подтверждённые системные разрывы по минутам»

image-20260804-071654-20260806-064632-20260812-090744.png

Столбчатый график, сгруппированный по минутам. Серии WS, SIP и WS + SIP сложены друг над другом, в легенде внизу — общее количество событий каждого типа за период.

Зависит от глобального периода Grafana. No data означает, что подтверждённых системных разрывов за выбранный период не было.

1.5. График «Неуспешные agent legs по cause»

Столбчатый график неудачных попыток подключить вызов к оператору, сгруппированный по минутам и причине завершения. У каждой причины свой цвет: USER_NOT_REGISTERED, NO_ANSWER, NO_USER_RESPONSE, LOSE_RACE, route/transport-причины и другие.

Зависит от глобального периода Grafana и фильтра «Очереди». No data означает, что неудачных попыток за выбранный период не было.

1.6. Таблица «История системных auto-offline (WS/SIP)»

image-20260805-080511-20260806-064618-20260812-090749.png

История подтверждённых системных отключений, одна строка на эпизод. Зависит от глобального периода Grafana.

Состоит из колонок:

Колонка	Что означает
Начало / Окончание	Время начала и завершения эпизода
Длительность, сек	Длительность эпизода. Для `ONGOING` считается от начала offline до текущего момента, для `ENDED` — до восстановления подключения или следующего изменения статуса. Несмотря на подпись «сек», значение выводится в удобных единицах: секунды, минуты, часы или недели
Агент / Agent ID	Оператор, которого касается эпизод
Команда	Команда оператора
Разрыв	Что именно разорвалось: `WS`, `SIP` или `WS + SIP`
Payload	Технический тег причины
Состояние	`ONGOING` — эпизод ещё длится; `ENDED` — завершился

1.7. Таблица «Неуспешные подключения к агентам — диагностический слой»

Детальный перечень неудачных попыток соединить вызов с оператором (agent leg), одна строка на попытку. Раздел, в который стоит заходить после срабатывания блока «Ошибки agent leg за окно».

Зависит от глобального периода Grafana и фильтра «Очереди». No data означает, что за выбранный период и очередь таких попыток не было.

Состоит из колонок:

Колонка	Что означает
Время / Агент / Команда / Очередь	Когда, к кому и из какой очереди была попытка
Cause	Код причины завершения agent leg
SIP code	SIP-код ответа
Attempt ID / Agent Call ID	Идентификаторы попытки распределения и звонка на стороне оператора
Диагностика	Интерпретация причины (см. ниже)

Значения колонки «Диагностика»:

Значение	Что означает
`CONFIRMED: SIP not registered`	SIP оператора не был зарегистрирован в момент попытки
`LIKELY: route/transport failure`	Вероятная проблема маршрутизации или транспорта
`POSSIBLE: endpoint did not answer`	Устройство оператора не ответило
`INDIRECT: race/bridge failure`	Косвенный признак, сам по себе не доказывает сетевой сбой. Сюда относится `LOSE_RACE`
`OTHER`	Иная причина

Однозначно подтверждает проблему с подключением оператора только значение CONFIRMED. Остальные требуют проверки.