Конфигурация JMX

Если вы задаете в агенте источник данных JMX, то некоторые свойства конфигурации создаются автоматически.

Конфигурация среды выполнения JMX уникальна в том отношении, что позволяет регулировать объем выводимой о ней информации. Клиент JMX для агента может соединяться с несколькими различными типами серверов прикладных программ. Однако обычно нет необходимости поддерживать все эти типы серверов прикладных программ в одном агенте. Вы можете выбрать, какие типы серверов прикладных программ нужно поддерживать, и ненужные разделы конфигурации не войдут в состав агента.

В большинстве случаев агент разрабатывается для мониторинга одного типа серверов прикладных программ JMX. При создании источника данных JMX можно использовать браузер JMX. В случае использования браузера JMX все опции конфигурации сервера JMX, использовавшиеся для поиска сервера MBean, добавляются в агент автоматически. Чтобы изменить типы серверов прикладных программ, с которыми можно соединиться после создания агента, щелкните по Глобальные опции JMX в области Информация об источнике данных JMX. Измените на странице Опции для всего агента JMX нужные параметры.

Можно разработать универсальный агент, который может отслеживать несколько типов серверов прикладных программ JMX. В этом случае можно выбрать несколько вариантов конфигурации сервера JMX на странице Опции для всего агента JMX. Если поддерживается несколько типов соединений JMX, то конфигурация среды выполнения будет сообщать, какой тип соединения будет использоваться с данным экземпляром агента.

Прим.: Экземпляр агента может соединяться только с одним типом серверов прикладных программ JMX. Подузлы в пределах экземпляра агента можно использовать для связи с различными серверами прикладных программ JMX одного типа. Для связи с несколькими типами серверов прикладных программ JMX нужно сконфигурировать по меньшей мере по одному экземпляру агента для каждого типа серверов прикладных программ JMX.

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

Если вы определяете в агенте источник данных JMX, агент должен использовать Java™ для связи с сервером прикладных программ JMX. Свойства конфигурации Java добавляются в агент автоматически.

Следующие свойства конфигурации Java специфичны для конфигурации среды выполнения агента:

Домашний каталог Java: Полный путь, указывающий на каталог установки Java
Сконфигурируйте агент так, чтобы они использовал ту же машину JVM, что и программа для мониторинга; это особенно важно для сервера WebLogic и сервера WebSphere Application Server.
Аргументы JVM: Задает необязательный список аргументов для виртуальной машины Java.
Уровень трассировки: Определяет объем информации, записываемой в файл трассировки Java. Значение по умолчанию - записывать в файл трассировки только данные об ошибках.

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

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

Соединение: Тип соединения с сервером MBean
ID пользователя: ID пользователя, используемый для аутентификации на сервере MBean.
Пароль: Пароль ID пользователя.
Базовые пути: Каталоги, в которых выполняется поиск файлов JAR, указанных в поле Путь классов, или каталогов, указанных в поле Каталоги JAR (с неполными именами). Имена каталогов разделяются точкой с запятой (;) в Windows и точкой с запятой (;) или двоеточием (:) в системах UNIX.
Путь класса: Файлы JAR с явно указанными именами, поиск которых выполняет агент. К каждому из базовых путей добавляются все неполные имена файлов, пока не будет найден файл JAR.
Каталоги JAR: Каталоги, в которых выполняется поиск файлов JAR. Имена каталогов разделяются точкой с запятой (;) в Windows и точкой с запятой (;) или двоеточием (:) в системах UNIX. Файлы JAR в этих каталогах необязательно идентифицировать явным образом; они будут найдены, поскольку располагаются в одном из этих каталогов. В подкаталогах этих каталогов поиск не выполняется. К каждому из базовых путей добавляются все неполные имена каталогов, пока каталог не будет найден.

Прим.: При удаленном мониторинге файлы JAR и все зависимые от них файлы JAR должны быть локально установлены на компьютере, на котором работает агент. Эти файлы JAR требуются для соединения с отслеживаемой программой. Эти файлы JAR нужно задать в полях Каталоги JAR, Базовые пути и Путь классов. Кроме того, нужно локально установить поддерживаемую JVM для отслеживаемой программы и задать путь в поле Конфигурация каталога установки Java.

Примеры:

Для WebLogic 10 путь классов - это server/lib/wlclient.jar;server/lib/wljmxclient.jar. Базовый путь указывает на каталог сервера прикладных программ WebLogic, в котором расположен каталог server/lib.
Для WebSphere базовый путь указывает на каталог, в котором установлен сервер WebSphere Application Server. В этом примере показано несколько базовых путей, чтобы задать значение по умолчанию для Windows и UNIX. Путь классов задает файлы JAR относительно базового пути. Относительное значение lib в поле Каталоги JAR указывает, что нужно загрузить все файлы JAR из этого каталога, который находится в базовом пути.
- Базовые пути: : C:\Program Files\IBM\WebSphere\AppServer;/opt/IBM/WebSphere/AppServer
- Путь классов: runtimes/com.ibm.ws.admin.client_6.1.0.jar;plugins/com.ibm.ws.security.crypto_6.1.0.jar
- Каталоги JAR: lib

В зависимости от типов серверов JMX, выбранных на странице Опции для всего агента JMX, добавляются все или только некоторые из следующих свойств конфигурации. Agent Builder задает значения по умолчанию, которые можно изменить:

Свойства конфигурации соединения JSR-160 Compliant Server:

URL службы JMX: URL служб JMX, с которым устанавливается соединение для мониторинга.

Свойства конфигурации соединения с сервером WebSphere Application Server версии 6.0 и новее:

Имя хоста: Имя хоста компьютера, на котором находится отслеживаемый сервер прикладных программ. При локальном мониторинге это имя локального компьютера. При удаленном мониторинге это имя хоста компьютера, на котором находится сервер прикладных программ.
Порт: Номер порта, используемый для имени подлежащего мониторингу хоста.
Протокол соединения: Протокол, используемый соединением мониторинга. Поддерживаются RMI и SOAP.
Имя профиля: Имя профиля, используемого для конфигурирования соединения.

Свойства конфигурации соединения с сервером JBoss Application Server (не JSR-160):

Имя JNDI: Имя JNDI, используемое для поиска сервера MBean.
URL провайдера: URL провайдера служб JMX, с которым устанавливается соединение для мониторинга.

Свойства конфигурации соединения с сервером WebLogic Server:

URL службы: URL провайдера служб JMX, с которым устанавливается соединение для мониторинга (включая имя JNDI).

Прим.: Если разрешена защита администрирования WebSphere, то нужно запретить запрос регистрации клиентов в соответствующих файлах свойств соединений клиентов. В случае соединений RMI, чтобы запретить клиентам запрашивать пользователей, нужно изменить свойство com.ibm.CORBA.loginSource в файле sas.client.props в каталоге properties профиля сервера WebSphere Application Server. Для соединений SOAP нужно изменить свойство com.ibm.SOAP.loginSource в файле soap.client.props в том же каталоге. В обоих случаях свойство loginSource не должно содержать значение.

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