© Copyright International Business Machines Corporation 2000, 2006. Все права защищены. Ограниченные права пользователей государственных учреждений США - Использование, копирование или обнародование регламентируется Контрактом GSA ADP с IBM Corp.
Дополнительная информация об Общем адаптере протокола TPTP доступна на Информация о выпуске TPTP V4.2.
Когда Общий адаптер протокола непрерывно отслеживает файл протокола, он не обрабатывает последнюю запись, если не указан шаблон конца. Последняя запись будет обработана только при выключении Общего адаптера протокола.
Для того чтобы обеспечить обработку последней записи в процессе отслеживания, предоставьте шаблон конца в файле конфигурации Общего адаптера протокола.
Когда Общий адаптер протокола используется для синтаксического анализа двоичных операций или служебных протоколов WebSphere(R) Application Server в системе UNIXTM, пользователь должен иметь равные или более высокие права доступа, чем программа установки WebSphere Application Server.
Для того чтобы обойти эту проблему, переместите двоичные операции или служебные протоколы в каталог с такими же правами доступа, которые имеет пользователь Общего адаптера протокола, перед выполнением синтаксического анализа протоколов.
Когда Общий адаптер протокола используется для синтаксического анализа протоколов ошибок WebSphere MQ в системе UNIX, пользователь должен иметь равные или более высокие права доступа, чем программа установки WebSphere MQ.
Для того чтобы обойти эту проблему, переместите протоколы ошибок MQ в каталог с такими же правами доступа, которые имеет пользователь Общего адаптера протокола, перед выполнением синтаксического анализа протоколов.
При попытке использования файла runregex_showlog_example.bat или runregex_showlog_example.sh для выполнения синтаксического анализа протокола операций WebSphere Application Server не удается найти утилиту просмотра протокола WebSphere Application.
Для того чтобы обойти эту проблему, измените regex_showlog_example.adapter для файла в редакторе правил, а также измените свойство Sensor Converter, чтобы оно указывало на расположение каталога WebSphere Application Server.
Общий адаптер протокола будет генерировать неверный элемент extendedDataElements События общего формата для записи протокола, если не существует правила, соответствующего или имени, или типу. Элемент extendedDataElement не должен генерироваться, если не существует имени или типа в записи протокола, но Общий адаптер протокола будет его генерировать только с полем значения.
Для того чтобы обойти эту проблему, предоставьте правила, соответствующие всем трем полям элемента extendedDataElement - имени, значению и типу.
Когда Общий адаптер протокола выполняется в автономном режиме, вне среды Eclipse, он заносит ошибки и сообщения протокола в файл hgla.log в текущем рабочем каталоге. Если файл hgla.log уже существует в текущем рабочем каталоге, то создается новый файл hgla.nnnnnnnn.log, где nnnnnnnn - это уникальный номер. Когда Общий адаптер протокола выполняется как часть операции импорта протокола, сообщения об ошибках, которые он вносит в протокол, показываются в окне диалога ошибки а Анализаторе трассировки и протокола.
При выполнении в среде Eclipse в проекции Общий адаптер протокола, сообщения и ошибки, которые вносятся в протокол Общим адаптером протокола, показываются на панели Неполадки.
Общий адаптер протокола вносит в протокол события, имеющие уровни ведения протокола 5, 10, 20, 30, 50 и 60, в зависимости от значения loggingLevel для Контекстов и Компонентов в файле конфигурации адаптера. Файл hgla.log может быть импортирован в Анализатор трассировок и протоколов как файл типа XML События общего формата для диагностики неполадок, обнаруженных Общим адаптером протокола при синтаксическом анализе файла протокола.
Общий адаптер протокола не выполняет проверки, соответствует ли тип анализируемого файла протокола конфигурации файла адаптера. Например, если файл протокола, указанный в конфигурации детектора в файле адаптера, имеет тип, отличный от того, для которого предназначена конфигурация приемника и правила подстановки в конфигурации анализатора, то это может привести к непредсказуемым результатам. Синтаксический анализ может закончиться без ошибок, но результирующие данные События общего формата будут неверными. Синтаксический анализ может также завершиться с сообщениями об ошибках, указывающих на обнаружение неверных данных.
Для того чтобы обойти эту проблему, укажите в конфигурации компонента детектора файл протокола правильного типа.
При выполнении синтаксического анализа файлов протокола действий WebSphere Application Server с помощью runregex_showlog_example.bat/sh в не-английских системах данные записи протокола не будут успешно преобразованы в Событие общего формата. Вместо этого, данные записи протокола могут появится в неверном поле События общего формата.
При синтаксическом анализе файлов протокола, которые содержат временные метки в локали, отличной от той локали, в которой выполняется Общий адаптер протокола, использующий основанный на правилах файл адаптера, настроенный для использования атрибута Формат времени в правиле подстановки для creationTime, временная метка и другие данные записи протокола могут неверно анализироваться. Например, значения creationTime в результирующих Событиях общего формата могут быть равными нулю, а поле msg События общего формата может оказаться пустым.
Для того чтобы обойти эту проблему, убедитесь в том, что значения атрибутов кода языка ISO и кода страны ISO Экземпляра контекста в файле адаптера, основанном на правилах, соответствуют локали временных меток в анализируемом файле протокола.
При выполнении преобразования файлов протокола, в которых используются неуникальные трехбуквенные символы часового пояса, в Событие общего формата, использующее Общий адаптер протокола, может возникнуть неверное время создания событий протокола. Например, трехбуквенный символ "IST" может быть интерпретирован как Israeli Standard Time, Indian Standard Time, Iran Standard Time или Irish Summer Time.
При анализе протокола IBM(R) DB2(R) Express Diagnostic с адаптерами в % GLA_Install%\GenericLogAdapter\config\DB2\diag\tool, результирующее Событие общего формата, записанное в файл вывода, нарушает спецификацию События общего формата. Это обусловлено ошибкой в утилите db2diag.exe, которая используется для преобразования протоколов DB2 Diagnostic в События общего формата. Во всем остальном это не влияет на синтаксический анализ. Не известно обходных путей, кроме исправления db2diag.exe.
Синтаксический анализ файла протокола с помощью файла адаптера, созданного в предыдущей версии Редактора конфигурации адаптера, может привести к следующему сообщению об ошибке в файле протокола Общего адаптера протокола hgla.log:
IWAT0383E Ошибка проверки адаптера: cvc-complex-type.4: Атрибут 'lineBreakSymbol' должен присутствовать в элементе 'ex:Extractor'.
Прежние версии Редактора конфигурации адаптера создавали файлы адаптера без обязательного атрибута Приемника lineBreakSymbol. Этот атрибут должен присутствовать в элементе Приемника, даже если он имеет нулевое значение. Общий адаптер протокола теперь проверяет соответствие файла адаптера схеме Общего адаптера протокола перед его использованием, а атрибут lineBreakSymbol является обязательным в схеме.
Для того чтобы обойти эту проблему, откройте файл адаптера в Редакторе конфигурации адаптера, добавьте непустое значение в поле lineBreakSymbol элемента Приемника, сохраните файл адаптера, а затем удалите это значение, если оно не требуется, и сохраните файл снова. Теперь файл адаптера будет содержать атрибут lineBreakSymbol в элементе Приемник.
Синтаксический анализ файла протокола с помощью файла адаптера, созданного в предыдущей версии Редактора конфигурации адаптера, может привести к следующему сообщению об ошибке в файле протокола Общего адаптера протокола hgla.log:
IWAT0438E Программа форматирования События общего формата N76D20B0042411D98000E0362B33D6F0 не может создать CommmonBaseEvent, потому что отсутствует обязательное свойство sourceComponentId.
Это сообщение указывает на то, что компонент программы форматирования События общего формата не может создать Событие общего формата, потому что отсутствует обязательное свойство sourceComponentId События общего формата. Общий адаптер протокола теперь проверяет наличие всех обязательных свойств в Событии общего формата, и в случае их отсутствия Событие общего формата не возвращается. Файл адаптера не может иметь правила синтаксического анализа для свойств, указанных в сообщениях, или неверные правила синтаксического анализа.
Для того чтобы обойти эту проблему, добавьте к файлу адаптера правила синтаксического анализатора для отсутствующих обязательных свойств События общего формата или проверьте правильность существующих правил.
При синтаксическом анализе протоколов на консоли могут появиться следующие сообщения об ошибках:
IWAT0310E Общий адаптер протокола не может быть запущен из-за неполадок конфигурации. IWAT0317E Ошибка при компоновке компонента AdapterLogSensor. IWAT0319E Невозможно создать экземпляр класса org.eclipse.hyades.logging.adapter.internal.util.AdapterSensor. Exception = org/eclipse/emf/ecore/EObjectДля того чтобы обойти эту проблему, измените опцию -classpath в файлах сценариев выполнения gla.bat и gla.sh: