Логирование — различия между версиями
Материал из Oktell
| (не показано 10 промежуточных версии этого же участника) | |||
| Строка 1: | Строка 1: | ||
| − | [[ | + | [[Техническая документация | Наверх]] |
| + | |||
| + | __TOC__ | ||
=== Общие настройки. Управление сервером === | === Общие настройки. Управление сервером === | ||
| Строка 5: | Строка 7: | ||
<h4>Состав сервисного лог-журнала</h4> | <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 |
| − | * Conference - логирование конференц-связи | + | * 36.Conference - логирование конференц-связи |
| − | * IMMessaging - логирование сообщений | + | * 37.IMMessaging - логирование сообщений |
| − | * UserRequest | + | * 38.UserRequest |
<h4>Логирование счетчиков производительности</h4> | <h4>Логирование счетчиков производительности</h4> | ||
| Строка 64: | Строка 66: | ||
Базовыми считаются счетчики: общая загрузка процессора (0-100, %), объем доступной физической памяти (МБ), текущая очередь диска (0-10), процент использования файла подкачки. | Базовыми считаются счетчики: общая загрузка процессора (0-100, %), объем доступной физической памяти (МБ), текущая очередь диска (0-10), процент использования файла подкачки. | ||
| − | В качестве пользовательских могут быть указаны любые другие счетчики, существующие и доступные в системе. Для их указания используются специальные ключи файлов конфигурации: <add key="PerformanceCounter{0}" value="category|counter|instance"/> | + | В качестве пользовательских могут быть указаны любые другие счетчики, существующие и доступные в системе. Для их указания используются специальные ключи файлов конфигурации: |
| − | + | <add key="PerformanceCounter{0}" value="category|counter|instance"/> | |
| + | где {0} - числовой порядковый индекс счетчика производительности. В качестве значения для счетчика производительности, отслеживающего общую загрузку процессора, например, подставляется "''Processor|% Processor Time|_Total''". Для других счетчиков соответственно. | ||
<h4>Логирование использования ресурсов</h4> | <h4>Логирование использования ресурсов</h4> | ||
| Строка 75: | Строка 78: | ||
=== Параметры аппаратуры. Конфигурация=== | === Параметры аппаратуры. Конфигурация=== | ||
| − | В данном модуле можно включить и отключить логирование событий аппаратуры. По умолчанию, некоторые трассировки выключены. | + | В данном модуле можно включить и отключить логирование событий аппаратуры (папка \oktell\Server\Log\Hardware). По умолчанию, некоторые трассировки выключены. |
| − | * | + | * '''Во время работы системы''' логируются события, которые включены в модуле "'''параметры аппаратуры'''". |
| − | + | * '''В момент запуска системы''' логируются события, которые обозначены в серверном конфигурационном файле в ключе '''TRACE_HARDWARE''' | |
| − | * | + | |
| − | + | <add key="TRACE_HARDWARE" value="CALL EVENT PROTO WARNING ERROR" /> | |
| − | + | ||
| − | + | Ниже приводится описание параметров аппаратуры, соответствующих им ключей и описание. | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
{|cellpadding="10" cellspacing="0" border="1" | {|cellpadding="10" cellspacing="0" border="1" | ||
| Строка 105: | Строка 92: | ||
| Описание | | Описание | ||
|- | |- | ||
| + | | Общая трассировка | ||
| + | | 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) | Используются разработчиками для отладки системы. Рекомендуется всегда держать отключенными. |
Логирование сценариев
С помощью пункта Логирование указывается будет ли записывать в лог журнал выполнение компонентов данного сценария. Если сценарий отлажен, логирование можно выключить.
