Логирование

Материал из Oktell
Перейти к: навигация, поиск

Наверх

Общие настройки. Управление сервером

Состав сервисного лог-журнала

Сервисный лог включает в себя все этапы работы сервера логики. Данным параметром регулируется его состав: какие режимы и модули производят логирование, а какие нет. Параметр представляет собой строку, каждая из позиций которой содержит 0 или 1 и отвечает за включение логирования конкретного режима.

Сервисный лог нужен при обращении в тех.поддержку по проблемам, касающимся работы сервера. В обычном режиме его можно держать отключенным (или включенным неполностью), так как плотная работа сервера в непрерывном режиме может создавать файлы журнала в объеме до нескольких гигабайтов в сутки. Для отладки в реальном времени необходимо включить исследуемые режимы, произвести определенные действия, после чего вновь отключить. Сформированный файл в совокупности с другими журналами отправить в тех.поддержку. См. также модуль Сборка лог-журналов.

Значение позиций параметра в порядке следования

  • ProcedureShow
  • PBXSS
  • DB - логирование обращений в базу данных
  • HAL - логирование ядра
  • CallTaskManager
  • SmsTaskManager - логирование смс-сервиса.
  • SvcTaskManager - логирование служебных задач
  • AutoCallManager - логирование сервиса автодозвона
  • CallCenter - общее логирование Call-центра, имена операторов пропадут из задач.
  • CallPoolProgressive - логирование задач с прогрессивным обзвоном
  • CallPoolDistributed - логирование задач с ручным распределением
  • CallPoolReserved - логирование задач с закреплением абонента за оператором
  • CallPoolIncoming - логирование входящих задач
  • Searcher - логирование поиска оператора и абонента
  • CallHelper
  • TaskLogic
  • TALK - логирование диалоговых сценариев
  • SVC - логирование служебных сценариев
  • IVR - логирование IVR сценариев
  • IvrObjectReport - логирование объектов IVR
  • LineLogic
  • LineThreads
  • LLHWactions
  • Queue
  • QueueDebug пропадут подробности переключений
  • Timer - логирование таймеров
  • FlashTimer - логирование таймеров при переключении
  • ExtLines - логирование внешних линий
  • GetSetState
  • ShowHWActions
  • Threading
  • UserState - логирование состояний пользователя
  • DTMF - логирование полученных DTMF сигналов
  • Signals
  • MessageLoopReport
  • Conference - логирование конференц-связи
  • IMMessaging - логирование сообщений
  • UserRequest

Логирование счетчиков производительности

При активации в лог-журнал watcher сервера наравне с информацией о собственных процессах службы начинают фиксироваться стандартные счетчики производительности.

В зависимости от выбранного режима логируются значения базовых счетчиков, пользовательских счетчиков или и тех, и других вместе. Базовыми считаются счетчики: общая загрузка процессора (0-100, %), объем доступной физической памяти (МБ), текущая очередь диска (0-10), процент использования файла подкачки.

В качестве пользовательских могут быть указаны любые другие счетчики, существующие и доступные в системе. Для их указания используются специальные ключи файлов конфигурации: <add key="PerformanceCounter{0}" value="category|counter|instance"/>, где {0} - числовой порядковый индекс счетчика производительности. В качестве значения для счетчика производительности, отслеживающего общую загрузку процессора, например, подставляется "Processor|% Processor Time|_Total". Для других счетчиков соответственно.


Логирование использования ресурсов

С помощью параметра можно настроить вывод в лог журнал WATCHER информации по использованию процессом (процессами, в случае разделения) ресурсов системы. Объем используемой памяти, количество открытых дескрипторов, количество потоков, пользовательские системные ресурсы, ориентировочное среднее процессорное время по всему процессу и отдельно по всем его потокам.

Логирование сбоев тактирования таймера

С помощью параметра можно настроить вывод в лог журнал WATCHER информации по выделению процессорного времени потокам системы. Вместе с основной деятельностью сервер постоянно проводит проверочные замеры тестовым таймером и засекает задержки в выдаче управления. В случае если операционная система отказывает в выделении службе сервера процессорного времени, это происходит и с тестовым таймером. Существует возможность выставить границу для его логирования. Среди вариантов границы задержки в 20 мс, 100 мс, 500 мс, 1 с и 5 с. По умолчанию логируются все задержки более 100 мс. Увеличение и уменьшение значения может потребоваться проводить в случае запроса из технической поддержки в ходе работ над поиском причин заметного некорректного поведения сервера.

Параметры аппаратуры. Конфигурация

В данном модуле можно включить и отключить логирование событий аппаратуры (папка \oktell\Server\Log\Hardware). По умолчанию, некоторые трассировки выключены.


  • Во время работы системы логируются события, которые включены в модуле "параметры аппаратуры".
  • В момент запуска системы логируются события, которые обозначены в серверном конфигурационном файле в ключе TRACE_HARDWARE
<add key="TRACE_HARDWARE" value="CALL EVENT PROTO WARNING ERROR" />

Ниже приводится описание параметров аппаратуры, соответствующих им ключей и описание.

Параметры аппаратуры. Конфигурация. Файл конфигурации TRACE_HARDWARE Описание
Общая трассировка 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,2,3,4,5 FLAGxx (1-15) Используются разработчиками для отладки системы. Рекомендуется всегда держать отключенными.

Логирование сценариев

С помощью пункта Логирование указывается будет ли записывать в лог журнал выполнение компонентов данного сценария. Если сценарий отлажен, логирование можно выключить.