Работа с примером ведения протоколов Log4J
Этот пример демонстрирует поддержку TPTP для ведения протокола событий общего формата с помощью API ведения протоколов Apache
Log4J.
Пользователи применяют для ведения протоколов событий общего формата консоль или агент протокола.
Если вы еще не создали пример, создайте его, выбрав Файл >
Создать > Пример... > Пример средств ведения протоколов Apache Log4J.
Пример состоит из исходного кода Java, зависимостей и файла конфигурации, необходимых для записи событий общего формата в средство ведения протоколов Apache Log4J.
Для компиляции и выполнения этого примера необходимо наличие Apache Log4J 1.2.8 (прилагается) или более поздних версий.
Предпосылки
- При запуске этого приложения из проекции Профилирование и протоколы в рабочей среде конфигурация запуска приложения или путь к
классам приложения/службы контроллера агентов содержит Apache Log4J 1.2.8 или более поздних версий.
- Переменная среды 'log4j.configuration' задается в формате URL, где указан полный путь и имя файла конфигурации для ведения
протоколов Apache Log4J (HyadesLoggingLog4JSample.xml). Пример:
file:/<рабочая-область>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml.
- Определение типа документа (DTD) Apache Log4J (DTD), указанное в <файле JAR ведения протоколов Apache
Log4J>/org/apache/log4j/xml/log4j.dtd, копируется в каталог <рабочая-область>/HyadesLoggingLog4JProject/cfg/ и
используется файлом конфигурации ведения протоколов Apache Log4J
(file:/<рабочая-область>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml).
Для того чтобы запустить этот пример и автоматически прикрепить агент ведения протоколов, выполните следующие действия:
- Подтвердите, что все ошибки компиляции исправлены.
- Если вы используете автономный экземпляр контроллера агентов, проверьте, подключен ли он (его подключать необязательно).
Как вариант, можно использовать прямое соединение, которое предоставляет ограниченный набор служб контроллера, установленных в
Рабочей среде.
- Откройте проекцию Профилирование и протоколы (Окно> Открыть проекцию> Прочие... > Профилирование и протоколы).
-
Запустите пример класса в проекции Профилирование и протоколы (Выполнить > Профилирование... > Создайте новую конфигурацию запуска
типа приложений Java > Задайте в примере имя проекта > Задайте класс main для
'HyadesLoggingLog4JSample' > Перейдите на вкладку Аргументы и укажите следующее свойство JVM:
-Dlog4j.configuration="file:/<рабочая-область>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml"
>Переключитесь на вкладку Монитор > Отмените выделение "Профилирование Java" и выберите "Средство поиска агентов" >
Профилирование).
- Через несколько секунд агент протоколов будет автоматически найден и подключен.
Выберите найденный агент протоколов и откройте панель Протокол в проекции Профилирование и протоколы для просмотра записей из протокола
событий общего формата (Окно > Показать панель> Прочие... > Профилирование и протоколы > Панель Протокол >
OK).
- Обновите панель Протоколы в проекции Профилирование и протоколы (<щелкните правой кнопкой на агенте протоколов 'HyadesLoggingLog4JSample'> > Обновить).
Для того чтобы запустить этот пример и вручную прикрепить агент ведения протоколов, выполните следующие действия:
- Подтвердите, что все ошибки компиляции исправлены.
- Если вы используете автономный экземпляр контроллера агентов, проверьте, подключен ли он (его подключать необязательно). Как
вариант, можно использовать прямое соединение, которое предоставляет ограниченный набор служб контроллера, установленных в Рабочей среде.
-
Запустите пример класса из проекции Java (Выполнить > Выполнить... > Создайте новую конфигурацию запуска типа приложений Java
> Класс main > Поиск... > HyadesLoggingLog4JSample > OK >Перейдите на вкладку Аргументы и задайте следующее свойство
JVM: -Dlog4j.configuration="file:/<рабочая-область>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml"
> Выполнить).
- Откройте проекцию Профилирование и протоколы (Окно> Открыть проекцию> Прочие... > Профилирование и протоколы).
- Подключитесь к агенту протоколов 'HyadesLoggingLog4JSample' в проекции Профилирование и протоколы (Выполнить > Профилирование... >
Подключиться - Java-процесс > Создать > Вкладка Хосты >. Используйте 'Прямое локальное соединение', если не подключен автономный
экземпляр контроллера агентов. Если этот экземпляр подключен, укажите действительное имя хоста и номер порта.
>Вкладка Агенты > Щелкните два раза на агенте HyadesLoggingLog4JSample > Перейдите на вкладку Назначение > Проект
профилирования > Обзор... > 'HyadesLoggingLog4JProject' > OK > Профилирование).
- Запустите мониторинг агента протоколов 'HyadesLoggingLog4JSample' (<щелкните правой кнопкой на агенте протоколов 'HyadesLoggingLog4JSample' > > Включить мониторинг).
- Откройте панель Протоколы в проекции Профилирование и протоколы для просмотра записей из протокола событий общего формата (Окно > Показать панель > Прочие... > Профилирование и протоколы > Панель Протоколы > OK).
- Обновите панель Протоколы в проекции Профилирование и протоколы (<щелкните правой кнопкой на агенте протоколов 'HyadesLoggingLog4JSample'> > Обновить).
(C) Copyright IBM Corporation 2000, 2006.