Логирование — различия между версиями
Материал из Oktell
(Новая страница: «=== Общие настройки. Управление сервером === Состав сервисного лог-журнала Сервисный лог вк...») |
|||
| (не показано 18 промежуточных версии этого же участника) | |||
| Строка 1: | Строка 1: | ||
| + | [[Техническая документация | Наверх]] | ||
| + | |||
| + | __TOC__ | ||
| + | |||
=== Общие настройки. Управление сервером === | === Общие настройки. Управление сервером === | ||
| − | Состав сервисного лог-журнала | + | <h4>Состав сервисного лог-журнала</h4> |
| − | Сервисный лог включает в себя все этапы работы сервера логики. Данным параметром регулируется его состав: какие режимы и модули производят логирование, а какие нет. Параметр представляет собой строку, каждая из позиций которой содержит | + | |
| − | Сервисный лог нужен при обращении в тех.поддержку по проблемам, касающимся работы сервера. В обычном режиме его можно держать отключенным (или включенным неполностью), так как плотная работа сервера в непрерывном режиме может создавать файлы журнала в объеме до нескольких гигабайтов в сутки. Для отладки в реальном времени необходимо включить исследуемые режимы, произвести определенные действия, после чего вновь отключить. Сформированный файл в совокупности с другими журналами отправить в тех.поддержку. См. также модуль Сборка лог-журналов. | + | '''Сервисный лог''' включает в себя все этапы работы сервера логики. Данным параметром регулируется его состав: какие режимы и модули производят логирование, а какие нет. Параметр представляет собой строку, каждая из позиций которой содержит '''0''' или '''1''' и отвечает за включение логирования конкретного режима. |
| + | |||
| + | Сервисный лог нужен при обращении в тех.поддержку по проблемам, касающимся работы сервера. В обычном режиме его можно держать отключенным (или включенным неполностью), так как плотная работа сервера в непрерывном режиме может создавать файлы журнала в объеме до нескольких гигабайтов в сутки. Для отладки в реальном времени необходимо включить исследуемые режимы, произвести определенные действия, после чего вновь отключить. Сформированный файл в совокупности с другими журналами отправить в тех.поддержку. См. также модуль '''Сборка лог-журналов'''. | ||
Значение позиций параметра в порядке следования | Значение позиций параметра в порядке следования | ||
| − | 1. ProcedureShow | + | * 1. ProcedureShow |
| − | 2. PBXSS | + | * 2.PBXSS |
| − | 3. DB - логирование обращений в базу данных | + | * 3.DB - логирование обращений в базу данных |
| − | 4. HAL - логирование ядра | + | * 4.HAL - логирование ядра |
| − | 5. CallTaskManager | + | * 5.CallTaskManager - управление задачами |
| − | 6. SmsTaskManager - логирование смс-сервиса. | + | * 6.SmsTaskManager - логирование смс-сервиса. |
| − | 7. SvcTaskManager - логирование служебных задач | + | * 7.SvcTaskManager - логирование служебных задач |
| − | 8. AutoCallManager - логирование сервиса автодозвона | + | * 8.AutoCallManager - логирование сервиса автодозвона |
| − | 9. CallCenter - общее логирование Call-центра, имена операторов пропадут из задач. | + | * 9.CallCenter - общее логирование Call-центра, имена операторов пропадут из задач. |
| − | 10.CallPoolProgressive - логирование задач с прогрессивным обзвоном | + | * 10.CallPoolProgressive - логирование задач с прогрессивным обзвоном |
| − | 11.CallPoolDistributed - логирование задач с ручным распределением | + | * 11.CallPoolDistributed - логирование задач с ручным распределением |
| − | 12.CallPoolReserved - логирование задач с закреплением абонента за оператором | + | * 12.CallPoolReserved - логирование задач с закреплением абонента за оператором |
| − | 13.CallPoolIncoming - логирование входящих задач | + | * 13.CallPoolIncoming - логирование входящих задач |
| − | 14.Searcher - логирование поиска оператора и абонента | + | * 14.Searcher - логирование поиска оператора и абонента |
| − | 15.CallHelper | + | * 15.CallHelper |
| − | 16.TaskLogic | + | * 16.TaskLogic |
| − | 17.TALK - логирование диалоговых сценариев | + | * 17.TALK - логирование диалоговых сценариев |
| − | 18.SVC - логирование служебных сценариев | + | * 18.SVC - логирование служебных сценариев |
| − | 19.IVR - логирование IVR сценариев | + | * 19.IVR - логирование IVR сценариев |
| − | 20.IvrObjectReport - логирование объектов IVR | + | * 20.IvrObjectReport - логирование объектов IVR |
| − | 21.LineLogic | + | * 21.LineLogic |
| − | 22.LineThreads | + | * 22.LineThreads |
| − | 23.LLHWactions | + | * 23.LLHWactions |
| − | 24.Queue | + | * 24.Queue |
| − | 25.QueueDebug пропадут подробности переключений | + | * 25.QueueDebug пропадут подробности переключений |
| − | 26.Timer - логирование таймеров | + | * 26.Timer - логирование таймеров |
| − | 27.FlashTimer - логирование таймеров при переключении | + | * 27.FlashTimer - логирование таймеров при переключении |
| − | 28.ExtLines - логирование внешних линий | + | * 28.ExtLines - логирование внешних линий |
| − | 29.GetSetState | + | * 29.GetSetState |
| − | 30.ShowHWActions | + | * 30.ShowHWActions |
| − | 31.Threading | + | * 31.Threading |
| − | 32.UserState - логирование состояний пользователя | + | * 32.UserState - логирование состояний пользователя |
| − | 33.DTMF - логирование полученных DTMF сигналов | + | * 33.DTMF - логирование полученных DTMF сигналов |
| − | 34.Signals | + | * 34.Signals |
| − | 35.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) | Используются разработчиками для отладки системы. Рекомендуется всегда держать отключенными. |
Логирование сценариев
С помощью пункта Логирование указывается будет ли записывать в лог журнал выполнение компонентов данного сценария. Если сценарий отлажен, логирование можно выключить.
