Зв'язок операторів: SIP/WS і помилки підключення

1. Опис

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

Оновлюється автоматично кожні 10 секунд.

Складається з:

Фільтри: випадаючі списки «Команди», «Агенти», «Черги», «Вікно тривоги, хв», «Ліміт рядків»;
Блок показників поточного стану (6 блоків);
Таблиця «Агенти: SIP/WS прямо зараз»;
Графік «Підтверджені системні розриви по хвилинах»;
Графік «Неуспішні agent legs за причиною»;
Таблиця «Історія системних 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 прямо зараз»

Складається з колонок:

Колонка	Що означає
Агент / Agent ID	Імʼя і внутрішній ідентифікатор оператора
Команда	Команда, до якої належить оператор
Статус	Обчислений статус: `online`, `offline`, `break_out` тощо
Канал дзвінка	Стан голосового каналу: `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. Графік «Підтверджені системні розриви по хвилинах»

Стовпчиковий графік, згрупований по хвилинах. Серії WS, SIP і WS + SIP складені одна над одною, у легенді внизу — загальна кількість подій кожного типу за період.

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

1.5. Графік «Неуспішні agent legs за причиною»

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

Залежить від глобального періоду Grafana і фільтра «Черги». No data означає, що невдалих спроб за вибраний період не було.

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

Історія підтверджених системних відключень, один рядок на епізод. Залежить від глобального періоду 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. Решта потребує перевірки.