Логирование — различия между версиями
(не показано 17 промежуточных версии этого же участника) | |||
Строка 1: | Строка 1: | ||
+ | [[Техническая документация | Наверх]] | ||
+ | |||
+ | __TOC__ | ||
+ | |||
=== Общие настройки. Управление сервером === | === Общие настройки. Управление сервером === | ||
− | Состав сервисного лог-журнала | + | <h4>Состав сервисного лог-журнала</h4> |
− | Сервисный лог включает в себя все этапы работы сервера логики. Данным параметром регулируется его состав: какие режимы и модули производят логирование, а какие нет. Параметр представляет собой строку, каждая из позиций которой содержит | + | |
− | Сервисный лог нужен при обращении в тех.поддержку по проблемам, касающимся работы сервера. В обычном режиме его можно держать отключенным (или включенным неполностью), так как плотная работа сервера в непрерывном режиме может создавать файлы журнала в объеме до нескольких гигабайтов в сутки. Для отладки в реальном времени необходимо включить исследуемые режимы, произвести определенные действия, после чего вновь отключить. Сформированный файл в совокупности с другими журналами отправить в тех.поддержку. См. также модуль Сборка лог-журналов. | + | '''Сервисный лог''' включает в себя все этапы работы сервера логики. Данным параметром регулируется его состав: какие режимы и модули производят логирование, а какие нет. Параметр представляет собой строку, каждая из позиций которой содержит '''0''' или '''1''' и отвечает за включение логирования конкретного режима. |
+ | |||
+ | Сервисный лог нужен при обращении в тех.поддержку по проблемам, касающимся работы сервера. В обычном режиме его можно держать отключенным (или включенным неполностью), так как плотная работа сервера в непрерывном режиме может создавать файлы журнала в объеме до нескольких гигабайтов в сутки. Для отладки в реальном времени необходимо включить исследуемые режимы, произвести определенные действия, после чего вновь отключить. Сформированный файл в совокупности с другими журналами отправить в тех.поддержку. См. также модуль '''Сборка лог-журналов'''. | ||
Значение позиций параметра в порядке следования | Значение позиций параметра в порядке следования | ||
− | * ProcedureShow | + | * 1. ProcedureShow |
− | * PBXSS | + | * 2.PBXSS |
− | * DB - логирование обращений в базу данных | + | * 3.DB - логирование обращений в базу данных |
− | * HAL - логирование ядра | + | * 4.HAL - логирование ядра |
− | * CallTaskManager | + | * 5.CallTaskManager - управление задачами |
− | * SmsTaskManager - логирование смс-сервиса. | + | * 6.SmsTaskManager - логирование смс-сервиса. |
− | * SvcTaskManager - логирование служебных задач | + | * 7.SvcTaskManager - логирование служебных задач |
− | * AutoCallManager - логирование сервиса автодозвона | + | * 8.AutoCallManager - логирование сервиса автодозвона |
− | * CallCenter - общее логирование Call-центра, имена операторов пропадут из задач. | + | * 9.CallCenter - общее логирование Call-центра, имена операторов пропадут из задач. |
− | * CallPoolProgressive - логирование задач с прогрессивным обзвоном | + | * 10.CallPoolProgressive - логирование задач с прогрессивным обзвоном |
− | * CallPoolDistributed - логирование задач с ручным распределением | + | * 11.CallPoolDistributed - логирование задач с ручным распределением |
− | * CallPoolReserved - логирование задач с закреплением абонента за оператором | + | * 12.CallPoolReserved - логирование задач с закреплением абонента за оператором |
− | * CallPoolIncoming - логирование входящих задач | + | * 13.CallPoolIncoming - логирование входящих задач |
− | * Searcher - логирование поиска оператора и абонента | + | * 14.Searcher - логирование поиска оператора и абонента |
− | * CallHelper | + | * 15.CallHelper |
− | * TaskLogic | + | * 16.TaskLogic |
− | * TALK - логирование диалоговых сценариев | + | * 17.TALK - логирование диалоговых сценариев |
− | * SVC - логирование служебных сценариев | + | * 18.SVC - логирование служебных сценариев |
− | * IVR - логирование IVR сценариев | + | * 19.IVR - логирование IVR сценариев |
− | * IvrObjectReport - логирование объектов IVR | + | * 20.IvrObjectReport - логирование объектов IVR |
− | * LineLogic | + | * 21.LineLogic |
− | * LineThreads | + | * 22.LineThreads |
− | * LLHWactions | + | * 23.LLHWactions |
− | * Queue | + | * 24.Queue |
− | * QueueDebug пропадут подробности переключений | + | * 25.QueueDebug пропадут подробности переключений |
− | * Timer - логирование таймеров | + | * 26.Timer - логирование таймеров |
− | * FlashTimer - логирование таймеров при переключении | + | * 27.FlashTimer - логирование таймеров при переключении |
− | * ExtLines - логирование внешних линий | + | * 28.ExtLines - логирование внешних линий |
− | * GetSetState | + | * 29.GetSetState |
− | * ShowHWActions | + | * 30.ShowHWActions |
− | * Threading | + | * 31.Threading |
− | * UserState - логирование состояний пользователя | + | * 32.UserState - логирование состояний пользователя |
− | * DTMF - логирование полученных DTMF сигналов | + | * 33.DTMF - логирование полученных DTMF сигналов |
− | * Signals | + | * 34.Signals |
− | * MessageLoopReport | + | * 35.MessageLoopReport |
+ | |||
+ | * 36.Conference - логирование конференц-связи | ||
+ | * 37.IMMessaging - логирование сообщений | ||
+ | * 38.UserRequest | ||
+ | |||
+ | <h4>Логирование счетчиков производительности</h4> | ||
− | |||
− | |||
− | |||
− | |||
− | |||
При активации в лог-журнал watcher сервера наравне с информацией о собственных процессах службы начинают фиксироваться стандартные счетчики производительности. | При активации в лог-журнал watcher сервера наравне с информацией о собственных процессах службы начинают фиксироваться стандартные счетчики производительности. | ||
+ | |||
В зависимости от выбранного режима логируются значения базовых счетчиков, пользовательских счетчиков или и тех, и других вместе. | В зависимости от выбранного режима логируются значения базовых счетчиков, пользовательских счетчиков или и тех, и других вместе. | ||
Базовыми считаются счетчики: общая загрузка процессора (0-100, %), объем доступной физической памяти (МБ), текущая очередь диска (0-10), процент использования файла подкачки. | Базовыми считаются счетчики: общая загрузка процессора (0-100, %), объем доступной физической памяти (МБ), текущая очередь диска (0-10), процент использования файла подкачки. | ||
− | |||
− | Логирование использования ресурсов | + | В качестве пользовательских могут быть указаны любые другие счетчики, существующие и доступные в системе. Для их указания используются специальные ключи файлов конфигурации: |
+ | <add key="PerformanceCounter{0}" value="category|counter|instance"/> | ||
+ | где {0} - числовой порядковый индекс счетчика производительности. В качестве значения для счетчика производительности, отслеживающего общую загрузку процессора, например, подставляется "''Processor|% Processor Time|_Total''". Для других счетчиков соответственно. | ||
+ | |||
+ | <h4>Логирование использования ресурсов</h4> | ||
С помощью параметра можно настроить вывод в лог журнал WATCHER информации по использованию процессом (процессами, в случае разделения) ресурсов системы. Объем используемой памяти, количество открытых дескрипторов, количество потоков, пользовательские системные ресурсы, ориентировочное среднее процессорное время по всему процессу и отдельно по всем его потокам. | С помощью параметра можно настроить вывод в лог журнал WATCHER информации по использованию процессом (процессами, в случае разделения) ресурсов системы. Объем используемой памяти, количество открытых дескрипторов, количество потоков, пользовательские системные ресурсы, ориентировочное среднее процессорное время по всему процессу и отдельно по всем его потокам. | ||
− | Логирование сбоев тактирования таймера | + | <h4>Логирование сбоев тактирования таймера</h4> |
С помощью параметра можно настроить вывод в лог журнал WATCHER информации по выделению процессорного времени потокам системы. Вместе с основной деятельностью сервер постоянно проводит проверочные замеры тестовым таймером и засекает задержки в выдаче управления. В случае если операционная система отказывает в выделении службе сервера процессорного времени, это происходит и с тестовым таймером. Существует возможность выставить границу для его логирования. Среди вариантов границы задержки в 20 мс, 100 мс, 500 мс, 1 с и 5 с. По умолчанию логируются все задержки более 100 мс. Увеличение и уменьшение значения может потребоваться проводить в случае запроса из технической поддержки в ходе работ над поиском причин заметного некорректного поведения сервера. | С помощью параметра можно настроить вывод в лог журнал WATCHER информации по выделению процессорного времени потокам системы. Вместе с основной деятельностью сервер постоянно проводит проверочные замеры тестовым таймером и засекает задержки в выдаче управления. В случае если операционная система отказывает в выделении службе сервера процессорного времени, это происходит и с тестовым таймером. Существует возможность выставить границу для его логирования. Среди вариантов границы задержки в 20 мс, 100 мс, 500 мс, 1 с и 5 с. По умолчанию логируются все задержки более 100 мс. Увеличение и уменьшение значения может потребоваться проводить в случае запроса из технической поддержки в ходе работ над поиском причин заметного некорректного поведения сервера. | ||
=== Параметры аппаратуры. Конфигурация=== | === Параметры аппаратуры. Конфигурация=== | ||
+ | |||
+ | В данном модуле можно включить и отключить логирование событий аппаратуры (папка \oktell\Server\Log\Hardware). По умолчанию, некоторые трассировки выключены. | ||
+ | |||
+ | * '''Во время работы системы''' логируются события, которые включены в модуле "'''параметры аппаратуры'''". | ||
+ | * '''В момент запуска системы''' логируются события, которые обозначены в серверном конфигурационном файле в ключе '''TRACE_HARDWARE''' | ||
+ | |||
+ | <add key="TRACE_HARDWARE" value="CALL EVENT PROTO WARNING ERROR" /> | ||
+ | |||
+ | Ниже приводится описание параметров аппаратуры, соответствующих им ключей и описание. | ||
+ | |||
+ | {|cellpadding="10" cellspacing="0" border="1" | ||
+ | |Параметры аппаратуры. Конфигурация. | ||
+ | | Файл конфигурации 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) | ||
+ | | Используются разработчиками для отладки системы. '''Рекомендуется всегда держать отключенными.''' | ||
+ | |- | ||
+ | |} | ||
=== Логирование сценариев === | === Логирование сценариев === | ||
+ | |||
+ | С помощью пункта '''Логирование''' указывается будет ли записывать в лог журнал выполнение компонентов данного сценария. Если сценарий отлажен, логирование можно выключить. |
Текущая версия на 09:25, 17 декабря 2014
Содержание
Общие настройки. Управление сервером
Состав сервисного лог-журнала
Сервисный лог включает в себя все этапы работы сервера логики. Данным параметром регулируется его состав: какие режимы и модули производят логирование, а какие нет. Параметр представляет собой строку, каждая из позиций которой содержит 0 или 1 и отвечает за включение логирования конкретного режима.
Сервисный лог нужен при обращении в тех.поддержку по проблемам, касающимся работы сервера. В обычном режиме его можно держать отключенным (или включенным неполностью), так как плотная работа сервера в непрерывном режиме может создавать файлы журнала в объеме до нескольких гигабайтов в сутки. Для отладки в реальном времени необходимо включить исследуемые режимы, произвести определенные действия, после чего вновь отключить. Сформированный файл в совокупности с другими журналами отправить в тех.поддержку. См. также модуль Сборка лог-журналов.
Значение позиций параметра в порядке следования
- 1. ProcedureShow
- 2.PBXSS
- 3.DB - логирование обращений в базу данных
- 4.HAL - логирование ядра
- 5.CallTaskManager - управление задачами
- 6.SmsTaskManager - логирование смс-сервиса.
- 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 сервера наравне с информацией о собственных процессах службы начинают фиксироваться стандартные счетчики производительности.
В зависимости от выбранного режима логируются значения базовых счетчиков, пользовательских счетчиков или и тех, и других вместе. Базовыми считаются счетчики: общая загрузка процессора (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) | Используются разработчиками для отладки системы. Рекомендуется всегда держать отключенными. |
Логирование сценариев
С помощью пункта Логирование указывается будет ли записывать в лог журнал выполнение компонентов данного сценария. Если сценарий отлажен, логирование можно выключить.