Полное тестирование агента

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

Об этой задаче

Полное тестирование агента можно использовать, чтобы запустить агент тем же способом, которым он будет запускаться в IBM® Tivoli Monitoring, не устанавливая IBM Tivoli Monitoring.
Важное замечание: В системах Windows, если вы хотите запустить полный тест агента внутри Agent Builder (смотрите раздел Полное тестирование агента), убедитесь, что в окне Информация об агенте выбрана 32-битная версия операционной системы, в которой у вас работает Agent Builder, то есть 32-битная версия Windows. В Linux нужно выбрать 64-битную версию.

Процедура

  1. Откройте перспективу Тестирование агента:
    1. Откройте в редакторе агентов вкладку Информация об агенте.
    2. Щелкните по Тестирование агента.
      Рис. 1. Раздел Тестирование агента страницы редактора агентов Информация об агенте.
      Раздел Тестирование агента страницы Информация об агенте.

      Можно также выбрать в меню Agent Builder Окно > Открыть перспективу > Другое, выбрать Тестирование агента и щелкнуть по OK

    Откроется перспектива Тестирование агента (Рис. 3). В представлении Тестирование агента показаны агенты, которых вы открыли в редакторе агентов; вы можете протестировать любых из этих агентов. Кроме того, откроется представление Тестирование группы атрибутов; изначально это представление пустое. В представлении Тестирование группы атрибутов показаны данные, собранные в выбранной группе атрибутов во время работы агента.
    Совет: Если нет ни одного изменяемого агента, то перспектива Тестирование агента будет пуста. Чтобы заполнить представление, перейдите в перспективу IBM Tivoli Monitoring и откройте агент в редакторе агентов. Когда агент откроется в редакторе агентов, вернитесь в перспективу Тестирование агента, чтобы протестировать агент.
  2. Необязательно: Сконфигурируйте переменные среды и свойства конфигурации перед запуском теста.
    Окна Переменные среды и Конфигурация среды выполнения можно открыть из представления Тестирование агента двумя способами:
    • Щелкните правой кнопкой мыши по агенту в окне Тестирование агента, чтобы открыть меню выбора. Выберите в меню Задать среду, чтобы открыть окно Переменные среды. Выберите в меню Конфигурация, чтобы открыть окно Конфигурация среды выполнения.
    • Щелкните по значку просмотра меню значок просмотра меню в панели инструментов представления Тестирование агента, чтобы открыть пункты меню Задать среду и Конфигурация, как в предыдущем варианте.
    Дополнительную информацию об использовании окон Переменные среды и Конфигурация среды выполнения смотрите в разделе Тестирование групп атрибутов.
    Важное замечание:
    1. В агент автоматически будет внесена последняя конфигурация, относящаяся к каждой тестируемой группе атрибутов.
    2. Некоторые переменные среды имеют разные значения по умолчанию для тестирования агента и для полного тестирования агента. Дополнительную информацию о переменных среды со специальными значениями для тестирования группы атрибутов смотрите в разделе Переменные среды тестирования.
    3. Если источник данных JMX соединен с удаленным сервером WebSphere Application Server, убедитесь, что WebSphere Application Server установлен и для каталога Java задана среда JRE, используемая этим сервером. Более подробную информацию о конфигурировании соединения смотрите в разделе Мониторинг компонентов MBean Java Management Extensions (JMX).
    4. В источнике данных API Java, JDBC, JMX, HTTP или SOAP можно использовать параметры Java > Аргументы JVM для управления записью трассировки агента. Задайте следующее значение:
      -DJAVA_TRACE_MAX_FILES=файлы -DJAVA_TRACE_MAX_FILE_SIZE=размер
      где файлы - максимальное количество хранимых файлов журнала трассировки (значение по умолчанию - 4), а размер - максимальный размер файла журнала в килобайтах (значение по умолчанию - 5000). Например, можно задать следующее значение:
      -DJAVA_TRACE_MAX_FILES=7 -DJAVA_TRACE_MAX_FILE_SIZE=100
      В данном случае агент записывает 100 килобайт в первый файл журнала, затем переключается на второй файл и так далее. После записи семи файлов по 100 килобайтов каждый агент перезаписывает первый файл журнала.
    5. Если у вашего агента есть подузлы, в установленной версии можно задать разные значения конфигурации для различных узлов и отдельно для групп атрибутов базового агента. Однако в конфигурации полного тестирования агента каждое значение конфигурации можно задать только однажды; эти параметры применяются к базовому агенту и всем подузлам. Можно тестировать только один экземпляр каждого подузла.
  3. Выберите в представлении Тестирование агента агент, который вы хотите протестировать, и щелкните по значку значок Запуск агента Запуск агента.

    Окно показывает, что агент запускается. После запуска агента его группы атрибутов показаны как дочерние элементы агента в представлении Тестирование агента. Группы атрибутов помечены значком группы атрибутов значок группы атрибутов.

    Группы атрибутов, предоставляющие информацию об агенте (Состояние объекта производительности, Состояние пула потоков и Состояние выполнения действий) также показаны в представлении Тестирование агента как дочерние элементы агента. Группы атрибутов состояния помечены значком информации значок группы атрибутов.

    Одновременно можно запустить несколько агентов.

    После запуска агента становится активным значок Остановить агентзначок Остановить агент.

    Если у агента есть подузлы или группы навигатора, то они показываются в представлении Тестирование агента как узлы. Определения подузлов показаны под агентом. Узел экземпляра подузла показан под узлом определения подузла. Группы атрибутов и группы навигатора показаны под узлом экземпляра подузла. Например:
    Рис. 2. Представление Тестирование агента с выделенным примером подузла и группы навигатора.
    Окно Тестирование агента с подузлами и группами навигатора.
    Щелкните правой кнопкой мыши по любому узлу в представлении Тестирование агента, чтобы открыть пункты меню (например, Правка и Остановить агент. Правка открывает окно Определение источника данных для выбранного узла в редакторе агентов.
    Прим.: Изменения, внесенные в редакторе агентов, не будут видимы в работающем агенте, пока вы не перезапустите агент.
  4. Выберите в представлении Тестирование агента первую группу атрибутов для тестирования.
    Когда вы выберете группу атрибутов, начнется сбор данных для выбранной группы атрибутов. Если для сбора требуется некоторое время, то в окне показано, что выполняется сбор данных. По завершении сбора данных собранные данные показываются в представлении Тестирование группы атрибутов, например:
    Рис. 3. Перспектива Тестирование агента
    Перспектива Тестирование агента; показана выбранная группа атрибутов HTTP, в области Результаты показаны результаты сбора данных.
    Если не показано никаких данных, то в представлении Тестирование группы атрибутов будет выведено сообщение Возвращено 0 строк данных. Агент может не возвратить данные по нескольким причинам. Это следующие причины:
    • Нет данных
    • Неправильное определение
    • Неправильная конфигурация
    Определить причину, по которой не возвращено никаких данных, можно при помощи значения Код ошибки в группе атрибутов Состояние объекта производительности. Дополнительную информацию о просмотре группы атрибутов Состояние объекта производительности смотрите в описании шага 9.

    Чтобы собрать данные для другой группы атрибутов в работающем агенте, выберите нужную группу атрибутов.

    Если вы выберете группу атрибутов в представлении Тестирование агента, то соответствующая группа атрибутов будет показана в представлении Редактор агентов.
  5. Необязательно: Для некоторых типов групп атрибутов после начального сбора данных нужно запустить второй сбор данных, чтобы получить полезные значения.
    Чтобы запустить сбор данных, щелкните по значку сбора данных значок Собрать данные в представлении Тестирование группы атрибутов.

    Если для сбора требуется некоторое время, то в окне показано, что выполняется сбор данных. По завершении сбора данных вновь собранные данные показываются в представлении Тестирование группы атрибутов.

  6. Необязательно: Щелкните в представлении Тестирование группы атрибутов по заголовку столбца атрибута, чтобы открыть на вкладке Определение источника данных редактора агентов окно Информация об атрибуте. Это же окно Информация об атрибуте можно открыть, щелкнув в таблице правой кнопкой мыши по любой ячейке данных и выбрав в меню Правка.
    Можно изменить свойства атрибута обычным способом. Внесенные изменения не будут видимы в работающем агенте, пока вы не перезапустите агент.
  7. Необязательно: Одновременно можно открыть несколько представлений Тестирование группы атрибутов.
    Чтобы открыть дополнительное представление Тестирование группы атрибутов, щелкните по значку меню просмотра значок меню просмотра на панели инструментов представления Тестирование группы атрибутов и выберите представление Открыть представление для группы атрибутов.
    Прим.: Когда открывается дополнительное представление Тестирование группы атрибутов, в нем показана та же информация об атрибутах, что и в исходном представлении Тестирование группы атрибутов. После этого можно выбрать в представлении Тестирование агента другую группу атрибутов, чтобы показать в исходном представлении Тестирование группы атрибутов информацию о другой группе атрибутов. Когда дополнительное представление Тестирование группы атрибутов открывается в первый раз, оно открывается в том же положении, что и первоначальное представление, но с собственной вкладкой. Если вы хотите видеть оба представления одновременно, то можно перетащить вкладку в другое положение в рабочем пространстве.
  8. Необязательно: Если у агента есть подузлы, то можно выбрать группу атрибутов с информацией об экземпляре подузла, чтобы посмотреть, как подузлы перечислены в вашем агенте (Рис. 2). При выборе группы атрибутов с информацией об экземпляре подузла информация об экземпляре подузла будет показана в представлении Тестирование группы атрибутов (для всех подключенных подузлов выбранного типа).
  9. Необязательно: Чтобы посмотреть дополнительную информацию об операциях агента, можно выбрать группы атрибутов Состояние объекта производительности и Состояние пула потоков в представлении Тестирование агента. Эти группы атрибутов состояния помечены значком информации значок информации. Выберите эти группы, чтобы посмотреть информацию о состоянии предыдущих сборов данных для групп атрибутов.
    Например:
    Рис. 4. Представление Тестирование группы атрибутов, содержащее дополнительную информацию (Состояние объекта производительности) о сборах данных для групп атрибутов Managed_URLs и Managed_Nodes.
    В представлении Тестирование группы атрибутов показана информация о сборе данных для двух групп атрибутов. Для каждой группы атрибутов есть одна строка данных.
  10. По окончании тестирования агента щелкните по значку Остановить агент значок Остановить агент .