Работа с примером ведения протоколов Log4J

Этот пример демонстрирует поддержку TPTP для ведения протокола событий общего формата с помощью API ведения протоколов Apache Log4J. Пользователи применяют для ведения протоколов событий общего формата консоль или агент протокола.

Если вы еще не создали пример, создайте его, выбрав Файл > Создать > Пример... > Пример средств ведения протоколов Apache Log4J.

Пример состоит из исходного кода Java, зависимостей и файла конфигурации, необходимых для записи событий общего формата в средство ведения протоколов Apache Log4J.

Для компиляции и выполнения этого примера необходимо наличие Apache Log4J 1.2.8 (прилагается) или более поздних версий.

Предпосылки

  1. При запуске этого приложения из проекции Профилирование и протоколы в рабочей среде конфигурация запуска приложения или путь к классам приложения/службы контроллера агентов содержит Apache Log4J 1.2.8 или более поздних версий.
  2. Переменная среды 'log4j.configuration' задается в формате URL, где указан полный путь и имя файла конфигурации для ведения протоколов Apache Log4J (HyadesLoggingLog4JSample.xml). Пример: file:/<рабочая-область>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml.
  3. Определение типа документа (DTD) Apache Log4J (DTD), указанное в <файле JAR ведения протоколов Apache Log4J>/org/apache/log4j/xml/log4j.dtd, копируется в каталог <рабочая-область>/HyadesLoggingLog4JProject/cfg/ и используется файлом конфигурации ведения протоколов Apache Log4J (file:/<рабочая-область>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml).
Для того чтобы запустить этот пример и автоматически прикрепить агент ведения протоколов, выполните следующие действия:
  1. Подтвердите, что все ошибки компиляции исправлены.
  2. Если вы используете автономный экземпляр контроллера агентов, проверьте, подключен ли он (его подключать необязательно). Как вариант, можно использовать прямое соединение, которое предоставляет ограниченный набор служб контроллера, установленных в Рабочей среде.
  3. Откройте проекцию Профилирование и протоколы (Окно> Открыть проекцию> Прочие... > Профилирование и протоколы).
  4. Запустите пример класса в проекции Профилирование и протоколы (Выполнить > Профилирование... > Создайте новую конфигурацию запуска типа приложений Java > Задайте в примере имя проекта > Задайте класс main для 'HyadesLoggingLog4JSample' > Перейдите на вкладку Аргументы и укажите следующее свойство JVM: -Dlog4j.configuration="file:/<рабочая-область>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml" >Переключитесь на вкладку Монитор > Отмените выделение "Профилирование Java" и выберите "Средство поиска агентов" > Профилирование).
  5. Через несколько секунд агент протоколов будет автоматически найден и подключен. Выберите найденный агент протоколов и откройте панель Протокол в проекции Профилирование и протоколы для просмотра записей из протокола событий общего формата (Окно > Показать панель> Прочие... > Профилирование и протоколы > Панель Протокол > OK).
  6. Обновите панель Протоколы в проекции Профилирование и протоколы (<щелкните правой кнопкой на агенте протоколов 'HyadesLoggingLog4JSample'> > Обновить).

Для того чтобы запустить этот пример и вручную прикрепить агент ведения протоколов, выполните следующие действия:

  1. Подтвердите, что все ошибки компиляции исправлены.
  2. Если вы используете автономный экземпляр контроллера агентов, проверьте, подключен ли он (его подключать необязательно). Как вариант, можно использовать прямое соединение, которое предоставляет ограниченный набор служб контроллера, установленных в Рабочей среде.
  3. Запустите пример класса из проекции Java (Выполнить > Выполнить... > Создайте новую конфигурацию запуска типа приложений Java > Класс main > Поиск... > HyadesLoggingLog4JSample > OK >Перейдите на вкладку Аргументы и задайте следующее свойство JVM: -Dlog4j.configuration="file:/<рабочая-область>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml" > Выполнить).
  4. Откройте проекцию Профилирование и протоколы (Окно> Открыть проекцию> Прочие... > Профилирование и протоколы).
  5. Подключитесь к агенту протоколов 'HyadesLoggingLog4JSample' в проекции Профилирование и протоколы (Выполнить > Профилирование... > Подключиться - Java-процесс > Создать > Вкладка Хосты >. Используйте 'Прямое локальное соединение', если не подключен автономный экземпляр контроллера агентов. Если этот экземпляр подключен, укажите действительное имя хоста и номер порта. >Вкладка Агенты > Щелкните два раза на агенте HyadesLoggingLog4JSample > Перейдите на вкладку Назначение > Проект профилирования > Обзор... > 'HyadesLoggingLog4JProject' > OK > Профилирование).
  6. Запустите мониторинг агента протоколов 'HyadesLoggingLog4JSample' (<щелкните правой кнопкой на агенте протоколов 'HyadesLoggingLog4JSample' > > Включить мониторинг).
  7. Откройте панель Протоколы в проекции Профилирование и протоколы для просмотра записей из протокола событий общего формата (Окно > Показать панель > Прочие... > Профилирование и протоколы > Панель Протоколы > OK).
  8. Обновите панель Протоколы в проекции Профилирование и протоколы (<щелкните правой кнопкой на агенте протоколов 'HyadesLoggingLog4JSample'> > Обновить).