Логи Октелл нужны в двух ситуациях: когда вы сами ищете причину неисправности и когда обращаетесь в техническую поддержку. В обычной работе большая их часть должна быть выключена — иначе журналы съедят диск.
Сервисный лог сервера логики
Настраивается в Общие настройки → Управление сервером. Параметр «Состав сервисного лог-журнала» — это строка, где каждая позиция содержит 0 или 1 и включает логирование конкретного режима.
Что в каких позициях
| № | Режим | Что пишет |
|---|---|---|
| 1 | ProcedureShow | — |
| 2 | PBXSS | — |
| 3 | DB | Обращения к базе данных |
| 4 | HAL | Ядро системы |
| 5 | CallTaskManager | Управление задачами |
| 6 | SmsTaskManager | SMS-сервис |
| 7 | SvcTaskManager | Служебные задачи |
| 8 | AutoCallManager | Сервис автодозвона |
| 9 | CallCenter | Общее логирование call-центра |
| 10 | CallPoolProgressive | Задачи с прогрессивным обзвоном |
| 11 | CallPoolDistributed | Задачи с ручным распределением |
| 12 | CallPoolReserved | Задачи с закреплением абонента за оператором |
| 13 | CallPoolIncoming | Входящие задачи |
| 14 | Searcher | Поиск оператора и абонента |
| 15 | CallHelper | — |
| 16 | TaskLogic | — |
| 17 | TALK | Диалоговые сценарии |
| 18 | SVC | Служебные сценарии |
| 19 | IVR | Сценарии IVR |
| 20 | IvrObjectReport | Объекты IVR |
| 21 | LineLogic | — |
| 22 | LineThreads | — |
| 23 | LLHWactions | — |
| 24 | Queue | Очереди |
| 25 | QueueDebug | Подробности переключений |
| 26 | Timer | Таймеры |
| 27 | FlashTimer | Таймеры при переключении |
| 28 | ExtLines | Внешние линии |
| 29 | GetSetState | — |
| 30 | ShowHWActions | — |
| 31 | Threading | — |
| 32 | UserState | Состояния пользователя |
| 33 | DTMF | Полученные DTMF-сигналы |
| 34 | Signals | — |
| 35 | MessageLoopReport | — |
| 36 | Conference | Конференц-связь |
| 37 | IMMessaging | Сообщения |
| 38 | UserRequest | — |
Журнал WATCHER
Три отдельных параметра управляют тем, что пишется в журнал watcher.
Счётчики производительности
Можно логировать базовые счётчики, пользовательские или и те и другие. Базовые:
- общая загрузка процессора, 0–100%;
- объём доступной физической памяти в мегабайтах;
- текущая очередь диска, 0–10;
- процент использования файла подкачки.
Любой другой счётчик, доступный в системе, задаётся ключом конфигурационного файла:
<add key="PerformanceCounter{0}" value="category|counter|instance"/>Здесь {0} — порядковый номер счётчика. Например, для общей загрузки процессора значение будет Processor|% Processor Time|_Total.
Использование ресурсов
Выводит в watcher данные по потреблению ресурсов процессом: объём памяти, число открытых дескрипторов, число потоков, пользовательские системные ресурсы, среднее процессорное время по процессу целиком и отдельно по каждому потоку.
Сбои тактирования таймера
Сервер постоянно проводит контрольные замеры тестовым таймером и засекает задержки в выдаче управления. Если операционная система отказывает службе в процессорном времени, это видно по тестовому таймеру.
Граница логирования выбирается из вариантов: 20 мс, 100 мс, 500 мс, 1 с, 5 с. По умолчанию пишутся все задержки больше 100 мс.
Логи аппаратуры
Включаются и отключаются в модуле Параметры аппаратуры → Конфигурация, пишутся в каталог \oktell\Server\Log\Hardware. Часть трассировок по умолчанию выключена.
Есть важная тонкость: во время работы системы действуют настройки из модуля параметров аппаратуры, а в момент запуска — то, что указано в серверном конфигурационном файле:
<add key="TRACE_HARDWARE" value="CALL EVENT PROTO WARNING ERROR" />| Параметр в модуле | Ключ | Что пишет |
|---|---|---|
| Общая трассировка | CALL | Общее состояние системы |
| Трассировка событий аппаратуры | EVENTS | События аппаратуры или сети |
| Трассировка медиатрафика | MEDIA-FLOW | Аудио и видео, проходящие через сервер |
| Трассировка сетевых подключений | NET | Включение и отключение сетевых соединений |
| Трассировка пакетов SIP | PROTO | Печать SIP-пакетов. Лог trn |
| Трассировка таймеров | TIMER | События таймеров |
| Трассировка SIP-транзакций | TRANS | Приём и передача SIP-пакетов. Лог ua |
| Трассировка SIP-сессий | SESSION | Обработка SIP-запросов. Лог ua |
| Трассировка транков | TRUNK | Не используется |
| Трассировка медийных потоков | STREAM | События медиаканалов |
| Трассировка предупреждений | WARNING | Отказы с возможностью продолжить работу |
| Трассировка ошибок | ERRORS | Критические ошибки системы |
| Трассировка RTP-трафика | RTP-FLOW | Приём и передача RTP-пакетов |
| Трассировка сетевых атак | BANNED | Обнаружение атак на порты SIP. Лог trn |
| Трассировка RTP-потоков | RTP | События RTP-каналов |
| Трассировка асинхронных вызовов | ASYNC | Обработка команд в отдельных потоках |
| Трассировка факсов | FAX | События и пакеты факс-сеансов. Канальный лог |
| Трассировка 1–5 | FLAGxx (1–15) | Для отладки разработчиками |
Логирование сценариев
У каждого сценария есть собственный пункт «Логирование», определяющий, писать ли в журнал выполнение его компонентов. Отлаженный сценарий логировать не нужно — выключайте, чтобы не раздувать журналы.
Что отправлять в поддержку
Для обращения обычно нужен сервисный лог с включёнными режимами, относящимися к проблеме, плюс журналы аппаратуры за тот же период. Собрать их разом помогает модуль сборки лог-журналов — ему посвящена отдельная статья справки.