Параметры уровней ведения протокола

В этом разделе приведены сведения о настройке параметров уровней ведения протокола.

Для того чтобы открыть эту страницу административной консоли, выберите Устранение неполадок > Протоколы и трассировка > имя-сервера > Изменить уровни подробности протоколов.

Уровень протокола определяет, какие события обрабатываются службой протоколов Java. При изменении уровня для программы ведения протокола новое значение вступает в силу для всех потомков этой службы.

Прим.: Этот раздел ссылается на один или несколько файлов протокола сервера приложений. В распределенных системах и системе IBM® i рекомендуется настроить на сервере ведение протоколов и трассировку через HPEL, вместо вывода в файлы SystemOut.log, SystemErr.log, trace.log и activity.log. HPEL можно использовать вместе со штатными средствами z/OS для ведения протоколов. При использовании HPEL можно получить доступ ко всей информации протоколов и трассировки с помощью инструмента командной строки LogViewer из каталога bin профайла сервера. Дополнительные сведения о HPEL приведены в информации об использовании HPEL для устранения неполадок приложений.
Выключить ведение протоколов и трассировку потенциально уязвимых данных
Сервер приложений имеет список программ, которые потенциально могут записывать секретную информацию в протокол и трассировку, когда они включены. Например, включение определенных связанных с HTTP программ ведения протокола на уровне FINEST может привести к сохранению в файлах трассировки конфиденциальной пользовательской информации из запросов HTTP. Если необходимо запретить серверу включение этих программ ведения протокола на уровнях, где может использоваться конфиденциальная информация, включите переключатель Выключить ведение протоколов и трассировку потенциально секретной информации. При запуске сервера или при динамическом изменении спецификации уровня подробности протокола сервер сравнивает список программ протокола и заданные в спецификации уровня подробности протокола со своим списком, а затем обновляет по необходимости спецификацию уровня подробности протокола.
Изменить уровень ведения протокола

Укажите уровень ведения протокола. Он определяет, для каких компонентов, пакетов или групп будет выполняться трассировка. Строка уровня ведения протокола должна быть задана в соответствии с описанными ниже грамматическими правилами. Строку можно указать вручную или создать ее с помощью графического интерфейса трассировки.

Если перейти на вкладку Конфигурация и развернуть Компоненты и группы, то будет показан список известных компонентов, пакетов и групп. Этот список не всегда является исчерпывающим.

Если перейти на вкладку Рабочая среда и развернуть Компоненты и группы будет показан список компонентов, пакетов и групп, включая все компоненты, зарегистрированные на запущенном сервере приложений и в статическом списке.

Строка уровня ведения протокола задается в следующем формате:
<компонент> = <уровень>

где <компонент> - это компонент, для которого необходимо настроить уровень ведения протокола, а <уровень> - это один из следующих уровней ведения протокола: off, fatal, severe, warning, audit, info, config, detail, fine, finer, finest, all. Можно указать несколько определений уровня ведения протокола, отделив их друг от друга двоеточием (:).

Предотвращение неполадок Предотвращение неполадок: Операторы спецификации трассировки читаются в том порядке, в котором они расположены в строке. Поэтому, если в спецификацию трассировки включено несколько вариантов оператора *=info, то последний из них определяет уровень трассировки, который вносится системой в протокол. Если *=info является последним оператором, то трассировка происходит на уровне info независимо от других операторов, указанных в строке трассировки. Например, если указана следующая строка трассировки:
*=info:PMGR=all:*=info:com.ibm.ws.sm.*=all  
, то она эквивалентна следующему оператору:
*=all
Это обусловлено тем, что последний оператор переопределяет все операторы, указанные в строке перед ним.gotcha
Компоненты соответствуют пакетам и классам Java или наборам пакетов Java. С помощью символа подстановки (*) можно задать компоненты, содержащие все классы из всех пакетов компонента. Пример:
*
Задает все допускающие трассировку элементы исходного кода, выполняющиеся на сервере приложений, включая системный исходный код и пользовательский исходный код.
com.ibm.ws.*
Задает все классы в пакете, имя которого начинается со строки com.ibm.ws.
com.ibm.ws.classloader.JarClassLoader
Задает класс JarClassLoader.

При настройке уровня ведения протокола на консоли администрирования не рекомендуется смешивать элементы из списков Группы и Компоненты, так как при этом может возникнуть ошибка. Иногда элементы, выбранные в одном списке, удаляются при добавлении элементов из другого списка. Для обхода этой неполадки введите определение уровня ведения протокола непосредственно в предусмотренном для этого поле.

Выберите компонент или группу, для которых нужно настроить уровень ведения протокола. В следующей таблице перечислены допустимые уровни ведения протокола для серверов приложений WebSphere Application Server версии 6 и более поздних версий.
Предотвращение неполадок Предотвращение неполадок: Значение уровней ведения протоколов указываются с учетом регистра символов.gotcha
Табл. 1. Допустимые уровни ведения протокола. В следующей таблице перечислены допустимые уровни ведения протокола для серверов приложений WebSphere Application Server версии 6 и более поздних версий.
Уровень ведения протокола в версии 6 и более поздних версиях Данные или уровень серьезности
off Ведение протокола выключено.
fatal Невозможно продолжить выполнение задачи. Компонент, приложение и сервер не работают.
severe Невозможно продолжить выполнение задачи. Компонент, приложение и сервер по-прежнему работают. Этот уровень также может указывать на приближение неустранимой ошибки.
warning В будущем может возникнуть ошибка. К этому же уровню относятся прогрессирующие неполадки (например, возможная утечка ресурсов).
audit Возникло событие, которое существенно повлияло на состояние сервера или его ресурсов
info Общая информация о ходе выполнения задач
config Изменение конфигурации или состояния
detail Общая информация о выполнении подзадач
fine Информация трассировки: общая информация и сведения о входе в метод, выходе из него и возвращенном значении
finer Информация трассировки: подробные сведения
finest Информация трассировки: очень подробная информация, достаточная для отладки неполадок
все В протоколе сохраняется информация обо всех событиях. Если были созданы пользовательские уровни ведения протокола, то они входят в состав уровня All (например, они могут предоставлять более подробную информацию, чем уровень finest).
В версии 6.0 активация уровня ведения протокола подразумевает активацию всех более серьезных уровней. Например, при выборе уровня ведения протокола warning для сервера приложений версии 6.0 будут обрабатываться события уровней warning, severe и fatal.

[Основной режим ведения протоколов] Информацию трассировки, то есть события уровней Fine, Finer и Finest, можно сохранять только в протоколе трассировки. Если диагностическая трассировка не включена, то выбор уровня ведения протокола Fine, Finer или Finest будет игнорироваться (в протоколе будет сохраняться прежний объем данных).

Корреляция
Укажите параметры корреляции. Включите переключатель Включить корреляцию протоколов и данных трассировки, чтобы выключить корреляцию на сервере приложений. Выключите переключатель Включить корреляцию протоколов и данных трассировки, чтобы выключить корреляцию на сервере приложений. Выберите Включать ИД запросов в записи протокола и трассировки, Включать ИД запросов в записи протокола и трассировки, а также создавать записи протокола зависимости или Включать ИД запросов в записи протокола и трассировки, создавать записи протокола зависимости и собирать моментальные копии данных.
Рекомендации Рекомендации: Включите XCT для добавления ИД запросов в файлы протоколов и трассировки, если необходимо отслеживать записи протоколов и трассировки во всех нитях и процессах сервера приложений, связанные с одним запросом. ИД запросов записываются только в случае применения режима ведения протоколов и трассировки HPEL; их можно использовать для фильтрации с помощью команды logViewer. bprac
Рекомендации Рекомендации: Включите XCT для создания записей протокола зависимостей для регистрации распределение запросов между нитями и процессами и просмотра дополнительной информации о каждом запросе. Включать XCT для создания записей протокола зависимостей рекомендуется только в средах тестирования и разработки, поскольку это может привести к значительному снижению производительности системы.bprac
Рекомендации Рекомендации: Включите XCT для создания моментальных копий данных, чтобы сохранять в файловой системе полное содержимое запросов и ответов. Включать XCT для создания моментальных копий данных рекомендуется только в средах тестирования и разработки, поскольку это может привести к значительному снижению производительности системы. XCT создает моментальные копии данных для запросов и ответов, обрабатываемых SIBus.bprac
Предотвращение неполадок Предотвращение неполадок: Моментальные копии данных сохраняются в каталоге $SERVER_LOG_ROOT/snapdata. Сервер приложений не обеспечивает автоматическую очистку файлов в этом каталоге. Если создание моментальных копий данных включено, то из этого каталога следует регулярно вручную удалять файлы. Моментальные копии данных могут содержать конфиденциальную информацию, поскольку в них полностью сохраняются запросы и ответы. Такой вариант может быть неприемлем в рабочих средах.gotcha
Сохранить изменения среды выполнения в конфигурации
Указывает, что изменения, внесенные в динамическое состояние активного сервера и конфигурацию сервера, применяются в ходе очередного перезапуска. Если этот переключатель выключен, то сервер не копирует параметры в конфигурацию сервера.


Имя файла: utrb_loglevel.html