Файлы протоколов для Rational DOORS и Rational DOORS Web Access

С помощью файлов протоколов можно устранять неполадки сервера базы данных IBM® Rational DOORS, клиент и сервера взаимодействия, а также неполадки сервера Rational DOORS Web Access и посредника сообщений.
В зависимости от конфигурации для диагностики непредвиденного поведения могут быть доступны следующие инструменты ведения протоколов:
  • Протокол диагностики для клиента
  • Протокол транзакций сервера базы данных
  • Протокол транзакций клиента
  • Протокол сервера Rational DOORS Web Access, сервера взаимодействия и посредника сообщений
  • Утилита ведения протокола сообщений приложения и сбора данных

Протокол диагностики для клиента Rational DOORS

В клиент встроен механизм ведения протоколов, записывающий все необычные события, возникающие в результате внутренней ошибки в ходе сеанса. Для просмотра протокола диагностики выберите Справка > Показать протокол диагностики. При необходимости можно скопировать информацию из окна вывода и сохраните ее в локальном текстовом файле.

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

Ведение протокола сервера базы данных для Rational DOORS

Сервер базы данных предлагает функцию ведения протоколов для записи операций с разными уровнями подробности. По умолчанию функция ведения протоколов выключена, поскольку она повышает нагрузку на процессоры в ходе обработки транзакций, а также снижает производительность системы и запрашиваемых функций. Содержимое протокола зависит от указанного уровня протокола в диапазоне от 1 (наименее подробный) до 6 (наиболее подробный). Перед включением функции ведения протокола обратитесь в службу поддержки IBM, чтобы определить уровень подробности, необходимый для устранения неполадки.

Табл. 1. Уровни протоколов
Уровень протокола Информация в протоколе
1 Подключения, отключения и пакеты с ошибками
2 Подключения, отключения и типы пакетов
3 Подключения, отключения, типы пакетов и аргументы пакетов в компактном формате
4 Подключения, отключения, типы пакетов и аргументы пакетов в подробном формате
5 Только операции кэша данных
6 Подключения, отключения, операции кэша данных, типы пакетов и аргументы пакетов в подробном формате
Для того чтобы определить неизвестную ошибку может потребоваться запустить функцию ведения протокола на уровне 6 для регистрации всех операций. После включения ведения протокола базы данных и воспроизведения неполадки отправьте созданный файл протокола в службу поддержки IBM и выключите ведение протокола в соответствии с инструкциями из раздела, посвященного протоколам сервера. Включение протокола транзакций на сервере базы данных Rational DOORS
Прим.: Протокол базы данных следует включать на ограниченное время диагностики. Для выключения функции ведения протоколов укажите уровень протокола 0 с помощью команды dbadmin -serverlogging; например, dbadmin -d 36677@IBMEDSERV -serverlogging 0.

Ведение протокола клиента для Rational DOORS

Функцию ведения протоколов можно включить для устранения неполадок сервера базы данных. На компьютере, на котором возникла неполадка, откройте клиент Rational DOORS и выполните команду DXL для включения протокола клиента и создания локального файла протокола. После воспроизведения неполадки отправьте созданный файл протокола в службу поддержки IBM и выключите ведение протокола в соответствии с инструкциями из раздела, посвященного протоколам клиента. Включение протокола транзакций в клиенте Rational DOORS Rational DOORS
Прим.: В протоколе отсутствуют данные о модулях и объектах, содержащие конфиденциальную информацию; он содержит только сведения о транзакциях. Если защита DXL включена, то потребуются права на изменение и запуск DXL.../../com.ibm.doors.configuring.doc/topics/t_setupdxlsecurity.html#t_setupdxlsecurity

Протокол сервера взаимодействия Rational DOORS, сервера Rational DOORS Web Access и посредника сообщений

По умолчанию компоненты Rational DOORS Web Access предоставляют записи протокола на уровне Информация. На уровне Информация записи протокола содержат информационные сообщения, описывающие общее состояния приложения. Для диагностики неполадок установки можно включить режим отладки для компонентов. На уровне Отладка записи протокола содержат более подробную информацию, предназначенную для отладки приложения.

Сервер взаимодействия Rational DOORS, сервер Rational DOORS Web Access и посредник сообщений сохраняют записи протокола на уровне Info в следующих каталогах:
  • установочный-каталог-DWA\broker\data\activemq.log
  • установочный-каталог-DWA\server\festival\logs

    Для получения более подробной информации с целью диагностики неполадок, укажите уровень протокола Debug. Инструкции по настройке расширенного ведения протоколов приведены в связанных разделах для Rational DOORS Web Access. Каталог протоколов содержит несколько файлов протоколов.

    Для диагностики неполадки сначала обратитесь к следующим файлам:
    • festival.log содержит все сообщения протокола, записанные сервером Rational DOORS Web Access.
    • request.log применяется для проверки принятых запросов. Он применяется для работы с процессами, которые охватывают несколько приложений.
    • response.log применяется для подтверждения ответов, возвращенных вызывающему приложению. Он применяется для подтверждения приема запроса и возврата результата.
    Сообщения об ошибках записываются в разные протоколы в зависимости от их происхождения. Большинство ошибок записываются в файл exception.log, однако другие файлы протоколов также применяются. Создаются следующие файлы протоколов:
    • exception.log
    • error_view.log
    • error_misc.log

Утилита ведения протокола сообщений приложения и сбора данных

В версии 9.4 были добавлены средства ведения протоколов на основе служб протоколов Apache log4cxx. Можно установить ограничения на размер файлов протокола, задать автоматическую очистку устаревших файлов, выбрать формат файлов протокола вывода, изменить уровень протокола, а также изменить эти конфигурации протокола без перезапуска сервера. Файл конфигурации отслеживается каждые 60 секунд для обнаружения изменений.

Предусмотрены следующие режимы ведения протоколов (в порядке убывания уровня подробности): Debug, Info, Warn, Error и Fatal. На каждом уровне регистрируется информация со всех более высоких уровней. Например, на уровне Warn регистрируется информация для уровней Warn, Error и Fatal.

В более ранних версиях Rational DOORS требовался интерактивный сбор информации о среде и ресурсах вместе с диагностическими протоколами на начальном этапе устранения неполадок. Начиная с версии 9.4, с помощью инструмента сбора данных можно собирать протоколы, созданные в соответствии с инструкциями из конфигурации службы сообщений приложения. Кроме того, инструмент сбора данных создает 3 текстовых файла:
  • readme.txt содержит информацию об использовании, когда возникает неполадка.
  • problemDetails.txt - это шаблон, в котором можно вручную указать сведения о неполадке.
  • collectedInformation.txt содержит автоматически собираемую информацию об операционной системе, информацию о продукте Rational DOORS, поддерживаемые файлы динамически подключаемых библиотек (.DLL) и файл config.ini.
Дополнительная информация о настройке файлов протоколов приведена в следующих разделах:

Комментарии