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