CommuniGate Pro
Версия 5.2
Администрирование
 
 
Журналы

Системные Журналы Сервера

Все компоненты Сервера CommuniGate Pro сохраняют сообщения о своей работе в общем Журнале.
Каждая запись содержит отметку о времени, уровень журнала, метку, идентифицирующую компонент, создавший эту запись и непосредственно саму запись.

Журналы CommuniGate Pro - это текстовые файлы, и они могут обрабатываться любой программой для обработки текстовых файлов.

Когда вы отправляете запрос об оказании поддержки в Техническую Поддержку CommuniGate Systems, всегда представляйте соответствующую часть Журнала, содержащую записи, свидетельствующие о проблеме.

Создание и Удаление файлов Журнала

Используйте Веб Интерфейс Администратора для анализа Журналов Сервера. Откройте страницу Журналы в области Наблюдение. Появится список сохраненных Журналов. Текущий Журнал помечен символом звездочка (*).

Для просмотра Журналов вы должны иметь право доступа на Сервер "Может наблюдать за Сервером".

Опции наверху страницы позволяют вам указать, когда следует создавать и удалять файлы Журнала:

Установки Генератора Журналов
Начинать Новый Файл Каждые: или если больше:
Стирать Старые Файлы Через: Точность Времени:
Внешний Сервер Журнала Отсылаемые Записи: Адрес Сервера:
  Код Службы:  
 
Начинать Новый Файл
Новый файл создаётся автоматически, каждые сутки (в полночь) или чаще, согласно значению этой опции.
или если больше
Новый файл Журнала также создаётся, если размер файла Журнала превышает указанный лимит.

Файлы Журнала создаются в поддиректории SystemLogs директории данных Сервера.

Стирать Старые Файлы
Вскоре после создания нового файла Журнала, Сервер проверяет все файлы в поддиректории SystemLogs, и удаляет все файлы, имеющие время создания более ранее, чем указано в этой настройке.
Точность Времени
Эта настройка указывает сколько цифр должно использоваться в Отметки о времени в Журнале для долей секунд.
Внешний Сервер Журнала
Пожалуйста, смотрите раздел Отправка на Удалённые Сервера.

Вы должны иметь Право Доступа Может наблюдать за Сервером"Может менять установки Генератора Журналов" для изменения настроек Генератора Журналов.

Вы можете выбрать один или несколько Журналов из списка и затем удалить их, используя кнопку Удалить Помеченные. Активный (текущий) файл Журнала не может быть удалён.

Вы должны иметь Право Доступа Может наблюдать за Сервером и "Может менять установки Генератора Журналов" для удаления Журналов.

Если на Сервере находится слишком много файлов Журнала, то вы можете ввести строку в поле Фильтр и нажать на кнопке Показать: будут показываться только те Журналы, имена которых соответствуют строке в поле Фильтр:

Фильтр: Показано 11 из 11
 ИмяРазмер
voicemail_prompt355K
*2006-12-07_14-395974K
2006-12-0731M
2006-12-06_23-205707K
2006-12-06_13-1931M
2006-12-06_02-0531M
2006-12-06_00-5431M
2006-12-06_00-5231M
2006-12-06_00-4931M
2006-12-06_00-4831M
2006-12-06_00-4631M

Нажмите на имя файла Журнала для того что бы открыть его.


Задание Интервала Времени

Когда Журнал появляется в окне вашего браузера, то показываются все записи Журнала. Так как в Журналах могут содержаться тысячи записей, то, возможно, вам потребуется просмотреть только часть Журнала. Для того, что бы прервать процесс загрузки Журнала и задать Уровень Журнала и Интервал Времени:

Уровень Журнала: В новом окне
  Фильтр: По ключуRegEx
Время Сервера: 16:41:53  Интервал: -

Отображаются только записи из указанного временного интервала.

Если вы просматриваете текущий Журнал и указываете "*" во втором поле, то показываются все записи, помещенные в журнал к этому моменту.

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


Фильтрование записей Журнала

Журналы CommuniGate Pro могут быть очень большими - на высоконагруженном Сервере, или на Сервере с Уровнем Журнала, установленном в значение Всё, они могут достигать размера в сотни мегабайт.
Сложно анализировать весь Журнал такого размера.

Уровень Журнала
Используйте эту настройку для того, что бы скрыть более подробные, чем указано здесь, записи (то есть записи, имеющие более высокий Уровень Журнала).
Фильтр
Используйте эту опцию для задания строки-фильтра записей. Будут показаны только те записи, которые содержат эту строку.
Первая часть записей журнала (включая отметку о времени и маркер Уровня Журнала) не используются при фильтровании.
RegEx
Если эта опция выбрана, то строка-фильтр интерпретируется как регулярное выражение.

Нажмите на кнопку Показать что бы отобразить только те записи, которые содержат указанную подстроку.

Пример:

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

Так как это случается редко, то вы должны задать в IMAP модуле Уровень Журнала Всё, хотя это и сделает ваши Журналы очень большими. В какой-то момент пользователь обратился к вам и сказал, что его почтовая программа только что выдала такую же ошибку.

Вы открываете Журнал и устанавливаете Уровень Журнала в 3 (Проблемы). Теперь вы видите все проблемы, происшедшие сегодня в работе IMAP модуля. Когда вы видите запись, которая свидетельствует о проблеме, о которой говорил пользователь, вы видите, что эта запись имеет метку IMAP-437425. Теперь, введите IMAP-437425 в поле Фильтр, и измените Уровень Журнала на 5 (Всё). В результате вы увидите чистый журнал именно этой сессии IMAP.

Уровень Журнала: В новом окне
  Фильтр: По ключуRegEx
Время Сервера: 16:41:53  Интервал: -
00:06:23.261 4 IMAP-437425([64.173.55.175]) got connection on [64.173.55.169:143](mail.communigate.com) fr
00:06:23.261 5 IMAP-437425([64.173.55.175]) out: * OK CommuniGate Pro IMAP Server 5.1.8 at mail.commun
00:06:23.261 5 IMAP-437425([64.173.55.175]) inp: 1 CAPABILITY
00:06:23.261 5 IMAP-437425([64.173.55.175]) out: * CAPABILITY IMAP4 IMAP4REV1 ACL NAMESPACE UIDPLUS ID
00:06:23.266 5 IMAP-437425([64.173.55.175]) inp: 2 AUTHENTICATE METHOD AAAAAAAAAAAAAAAAAAAAAA=
00:06:23.268 2 IMAP-437425([64.173.55.175]) 'user@domain.com' connected from [64.173.55.175:31358]
00:06:23.268 5 IMAP-437425([64.173.55.175]) out: 2 OK completed\r\n
00:06:23.269 5 IMAP-437425([64.173.55.175]) inp: 3 LIST "" "*"
00:06:23.269 5 IMAP-437425([64.173.55.175]) out: * LIST (\UnMarked) "/" Calendar\r\n* LIST (\Marked) "
00:06:23.279 5 IMAP-437425([64.173.55.175]) inp: 4 SELECT "Tasks"
00:06:23.270 5 IMAP-437425([64.173.55.175]) out: * FLAGS (\Answered \Flagged \Deleted \Seen \Draft $MD
00:06:23.272 5 IMAP-437425([64.173.55.175]) inp: 5 UID SEARCH NOT DELETED
00:06:23.272 5 IMAP-437425([64.173.55.175]) out: * SEARCH 32 49 76 84 94 96 98 100 101 102 113 116 117
00:06:23.275 5 IMAP-437425([64.173.55.175]) inp: 6 UID FETCH 193 (BODYSTRUCTURE FLAGS)
00:06:23.275 5 IMAP-437425([64.173.55.175]) out: * 35 FETCH (BODYSTRUCTURE (("text" "calendar" ("chars
00:06:23.278 5 IMAP-437425([64.173.55.175]) inp: 7 UID FETCH 193 (BODY.PEEK[HEADER])
00:06:23.278 5 IMAP-437425([64.173.55.175]) out: * 35 FETCH (BODY[HEADER] {722}\r\ncontent-class: urn:
00:06:23.280 5 IMAP-437425([64.173.55.175]) inp: 8 UID FETCH 193 (BODY.PEEK[1])
00:06:23.280 5 IMAP-437425([64.173.55.175]) out: * 35 FETCH (BODY[1] {539}\r\nBEGIN:VCALENDAR\r\nMETHO
00:06:23.281 5 IMAP-437425([64.173.55.175]) inp: 9 UID FETCH 191 (BODYSTRUCTURE FLAGS)
00:06:23.281 5 IMAP-437425([64.173.55.175]) out: * 34 FETCH (BODYSTRUCTURE (("text" "calendar" ("chars

Фильтрование по ключу

Опция "По ключу" указывает Серверу сканировать Журнал дважды. Первый раз он сканирует Журнал (внутри указанного Интервала Времени) и находит все записи, соответствующие строке-фильтру. Эти строки не отображаются, но их Ключи-Префиксы запоминаются. Ключ-Префикс - это первая часть записи (не включающая отметку о времени и маркер уровня), заканчивающая первым символом пробела. Запоминается до 100 различных Ключей-Префиксов.

Затем Журнал сканируется снова (внутри указанного Интервала Времени) и Сервер показывает все записи, имеющие Ключи-Префиксы, совпадающие с запомненными ранее Ключами-Префиксами.

Некоторые протоколы (такие как SIP) не используют соединения. Сессия SIP ("диалог") состоит из нескольких пакетов (каждый пакет записан с его собственным Ключом-Префиксом SIPDATA-NNNNNN), но во всех пакетах есть одинаковая строка Call-ID. Используйте команду

: Call-ID:caller-id

строку-фильтр с опцией По ключу для отображения всех пакетов сессии SIP:

Уровень Журнала: В новом окне
  Фильтр: По ключуRegEx
Время Сервера: 16:41:53  Интервал: -
00:54:10.312 2 SIPDATA-000502 out: req udp [10.0.0.1]:5060 REGISTER(680 bytes) sip:node6.communigate.com
00:54:10.312 5 SIPDATA-000502 out: REGISTER sip:node6.communigate.com SIP/2.0
00:54:10.312 5 SIPDATA-000502 out: Via: SIP/2.0/UDP 64.173.55.170:5060;branch=z9hG4bK234
00:54:10.312 5 SIPDATA-000502 out: Max-Forwards: 69
00:54:10.312 5 SIPDATA-000502 out: From: <sip:usrname@node6.communigate.com>
00:54:10.312 5 SIPDATA-000502 out: Call-ID: 72D532E1CEB813B537E4E44058354C68-2494453@node9.communigate.com
00:54:10.312 5 SIPDATA-000502 out: Contact: <sip:299@node9.communigate.com;services=no>;expires=90
00:54:10.312 5 SIPDATA-000502 out: CSeq: 114249520 REGISTER
00:54:10.312 5 SIPDATA-000502 out: User-Agent: CommuniGatePro-gateway/5.1.4
00:54:10.312 5 SIPDATA-000502 out: Authorization: Digest realm="ns.communigate.com",username="usrname",non
00:54:10.312 5 SIPDATA-000502 out: Expires: 90
00:54:10.312 5 SIPDATA-000502 out: Content-Length: 0
00:54:10.312 5 SIPDATA-000502 out: 
00:54:10.328 2 SIPDATA-000503 inp: rsp udp [64.173.55.167]:5060 200-REGISTER(566 bytes)
00:54:10.328 5 SIPDATA-000503 inp: SIP/2.0 200 OK
00:54:10.328 5 SIPDATA-000503 inp: Via: SIP/2.0/UDP 64.173.55.170:5060;branch=z9hG4bK234
00:54:10.328 5 SIPDATA-000503 inp: From: <sip:usrname@node6.communigate.com>;tag=9B5A8DB531C3FD7A
00:54:10.328 5 SIPDATA-000503 inp: To: <sip:usrname@node6.communigate.com>;tag=7FBB267A3903E5B0
00:54:10.328 5 SIPDATA-000503 inp: Call-ID: 72D532E1CEB813B537E4E44058354C68-2494453@node9.communigate.com
00:54:10.328 5 SIPDATA-000503 inp: CSeq: 114249520 REGISTER
00:54:10.328 5 SIPDATA-000503 inp: Expires: 90
00:54:10.328 5 SIPDATA-000503 inp: Contact: <sip:299@node9.communigate.com;services=no>;expires=90
00:54:10.328 5 SIPDATA-000503 inp: Event: registration
00:54:10.328 5 SIPDATA-000503 inp: Date: Thu, 16 Mar 2006 08:53:04 GMT
00:54:10.328 5 SIPDATA-000503 inp: Allow: PUBLISH,SUBSCRIBE
00:54:10.328 5 SIPDATA-000503 inp: Allow-Events: presence,message-summary,reg,keep-alive
00:54:10.328 5 SIPDATA-000503 inp: Supported: path
00:54:10.328 5 SIPDATA-000503 inp: Server: CommuniGatePro/5.1.4
00:54:10.328 5 SIPDATA-000503 inp: Content-Length: 0
00:54:10.328 5 SIPDATA-000503 inp: 
00:54:10.328 2 SIPDATA-000503 sent to SIPC-000234
00:55:25.328 2 SIPDATA-000507 out: req udp [10.0.0.1]:5060 REGISTER(680 bytes) sip:node6.communigate.com
00:55:25.328 5 SIPDATA-000507 out: REGISTER sip:node6.communigate.com SIP/2.0
00:55:25.328 5 SIPDATA-000507 out: Via: SIP/2.0/UDP 64.173.55.170:5060;branch=z9hG4bK236
00:55:25.328 5 SIPDATA-000507 out: Max-Forwards: 69
00:55:25.328 5 SIPDATA-000507 out: From: <sip:usrname@node6.communigate.com>;tag=35270A39FB68F573
00:55:25.328 5 SIPDATA-000507 out: To: <sip:usrname@node6.communigate.com>
00:55:25.328 5 SIPDATA-000507 out: Call-ID: 72D532E1CEB813B537E4E44058354C68-2494453@node9.communigate.com
00:55:25.328 5 SIPDATA-000507 out: Contact: <sip:299@node9.communigate.com;services=no>;expires=90
00:55:25.328 5 SIPDATA-000507 out: CSeq: 114249521 REGISTER
00:55:25.328 5 SIPDATA-000507 out: User-Agent: CommuniGatePro-gateway/5.1.4
00:55:25.328 5 SIPDATA-000507 out: Authorization: Digest realm="ns.communigate.com",username="usrname",non
00:55:25.328 5 SIPDATA-000507 out: Expires: 90
00:55:25.328 5 SIPDATA-000507 out: Content-Length: 0
00:55:25.328 5 SIPDATA-000507 out: 
00:55:25.343 2 SIPDATA-000508 inp: rsp udp [64.173.55.167]:5060 200-REGISTER(566 bytes)
00:55:25.343 5 SIPDATA-000508 inp: SIP/2.0 200 OK
00:55:25.343 5 SIPDATA-000508 inp: Via: SIP/2.0/UDP 64.173.55.170:5060;branch=z9hG4bK236
00:55:25.343 5 SIPDATA-000508 inp: From: <sip:usrname@node6.communigate.com>;tag=35270A39FB68F573
00:55:25.343 5 SIPDATA-000508 inp: To: <sip:usrname@node6.communigate.com>;tag=7EF99B799DFD7632
00:55:25.343 5 SIPDATA-000508 inp: Call-ID: 72D532E1CEB813B537E4E44058354C68-2494453@node9.communigate.com
00:55:25.343 5 SIPDATA-000508 inp: CSeq: 114249521 REGISTER
00:55:25.343 5 SIPDATA-000508 inp: Expires: 90
00:55:25.343 5 SIPDATA-000508 inp: Contact: <sip:299@node9.communigate.com;services=no>;expires=90
00:55:25.343 5 SIPDATA-000508 inp: Event: registration
00:55:25.343 5 SIPDATA-000508 inp: Date: Thu, 16 Mar 2006 08:54:19 GMT
00:55:25.343 5 SIPDATA-000508 inp: Allow: PUBLISH,SUBSCRIBE
00:55:25.343 5 SIPDATA-000508 inp: Allow-Events: presence,message-summary,reg,keep-alive
00:55:25.343 5 SIPDATA-000508 inp: Supported: path
00:55:25.343 5 SIPDATA-000508 inp: Server: CommuniGatePro/5.1.4
00:55:25.343 5 SIPDATA-000508 inp: Content-Length: 0
00:55:25.343 5 SIPDATA-000508 inp: 
00:55:25.343 2 SIPDATA-000508 sent to SIPC-000236

Поиск

Используйте команду Поиск в вашем браузере для поиска строки в отфильтрованной части Журнала CommuniGate Pro.

Используйте команду Печать вашего Веб браузера для распечатки отфильтрованного Журнала.


Отметки о Времени и Часовые Пояса

Каждая запись Журнала имеет отметку о времени, указывающую когда эта запись была создана. Время показывается по местному времени Сервера CommuniGate Pro ("разница с Гринвичем"), используемого во время создания файла Журнала.

Если ОС Сервера использует часовой пояс с переходом на летнее время, то отметки о времени, используемые в Журнале, при изменении местного времени ("разницы c Гринвичем") не изменятся. Новое местное время будет использоваться при создании нового файла Журнала.


Маркеры Переполнения

Генератор Журналов CommuniGate Pro разрабатывался как высокоскоростной механизм, который в состоянии обрабатывать тысячи записей в секунду, без замедления работы компонентов Сервера, генерирующих записи в Журнал. Когда некоторые компоненты генерируют гигантские количества записей (вероятнее всего из-за соответствующих настроек Уровня Журнала этого компонента), даже Генератор Журналов может оказаться не в состоянии сохранить все эти записи в Журнале.

Если новая запись не может быть помещена в Журнал из-за проблем с производительностью Генератора Журналов, то вместо записи Генератор Журналов вставляет короткий Маркер Переполнения. Маркер Переполнения это строка из трех звездочек (***).

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


Настройки

Администраторы могут задавать свои индивидуальные Настройки для Просмотра Журнала.

Нажав на ссылку Настройки, откройте страницу Настройки в области Наблюдение.

Генератор Журналов
Высота Панели Журнала: Открывать показывая последние: Ограничение Вывода:
Открывать показывая последние
Эта настройка указывает первоначальное время Интервала Времени (смотрите ниже) - таким образом, когда вы открываете текущий файл Журнала, вы видите только последние записи в Журнале.
Когда вы открываете неактивный файл Журнала, Интервал Времени не инициализируется и Журнал отображается с начала.

Отправка на Удалённые syslog Сервера

Возможно, вам потребуется отсылать записи Журнала CommuniGate Pro на внешний syslog сервер.
Обычно эти сервера не обладают производительностью Генератора Журналов CommuniGate Pro, так что целесообразно отсылать на эти сервера только небольшую часть записей Журнала.

Используйте следующие настройки на настройки удалённого ведения Журнала:

Отсылаемые Записи
Укажите здесь уровень Записей Журнала, которые будут отсылаться на удалённый syslog сервер. Более подробные (имеющие более высокий Уровень Журнала) записи, чем указано здесь, не будут отсылаться.
Адрес Сервера
Укажите здесь IP адрес удалённого syslog сервера. Если вы не указываете номер порта, то будет использоваться стандартный порт 514.
Код Службы
Удалённый syslog сервер может сохранять записи журнала в месте, определяемом согласно значению этой опции.

Если генератор Журналов не сможет установить UDP соединение или не сможет отправить дейтаграмму на указанный удалённый syslog сервер, то Генератор Журналов до конца текущей секунды не будет отправлять записи удалённому syslog серверу.


Использование Триггеров

Возможно вы захотите использовать Обработчик Триггера для отправки уведомлений в случае появления в Журнале CommuniGate Pro записей уровня Катастрофа.

Откройте через Веб Интерфейс Администратора страницу с Элементами Триггеров и задайте там Обработчик Триггера для элемента logLastCrashRecord. При добавлении в Журнал записи уровня Катастрофа (уровеня 0), вызывается заданный Обработчик Триггера.

Обратите внимание: Обработчик Триггера запускается раз в 5-10 секунд. В случае, если в Журнал CommuniGate Pro в течении этого времени было записано более одной записи уровня Катастофа, то сообщение с уведомлением будет содержать только последнюю запись уровня Катастрофа.


Руководство CommuniGate® Pro. Copyright © 1998-2009, Stalker Software, Inc.