Логирование — различия между версиями

Материал из Oktell
Перейти к: навигация, поиск
 
(не показано 17 промежуточных версии этого же участника)
Строка 1: Строка 1:
 +
[[Техническая документация | Наверх]]
 +
 +
__TOC__
 +
 
=== Общие настройки. Управление сервером ===
 
=== Общие настройки. Управление сервером ===
 
   
 
   
Состав сервисного лог-журнала
+
<h4>Состав сервисного лог-журнала</h4>
Сервисный лог включает в себя все этапы работы сервера логики. Данным параметром регулируется его состав: какие режимы и модули производят логирование, а какие нет. Параметр представляет собой строку, каждая из позиций которой содержит «0» или «1» и отвечает за включение логирования конкретного режима.
+
 
Сервисный лог нужен при обращении в тех.поддержку по проблемам, касающимся работы сервера. В обычном режиме его можно держать отключенным (или включенным неполностью), так как плотная работа сервера в непрерывном режиме может создавать файлы журнала в объеме до нескольких гигабайтов в сутки. Для отладки в реальном времени необходимо включить исследуемые режимы, произвести определенные действия, после чего вновь отключить. Сформированный файл в совокупности с другими журналами отправить в тех.поддержку. См. также модуль Сборка лог-журналов.
+
'''Сервисный лог''' включает в себя все этапы работы сервера логики. Данным параметром регулируется его состав: какие режимы и модули производят логирование, а какие нет. Параметр представляет собой строку, каждая из позиций которой содержит '''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>
  
* Conference - логирование конференц-связи         
 
* IMMessaging - логирование сообщений       
 
* UserRequest 
 
           
 
Логирование счетчиков производительности
 
 
При активации в лог-журнал watcher сервера наравне с информацией о собственных процессах службы начинают фиксироваться стандартные счетчики производительности.
 
При активации в лог-журнал watcher сервера наравне с информацией о собственных процессах службы начинают фиксироваться стандартные счетчики производительности.
 +
 
В зависимости от выбранного режима логируются значения базовых счетчиков, пользовательских счетчиков или и тех, и других вместе.
 
В зависимости от выбранного режима логируются значения базовых счетчиков, пользовательских счетчиков или и тех, и других вместе.
 
Базовыми считаются счетчики: общая загрузка процессора (0-100, %), объем доступной физической памяти (МБ), текущая очередь диска (0-10), процент использования файла подкачки.
 
Базовыми считаются счетчики: общая загрузка процессора (0-100, %), объем доступной физической памяти (МБ), текущая очередь диска (0-10), процент использования файла подкачки.
В качестве пользовательских могут быть указаны любые другие счетчики, существующие и доступные в системе. Для их указания используются специальные ключи файлов конфигурации: <add key="PerformanceCounter{0}" value="category|counter|instance"/>, где {0} - числовой порядковый индекс счетчика производительности. В качестве значения для счетчика производительности, отслеживающего общую загрузку процессора, например, подставляется "Processor|% Processor Time|_Total". Для других счетчиков соответственно.
 
  
Логирование использования ресурсов
+
В качестве пользовательских могут быть указаны любые другие счетчики, существующие и доступные в системе. Для их указания используются специальные ключи файлов конфигурации:
 +
<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) Используются разработчиками для отладки системы. Рекомендуется всегда держать отключенными.

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

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