С помощью файлов протоколов можно устранять
неполадки сервера базы данных
IBM®
Rational
DOORS,
клиент и сервера взаимодействия, а также неполадки сервера
Rational
DOORS
Web Access и посредника сообщений.
В зависимости от конфигурации для диагностики
непредвиденного поведения могут быть доступны следующие
инструменты ведения протоколов:
- Протокол диагностики для клиента
- Протокол транзакций сервера базы данных
- Протокол транзакций клиента
- Протокол сервера
Rational
DOORS
Web Access, сервера взаимодействия и посредника сообщений
- Протоколы сообщений приложения и утилита сбора данных
Протокол диагностики для клиента Rational
DOORS
В клиент встроен механизм ведения протоколов, записывающий все
необычные события, возникающие в результате внутренней ошибки в ходе
сеанса. Для просмотра протокола диагностики выберите . При необходимости можно скопировать информацию из окна вывода и
сохраните ее в локальном текстовом файле.
Для записи более подробного протокола можно разрешить
регистрацию транзакций на уровне клиента и сервера базы
данных. Дополнительная информация приведена в следующих разделах.
Ведение протокола сервера базы данных для
Rational
DOORS
Сервер базы данных предлагает функцию ведения протоколов для записи
операций с разными уровнями подробности. По умолчанию функция ведения протоколов выключена, поскольку она
повышает нагрузку на процессоры в ходе обработки
транзакций, а также снижает производительность системы и
запрашиваемых функций. Содержимое протокола зависит от указанного уровня протокола в
диапазоне от 1 (наименее подробный) до 6 (наиболее подробный). Перед включением функции ведения протокола обратитесь в службу поддержки, чтобы определить уровень подробности, необходимый для устранения неполадки.
Табл. 1. Уровни протоколовУровень протокола |
Информация в протоколе |
1 |
Подключения, отключения и пакеты с ошибками |
2 |
Подключения, отключения и типы пакетов |
3 |
Подключения, отключения, типы пакетов и аргументы
пакетов в компактном формате |
4 |
Подключения, отключения, типы пакетов и аргументы пакетов в
подробном формате |
5 |
Только операции кэша данных |
6 |
Подключения, отключения, операции кэша данных, типы пакетов и аргументы пакетов в
подробном формате |
Для того чтобы определить неизвестную ошибку может потребоваться
запустить функцию ведения протокола на уровне 6 для регистрации всех
операций. После включения ведения протокола базы данных и воспроизведения неполадки
отправьте созданный файл протокола в службу поддержки и выключите ведение
протокола в соответствии с инструкциями из раздела
Включение протокола транзакций на сервере базы данных Rational DOORS.
Прим.: Для того чтобы избежать снижения производительности, протокол базы данных
следует включать на ограниченное время
диагностики.
Ведение протокола клиента для Rational
DOORS
Функцию ведения протоколов можно включить для устранения неполадок сервера
базы данных. В протоколе отсутствуют данные о модулях и объектах, содержащие
конфиденциальную информацию; он содержит только сведения о транзакциях. На компьютере, на котором возникла
неполадка, откройте клиент Rational
DOORS
и выполните команду DXL для включения протокола клиента и
создания локального файла протокола. После воспроизведения неполадки отправьте созданный файл протокола в
службу поддержки и выключите ведение протокола в соответствии с
инструкциями из раздела Включение протокола транзакций в клиенте Rational DOORS.
Протокол сервера взаимодействия
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
Инструкции по настройке уровня подробности Отладка приведены в
связанных разделах, посвященных ведению протоколов 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, с помощью
инструмента сбора данных можно собирать протоколы, созданные в
соответствии с инструкциями из конфигурации службы сообщений
приложения. Кроме того, инструмент сбора данных создает три текстовых файла:
- readme.txt содержит информацию об
использовании, когда возникает неполадка.
- problemDetails.txt - это шаблон, в котором
можно вручную указать сведения о неполадке.
- collectedInformation.txt содержит автоматически
собираемую информацию об операционной системе, информацию о продукте
Rational
DOORS,
поддерживаемые файлы динамически подключаемых библиотек
(.DLL) и файл config.ini.
Дополнительная информация о настройке файлов протоколов приведена в следующих разделах:
- Протоколы Rational
DOORS:
- Протоколы Rational
DOORS Web Access: