Мониторинг данных из Java Database Connectivity (JDBC)

Вы можете задать источник данных, чтобы получать данные из базы данных JDBC. Агент выполняет запрос SQL для сбора данных из базы данных. Каждый столбец, возвращенный запросом - это атрибут в полученном наборе данных.

1. На странице Начальный источник данных агента или Положение источника данных щелкните по Данные с сервера в области Категории данных мониторинга.
2. В области Источники данных нажмите JDBC.
3. Нажмите кнопку Далее.
4. В области Информация о JDBC страницы Информация о JDBC нажмите Обзор, чтобы соединиться с базой данных и построить запрос SQL.
   Браузер JDBC позволяет соединиться с базой данных и просмотреть ее таблицы, чтобы можно было построить запрос SQL для сбора нужных данных. После того, как вы выберете таблицу и столбцы, будет создан запрос и будут добавлены атрибуты для каждого столбца, возвращенного запросом. Этот запрос можно изменить и протестировать, чтобы убедиться, что запрос возвращает именно нужные данные.

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

   Провайдер данных JDBC позволяет выполнять запросы SQL и хранимые процедуры в базе данных для сбора данных мониторинга. Когда вы задаете запрос SQL, вы можете включить в оператор SQL условие where, чтобы применить фильтр к возвращаемым данным. Оператор SQL может также объединять данные из нескольких таблиц. Помимо операторов SQL select, провайдер данных JDBC может выполнять хранимые процедуры. Информацию о выполнении хранимых процедур смотрите в разделе Хранимые процедуры.

5. При первом запуске браузера в окне Браузер Java Database Connectivity (JDBC) будет указано, что не выбрано ни одного соединения. Нужно добавить соединение. Щелкните по Добавить и выполните действия, указанные в разделе Действия по добавлению соединения.
   Если соединение уже задано, то будет использовано это соединение и вы можете перейти к шагу 6.

   Прим.: В поле Состояние указано состояние текущего соединения.

   Чтобы добавить соединение, сделайте следующее:
   1. На странице Соединения JDBC нажмите Соединение JDBC, а затем нажмите Далее.
   2. На странице Свойства соединения введите данные в поля, как это показано ниже:

      Имя соединения

      Имя соединения JDBC. Задайте уникальное имя для этого соединения. Это имя будет использоваться для ссылки на соединение в браузере.

      Тип базы данных

      Тип базы данных. Выберите тип базы данных, с которой вы хотите установить соединение. Например, чтобы установить соединение с базой данных IBM DB2, выберите DB2.

      Имя пользователя

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

      Пароль

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

      Имя хоста

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

      Порт

      Номер порта ожидания на хосте сервера базы данных.

      База данных

      Имя базы данных, с которой нужно установить соединение.

      Каталог jar

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

   3. Необязательно: Включите переключатель Сохранить пароль в рабочем пространстве Agent Builder, чтобы сохранить пароль для этого соединения.
   4. Необязательно: Включите переключатель Задать для конфигурации агента в качестве значений по умолчанию, если вы хотите, чтобы значения по умолчанию для этого типа сервера прикладных программ были скопированы из этих свойств.
      Если вы конструируете агент в системе, похожей на ваши отслеживаемые системы, то рекомендуется выбрать этот переключатель. Если этот переключатель не выбран, то пользователь, конфигурирующий агент, видит пустое поле. В таком случае пользователь должен задать значения всех параметров без значений по умолчанию.
   5. Щелкните по Проверить соединение, чтобы создать соединение с базой данных с использованием заданных параметров конфигурации.
      На странице Свойства соединения будет показано сообщение, указывающее, успешно ли установлено соединение.
   6. Если соединение работает, то щелкните по Готово.
6. В окне Браузер Java Database Connectivity (JDBC) установлено соединение с базой данных. Таблицы, содержащиеся в базе данных, показаны в области Таблицы базы данных. Выберите таблицу базы данных, чтобы показать в области Столбцы в выбранной таблице столбцы, содержащиеся в этой таблице.
   Прим.:

   1. Щелкните по значку бинокля, чтобы выполнить поиск в списке Таблицы базы данных.
   2. По умолчанию показаны все таблицы. Можно применить фильтр к таблицам, выбрав различные опции фильтра. Возможные опции фильтров приведены в Табл. 1.

      Табл. 1. Опции фильтра

      Опция фильтра	Описание
      Все	Показать все таблицы
      Пользователь	Показать только пользовательские таблицы
      Система	Показать только системные таблицы
      View	Показать только производные таблицы базы данных

   Прим.: Если вы хотите извлечь какие-то определенные столбцы, выберите только эти столбцы. Если вы выберете таблицу, Agent Builder автоматически создаст запрос, собирающий из таблицы все столбцы, которые там есть в настоящий момент.

   Столбцы можно выбрать следующими способами:

   • Выбрать таблицу и получить запрос по умолчанию для всех столбцов.
   • Выберите столбцы, чтобы получить только эти столбцы.
7. Необязательно: Измените значения перечисления, заданные для параметров Ошибка, Отсутствуют данные и Нет значения на странице Информация об атрибуте.
   Измените значения, чтобы исключить пересечение с допустимыми значениями, которые могли быть возвращены из столбцов таблицы базы данных.
8. Необязательно: Щелкните по Тест в окне Браузер Java Database Connectivity (JDBC), чтобы проверить и изменить оператор SQL.
   Откроется окно Выполнить оператор SQL.
   1. Введите или измените оператор SQL в поле Оператор SQL.
   2. Щелкните по Выполнить, чтобы выполнить оператор SQL.
      Результаты показаны в области Результаты. Продолжайте изменять и тестировать оператор, пока вы не будете удовлетворены возвращаемыми данными.
   3. Нажмите кнопку OK, чтобы сохранить оператор, создать правильные атрибуты и вернуться в окно Информация о JDBC.
9. Необязательно: Чтобы протестировать группу атрибутов в более реальной среде агента, нажмите Тест в окне Информация о JDBC. Дополнительную информацию о тестировании групп атрибутов JDBC смотрите в разделе Тестирование групп атрибутов JDBC Если во время этого теста вы измените оператор JDBC, вы также должны скорректировать атрибуты, чтобы оператор JDBC возвращал по одному атрибуту для каждого столбца в правильном порядке.
10. Необязательно: Можно создать фильтр, который ограничивает данные, возвращаемые группой атрибутов, нажав Дополнительно. Дополнительную информацию о фильтрации данных в группах атрибутов смотрите в разделе Фильтрация групп атрибутов.
11. На странице Информация о JDBC выберите в разделе Операционные системы операционную систему и нажмите кнопку Далее. Информацию о том, как выбрать операционную систему, смотрите в разделе Указание операционной системы.
    Прим.: Щелкните по Вставить свойство конфигурации, чтобы выбрать свойство для вставки. Более подробную информацию смотрите в разделе Настройка конфигурации агента.
12. Выберите на странице Выбрать атрибуты ключа атрибуты ключа или укажите, что этот источник данных создает только одну строку данных. Дополнительную информацию смотрите в разделе Выбор атрибутов ключей.
13. Если вы хотите протестировать ранее созданный источник данных, то выберите в окне редактора агентов вкладку Источники данных и выберите источник данных JDBC. Щелкните по Тест в области Информация о группе атрибутов JDBC. Дополнительную информацию о тестировании смотрите в разделе Тестирование групп атрибутов JDBC.
14. Чтобы просмотреть автоматически сгенерированные разделы конфигурации, щелкните по вкладке Вставить свойство конфигурации в редакторе агентов.
    Можно изменить метки или значения по умолчанию для этих свойств, чтобы они соответствовали значениям по умолчанию, которые пользователь видит при начальном конфигурировании агента.
15. Необязательно: Заполните страницу Информация об атрибуте; дополнительную информацию смотрите в разделе Поля и опции для определения атрибутов. Сделайте это, чтобы создать источник данных JDBC вручную, не нажимая Обзор на шаге 4.
    Источник данных JDBC Agent Builder поддерживает сбор данных из большинства типов SQL. В Табл. 2 описан тип атрибутов, создаваемый браузером JDBC, если он обнаруживает столбец одного из следующих типов. Это типы данных, поддерживаемые для использования с агентом мониторинга.

    Табл. 2. Типы типы данных SQL, поддерживаемые для использования с агентом мониторинга

    Тип данных SQL	Создаваемый атрибут IBM Tivoli Monitoring
    BIGINT	Этот тип данных представляет 64-битное значение показателя в IBM Tivoli Monitoring. Если выбрана совместимость с IBM Tivoli Monitoring версии 6.2, то это будет 32-битный показатель.
    DECIMALDOUBLEFLOATNUMERICREAL	Эти типы SQL создаются в IBM Tivoli Monitoring как 64-битные атрибуты показателей. Если метаданные базы данных содержат значение шкалы, то используется это значение; в ином случае задается значение шкалы, равное 1. Если выбрана совместимость с IBM Tivoli Monitoring версии 6.2, то это будет 32-битный показатель.
    BITINTEGERSMALLINTTINYINT	Эти типы SQL создаются в IBM Tivoli Monitoring как 32-битные атрибуты показателей.
    BOOLEAN	Это 32-битное значение показателя в IBM Tivoli Monitoring с нумерациями TRUE и FALSE.
    TIMESTAMP	Данные в столбце этого типа преобразуются в 16-битный атрибут отметки времени IBM Tivoli Monitoring.
    TIMEDATECHARLONGVARCHARVARCHAR	Эти типы SQL обрабатываются браузером как строковые атрибуты. Размер столбца - это размер атрибута (до 256); это размер строкового атрибута по умолчанию для браузера JDBC.

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

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