© Copyright International Business Machines Corporation 2000, 2006. Все права защищены. Ограниченные права пользователей государственных учреждений США - Использование, копирование или обнародование регламентируется Контрактом GSA ADP с IBM Corp.
1.0 Анализатор трассировки и протокола
1.1 Панели
1.1.1 Неполадки в функциях фильтрации и выделения на панели
Протокол
1.2 Импорт протоколов
1.2.1 Неполадки при импорте удаленных файлов протокола
1.2.2 Импорт файлов протокола в системах Linux и AIX
1.2.3 Импорт файла trace.log WebSphere Application Server
1.2.4 Некоторые файлы протокола не могут быть импортированы с
помощью IBM Agent Controller V5
1.2.5 Исключительная ситуация недостатка памяти при импорте
больших файлов протокола и каталогов диагностики
1.2.6 События общего формата, показанные для протокола DB2
Express Diagnostic, не соответствуют спецификации
1.2.7 Анализатор трассировки и протокола не выполняет проверки
типа импортируемого файла протокола
1.2.8 Ограничение импорта файлов протокола, сгенерированных в
другой локали
1.2.9 Не выполняется импорт протокола действий WebSphere
Application Server с помощью синтаксического анализатора правил из AIX
1.2.10 Невозможно создать временную зависимость с помощью
Apache Derby версии 10.1.2.1
1.2.11 Низкая производительность при создании и показе
зависимости для больших протоколов
1.3 Поддержка базы данных
1.3.1 Не поддерживается одновременный доступ к базе данных
нескольких клиентов с одинаковой учетной записью
1.3.2 Конфликт пути ресурса
1.3.3 Параметры Поддержки больших ресурсов остаются
недоступными, несмотря на правильный выбор
1.3.4 Повышение производительности поддержки больших
протоколов
1.3.5 Перезапуск DB2 после создания базы данных и таблиц
1.3.6 Перемежающаяся исключительная ситуация SQL
1.3.7 Тестовое соединение возвращает ошибку, если не применены
параметры
1.3.8 Не поддерживается выражение CommonBaseEvent XPath при
анализе больших протоколов
1.3.9 Для больших протоколов показывается только одно contextDataElement
1.4 Другое
1.4.1 Мастер Создать зависимость протокола не показывается
правильно при использовании драйвера Linux GTK
1.4.2 Не учитываются изменения уровня ведения протоколов
для модулей, внесенные после первого запуска рабочей среды
1.4.3 Сбой системы при создании примера в Red Hat Linux v8.0 с IBM JVM
1.4.4 Из панели инструментов и выпадающего меню Навигатора
протокола могут быть созданы только базы диагностики формата TPTP
1.4.5 Анализатор протоколов IBM обрабатывает только сообщения
длиной до 1024 байтов
1.4.6 Редактор признаков генерирует правила XPATH, которые
неверны при использовании сложных элементов
1.4.7 Редактор признаков генерирует правила XPATH, которые не
соответствуют ни одному входному Событию общего формата
2.0 Инструмент профилирования
2.1 Панели Взаимодействие агента и Взаимодействие процесса не
поддерживаются из панели Диаграмма схемы связей
2.2 Команда Обновить панели Навигатора профилирования не
работает для Взаимодействий трассировки
2.3 Профилирование в системе Windows с Sun JDK 1.4.x может
завершится ошибкой Microsoft(R)
Дополнительная информация об Анализаторе трассировки и протокола TPTP
доступна на Web-сайте
TPTP
V4.2, Информация о выпуске.
На панели Протоколы функции Фильтрация и Выделение не работают со сложными элементами События общего формата (например, sourceComponentId). Исправление будет предоставлено в следующем пакете исправлений.
При импорте удаленных файлов протокола (Файл > Импорт... > Файл протокола) записи протокола не показываются на панели Протоколы после обновления панелей Профилирование монитора (Профайл > Обновить панели), или появляется окно диалога Сообщение ведения протоколов, в котором говорится, что локальный клиент не запустил мониторинг удаленного синтаксического анализатора протоколов после 30-секундного ожидания.
Эта неполадка обусловлена латентностью сети и может быть устранена с помощью увеличения времени ожидания Контроллера агентов запуска локальным клиентом мониторинга удаленного синтаксического анализатора протоколов. Для того чтобы обойти эту проблему, выполните следующие действия:
<Application configuration="default" executable="RemoteLogParserLoader" extends="default" location="%SYS_TEMP_DIR%" path="%JAVA_PATH%"> ... <Parameter position="prepend" value="-Dorg.eclipse.hyades.logging.parsers.maxWaitTimeInMillis=xxxxx"/> ... </Application>где xxxxx - это максимальное время ожидания в миллисекундах (т.е. более 30000).
Импорт некоторых файлов протокола выполняется не во всех системах Linux(R) и AIX(R).
Это происходит, когда пользователь не имеет соответствующих прав доступа к файлам протокола. Для того чтобы решить эту проблему, следует скопировать файлы протокола в домашний каталог пользователя и импортировать их оттуда.
1.2.3 Импорт файла trace.log WebSphere Application ServerПри импорте файла trace.log WebSphere(R) Application Server создается внутренняя зависимость.
Пользователь не должен удалять эти зависимости, так как они содержат информацию, которая относится к внутренней структуре соответствующего агента.
1.2.4 Некоторые файлы протокола не могут быть импортированы с помощью IBM Agent Controller V5Удаленные файлы протокола отличные от activity.log не могут быть импортированы с помощью IBM(R) Agent Controller V5. При удаленном импорте файлов протокола IBM Agent Controller в удаленной системе должен иметь уровень не меньше, чем у IBM Log and Trace Analyzer for Eclipse.
Для того чтобы обойти это ограничение, установите в удаленной системе IBM Agent Controller, поставляемый вместе с IBM Log and Trace Analyzer for Eclipse.
1.2.5 Исключительная ситуация недостатка памяти при импорте больших файлов протокола и каталогов диагностикиФайлы протокола и каталоги диагностики размером до 25 Мб могут быть импортированы в рабочую область и открыты в Анализаторе трассировки и протокола.
Время, необходимое для открытия файла протокола, зависит от количества записей протокола в файле, и может возникнуть исключительная ситуация "недостаточно памяти". Для того чтобы обойти эту проблему, используйте функцию поддержки больших протоколов.
Если при импорте больших каталогов диагностики возникнет исключительная ситуация "недостаточно памяти", увеличьте размер кучи, добавив следующую опцию:
-vmargs -Xmx1000m
Если использование функции поддержки больших протоколов не устранит появление исключительной ситуации "недостаточно памяти", должно помочь увеличение размера кучи.
При импорте протокола IBM DB2(R) Express Diagnositic результирующее Событие общего формата, показанное в Анализаторе трассировки и протокола, нарушает спецификацию События общего формата. Это обусловлено ошибкой в утилите db2diag.exe, которая используется для преобразования протоколов DB2 Diagnostic в События общего формата. Во всем остальном это не влияет на операцию импорта. Не известно обходных путей, кроме исправления db2diag.exe.
Анализатор трассировки и протокола не выполняет проверки типа импортируемого файла протокола. При импорте файла протокола выберите для него правильный тип протокола и версию. Если в процессе импорта возникнет неполадка, то на панели Протоколы не будет показано никаких записей или неверных записей, и появится сообщение об ошибке. Более подробную информацию об ошибке можно получить из сведений окна диалога ошибки.
При импорте файлов протокола, которые содержат временные метки в локали, отличной от той локали, в которой выполняется Анализатор трассировки и протокола, основанный на правилах анализатор файлов протокола иногда неверно анализирует временные метки и другие данные записи протокола. Например, при импорте файла протокола доступа к IBM HTTP Server на английском языке в Анализатор трассировки и протокола, выполняющийся в системе на японском языке, значения creationTime в результирующих Событиях общего формата будут равны нулю, а поле msg будет пустым.
Для того чтобы обойти эту проблему, при импорте файлов протокола, содержащих временные метки в локалях, отличающихся от текущей локали системы, укажите локаль файла протокола на вкладке Сведения мастера Импорт протокола, если существует поле локали.
Не выполняется импорт двоичного протокола действий WAS из системы AIX с помощью анализатора правил. При этом появляется следующее сообщение об ошибке:
IWAT0030E Произошла ошибка при выполнении удаленного анализатора протоколов "com.ibm.etools.logging.adapter.config.StaticParserExtension": IWAT0412E Произошли ошибки при синтаксическом анализе файла протокола /home/tfoun/logs/activity.log. java.lang.Exception: IWAT0239E Не выполнена команда перекодировщика: java.lang.Exception: IWAT0238E Процесс перекодировщика завершен со значением выхода 1
Не работает команда перекодировщика для преобразования двоичного файла протокола в текст, чтобы он мог быть проанализирован. Для того чтобы обойти эту проблему, или используйте Статический анализатор для импорта двоичного файла протокола, или преобразуйте двоичный файл протокола в текст с помощью утилиты просмотра протокола WAS и импортируйте результирующий текстовый файл в Анализатор трассировки и протокола. Утилита просмотра протокола WAS находится в подкаталоге bin каталога установки WAS. Например, с помощью следующей команды преобразуйте двоичный файл протокола в текстовый файл по имени activity.txt:
/opt/WebSphere/AppServer/bin/showlog activity.log activity.txt
Затем импортируйте файл activity.txt в Анализатор трассировки и протокола.
Derby 10.1.2.1 не поддерживается официально TPTP, и при попытке пользователя использовать его вместе с поддержкой больших протоколов может возникнуть эта проблема. При попытке создания временной зависимости для большого протокола возникает исключительная ситуация ArrayIndexOutOfBoundsException, что вызвано непрерывным выполнением зависимости без остановки. Это - известный дефект Derby, но он исправлен в версии 10.2.0.0. Более подробная информация находится в описании дефекта Derby по адресу: http://www.archivum.info/derby-dev@db.apache.org/2006-03/msg01624.html.
Заметьте, что эта исключительная ситуация возникает на стороне сервера и не видна в рабочей среде пользователя. Она показывается в командном окне, в котором выполнена команда запуска сервера Derby.
При создании и показе зависимости для больших протоколов с помощью Apache Derby и DB2 производительность может быть низкой.
Для повышения производительности во время создания зависимости импортируйте протоколы с фильтром протокола, чтобы исключить из базы данных ненужные события. Использование фильтра "Показать только связанные события" может повысить быстродействие при открытии зависимости в панели Взаимодействия протокола.
Параллельный доступ клиентов к базе данных может заблокировать некоторые таблицы. Для того чтобы разблокировать таблицы, перезапустите рабочую среду и сервер базы данных.
При использовании одной базы данных и одной учетной записи пользователей для нескольких рабочих областей, может возникнуть конфликт пути ресурса, и ресурс не будет сохранен в базе данных.
Для того чтобы обойти эту проблему, используйте в разных рабочих областях разные имена проектов и монитора, чтобы избежать конфликта ресурсов.
В системе Linux/GTK на странице параметров Поддержка больших ресурсов поля параметров базы данных остаются недоступными, даже если выбран правильный тип базы данных.
Для того чтобы обойти эту проблему, выберите DB2 в качестве типа базы данных и примените параметры. Закройте и повторно откройте окно диалога параметров, поля станут доступными.
Для повышения производительности поддержки больших протоколов выполните следующую команду после импорта больших протоколов:
db2 -tvf plugins/com.ibm.etools.ac.resources.database_x_x_x /scripts/runStatsForAllHyadesTablesDB2-8.1.sqlгде x_x_x - это номер версии в имени каталога модуля.
После выполнения сценария создания таблиц и базы данных, CreateDatabaseAndTablesDB2-8.1.sql, необходимо перезапустить DB2. Выполните в командном окне DB2 команду db2stop, а затем db2start, для того чтобы изменения параметров конфигурации, внесенные сценарием, вступили в силу.
Время от времени может возникать следующая исключительная ситуация SQL:
com.ibm.db2.jcc.b.SQLException: NULLID.SYSSH203 0X5359534C564C3031
Когда происходит такая неполадка, перезапустите рабочую среду и базу данных, если DB2 или CloudscapeTM используется в сетевом режиме. Протоколы, импортированные во время возникновения этой исключительной ситуации, не будут верны и должны быть повторно импортированы.
Если на странице Поддержка больших протоколов раздела Профилирование и ведение протоколов окна Параметры щелкнуть на Тестовое соединение, перед тем как применены изменения параметров, то может возникнуть ошибка соединения. Для того чтобы избежать этого, щелкните на Применить после внесения изменений, а только затем щелкните на Тестовое соединение.
Следующее выражение XPath не поддерживается Анализатором протоколов IBM при анализе больших протоколов.
<expression:xpathExpression>/CommonBaseEvent</expression:xpathExpression>
Если для поддержки больших протоколов используется DB2, то только один элемент contextDataElement для события показывается на панели Протокол, даже если существует несколько элементов contextDataElements для этого события.
В мастере Создать зависимость протокола показывается только список Доступные протоколы и этот список пуст. Это обусловлено тем, что показывается только левая часть страницы мастера.
Для того чтобы обойти эту проблему, попробуйте изменить размер страницы мастера, чтобы увидеть список Выбранные протоколы и кнопки действий. Кроме того, можно выбрать файлы протоколов для зависимости на панели Навигатор протокола, перед тем как нажимать кнопку Создать зависимость протокола.
Если вы измените уровень ведения протоколов модуля в его файле plugin.xml (через точки расширения com.ibm.etools.common.logging.commonLoggingOptions или com.ibm.etools.logging.util.loggingOptions) после первого запуска рабочей среды, то изменение не будет учитываться в последующих запусках рабочей среды. Уровень ведения протоколов, указанный в файле plugin.xml модуля, кэшируется средой выполнения Eclipse при первом запуске рабочей среды. При последующих запусках рабочей среды используется кэшированное значение уровня ведения протоколов вместо измененного значения в файле plugin.xml.
Для того чтобы обойти эту проблему, перезапустите рабочую среду с аргументом командной строки -clean. Эта опция очистит кэш, используемый для хранения разрешения зависимости комплекта и данных реестра расширения eclipse, и приведет к принудительной повторной инициализации Eclipse этих значений кэша. Добавьте опцию после eclipse.exe в <каталог установки рабочей среды>\eclipse\ac.bat (Windows(R)) или <каталог установки рабочей среды>/eclipse/ac.sh (Linux). В качестве альтернативы, можно изменить уровень ведения протоколов модуля на странице параметров Ведение протоколов (Окно > Параметры > Ведение протоколов) и перезапустить рабочую среду.
При создании примера в Анализаторе трассировки и протокола с помощью мастера Создание примера (Создать > Пример) происходит сбой рабочей среды. Это происходит, когда в процессе работы мастер Создание примера пытается открыть файл readme.html. Эта неполадка обнаружена в системе Red Hat Linux v8.0 с IBM JavaTM Virtual Machine (JVM) и является дефектом SWT (https://bugs.eclipse.org/bugs/show_bug.cgi?id=76515).
Для того чтобы обойти эту проблему, попытайтесь добавить в ac.sh аргумент JVM -Xj9 для запуска с помощью IBM J9 JVM. (Например, ./eclipse -vmargs -Xj9 -Xmx500m). Более подробная информация о выполнении SWT в системе Red Hat Linux v8.0 находится на странице SWT FAQ (http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-swt-home/faq.html).
Примечание: Как указано на странице Справочная таблица платформ Eclipse (http://www.eclipse.org/eclipse/development/eclipse_project_plan_3_0.html#TargetOperatingEnvironments), поддерживаются только следующие системы Linux: версия 2.2.1 набора управляющих элементов GTK+ и связанные библиотеки (GLib, Pango); программа просмотра SWT HTML требует Mozilla 1.4GTK2. Для Motif в других системах Linux: Open Motif 2.1 (включен); программа просмотра SWT HTML требует Mozilla 1.4GTK2.
Из-за ограничения TPTP, пользователи не могут создавать из панели инструментов и выпадающего меню Навигатора протокола оба типа баз диагностики. Для того чтобы обойти эту проблему, выберите Файл > Создать > Другое > Профилирование и ведение протоколов из меню рабочей области, а затем выберите тип базы диагностики, которую вы хотите создать.
В правилах XPATH и правилах зависимости IBM строка в поле msg События общего формата не должна превышать 1024 байтов. Если строка длиннее 1024 байтов, она не будет обработана Анализатором протоколов IBM.
При использовании сложных элементов События общего формата (например, sourceComponentID), Редактор признаков генерирует неверные правила XPATH. Исправление будет предоставлено в следующем пакете исправлений.
Если при создании нового выражения XPATH не выбрано ни одного
ExtendedDataElements, то результирующий каталог признаков содержит
extendedDataElement
вместо extendedDataElements
.
Редактор признаков генерирует правила XPATH, которые не соответствуют ни одному
входному Событию общего формата.
Панели Взаимодействие агента и Взаимодействие процесса не поддерживаются из панели Диаграмма схемы связей для файлов протокола.
В настоящее время не существует обходного пути для этой проблемы.
2.2 Команда Обновить панели Навигатора профилирования не работает для Взаимодействий трассировкиКоманда Обновить панели Навигатора профилирования не работает для Взаимодействий трассировки. Однако, взаимодействия трассировки регулярно автоматически обновляются сами.
Для того чтобы обойти эту проблему, выберите другой узел в дереве Профилирование и снова выберите предыдущий узел.
2.3 Профилирование в системе Windows с Sun JDK 1.4.x может завершится ошибкой MicrosoftДефект Bugzilla: 103058
Профилирование или приложение завешается с сообщением об ошибке в "java.exe. Мы извиняемся за неудобство." Сообщение содержит информацию для представления в Microsoft отчета об ошибке. Снимок экрана сообщения находится на bugzilla: 103058.
Эта проблема наблюдается в разных режимах: Анализ времени (с опцией "Показать экземпляры" или без нее), Анализ памяти и в комбинациях этих режимов. Для того чтобы обойти эту проблему, запустите повторно профилирование или приложение, выключив JIT, т.е. предоставив аргумент JVM "-Djava.compiler=NONE". Неполадка возникает в компоновке SUN JDK 1.4.2_08-b03 для Windows.