Monitorowanie danych z Java Database Connectivity (JDBC)

Można zdefiniować źródło danych w celu odbierania danych z bazy danych JDBC. Agent uruchamia zapytanie SQL w celu pobrania danych z bazy danych. Każda kolumna zwrócona przez zapytanie jest atrybutem w wynikowym zestawie danych.

1. Na stronie Początkowe źródło danych agenta lub na stronie Położenie źródła danych kliknij opcję Dane z serwera w obszarze Kategorie danych monitorowania.
2. W obszarze Źródła danych kliknij pozycję JDBC.
3. Kliknij przycisk Dalej.
4. Na stronie Informacje JDBC w obszarze Informacje JDBC kliknij przycisk Przeglądaj, aby połączyć się z bazą danych i zbudować zapytanie SQL.
   Użyj przeglądarki JDBC, aby nawiązać połączenie z bazą danych i przejrzeć jej tabele, dzięki czemu można zbudować zapytanie SQL gromadzące potrzebne dane. Podczas wybierania tabeli i kolumn generowane jest zapytanie, następnie atrybuty są dodawane dla poszczególnych kolumn zwracanych przez zapytanie. Wygenerowane zapytanie można zmodyfikować i przetestować, aby upewnić się, że zwracane są potrzebne dane.

   Uwaga: Można także samodzielnie utworzyć źródło danych JDBC bez klikania opcji Przeglądaj. Jeśli chcesz samodzielnie utworzyć źródło danych, podaj zapytanie i kliknij przycisk Dalej. Należy zdefiniować atrybut dla każdej kolumny zwróconej przez zapytanie w kolejności, w jakiej kolumny są zwracane.

   Dostawca danych JDBC umożliwia wykonanie zapytań SQL i procedur składowanych dla bazy danych w celu zgromadzenia danych monitorowania. Podczas określania zapytania SQL w celu zgromadzenia danych możesz użyć klauzuli where w instrukcji SQL, aby przefiltrować zwracane dane. Instrukcja SQL może także łączyć dane z wielu tabel. Oprócz instrukcji select języka SQL dostawca danych JDBC może uruchamiać procedury składowane. Więcej informacji na temat uruchamiania procedur składowanych można znaleźć w sekcji Procedury składowane.

5. Przy pierwszym otwarciu przeglądarki w oknie przeglądarki Java Database Connectivity (JDBC) wyświetlana jest informacja, że nie wybrano żadnych połączeń. Należy dodać połączenie. Kliknij przycisk Dodaj i wykonaj kroki w celu dodania połączenia.
   Jeśli połączenie zostało już zdefiniowane, zostanie ono użyte; można wtedy przejść do kroku 6.

   Uwaga: Pole Status pokazuje status bieżącego połączenia.

   Wykonaj poniższe kroki, aby dodać połączenie:
   1. Na stronie Połączenia JDBC kliknij opcję Połączenie JDBC, a następnie kliknij przycisk Dalej.
   2. Na stronie Właściwości połączenia wypełnij dostępne pola w następujący sposób:

      Nazwa połączenia

      Nazwa połączenia JDBC. Wpisz unikalną nazwę tego połączenia. Nazwy tej używa się do wskazania połączenia w przeglądarce.

      Typ bazy danych

      Typ bazy danych. Wybierz produkt bazy danych, z którym nawiązujesz połączenie. Na przykład, aby nawiązać połączenie z bazą danych IBM DB2, wybierz opcję DB2.

      Nazwa użytkownika

      Należy zdefiniować z co najmniej prawem do odczytu bazy danych, ale nie musi określać administratora bazy danych.

      Hasło

      Należy zdefiniować z co najmniej prawem do odczytu bazy danych, ale nie musi określać administratora bazy danych.

      Nazwa hosta

      Nazwa hosta, na którym jest uruchomiony serwer bazy danych. Za pomocą JDBC można monitorować zdalne bazy danych, nie ma więc ograniczenia do monitorowania baz danych w systemie lokalnym.

      Port

      Port na hoście używany przez serwer bazy danych do nasłuchiwania.

      Baza danych

      Nazwa bazy danych, z którą nawiązujesz połączenie.

      Katalog Jar

      Katalog zawierający pliki JAR JDBC używane do nawiązania połączenia z bazą danych. Wpisz nazwę ścieżki lub kliknij przycisk Przeglądaj, aby wskazać katalog.

   3. Opcjonalne: Zaznacz pole wyboru Zapisz hasło w obszarze roboczym Agent Builder, jeśli chcesz zapisać hasło dla tego połączenia.
   4. Opcjonalne: Zaznacz pole wyboru Ustaw jako wartości domyślne konfiguracji agenta, jeśli wartości domyślne dla tego typu serwera aplikacji mają być skopiowane z tych właściwości.
      Jeśli agent jest budowany w systemie, który jest podobny do systemów monitorowanych, zaleca się zaznaczenie tego pola. Jeśli to pole nie zostanie zaznaczone, użytkownik konfigurujący agenta będzie widział puste pole. Użytkownik ten musi określić wartości dla wszystkich informacji bez korzystania z wartości domyślnych.
   5. Kliknij opcję Testuj połączenie, aby utworzyć połączenie z bazą danych, która używa podanych parametrów konfiguracyjnych.
      Na stronie Właściwości połączenia zostanie wyświetlony komunikat wskazujący, czy nawiązanie połączenia powiodło się.
   6. Gdy połączenie działa, kliknij przycisk Zakończ.
6. W oknie Przeglądarka Java Database Connectivity (JDBC) nawiązywane jest połączenie ze skonfigurowaną bazą danych. Tabele znajdujące się w tej bazie danych są wyświetlane w obszarze Tabele bazy danych. Wybierz tabelę bazy danych, aby wyświetlić kolumny znajdujące się w tej tabeli w obszarze Kolumny w wybranej tabeli.
   Uwaga:

   1. Kliknij ikonę lornetki, aby wyszukać tabelę na liście Tabele bazy danych.
   2. Domyślnie wyświetlane są wszystkie tabele. Wyświetlane tabele można przefiltrować, wybierając inną opcję filtru. Dostępne opcje filtru zawiera Tabela 1.

      Tabela 1. Opcje filtru

      Opcja filtru	Opis
      Wszystko	Pokaż wszystkie tabele
      Użytkownik	Pokaż tylko tabele użytkowników
      System	Pokaż tylko tabele systemowe
      Wyświetl	Pokaż tylko widoki bazy danych

   Uwaga: Aby wczytać konkretne kolumny, wybierz tylko te kolumny. Jeśli wybierzesz tabelę, program Agent Builder automatycznie zbuduje zapytanie uwzględniające wszystkie kolumny tej tabeli, następnie utworzone zostaną atrybuty dla wszystkich kolumn, które aktualnie znajdują się w tabeli.

   Poniżej podano sposoby wybierania kolumn:

   • Wybierz tabelę, aby uzyskać domyślne zapytanie dotyczące wszystkich kolumn.
   • Wybierz kolumny, aby uwzględnić tylko te kolumny.
7. Opcjonalne: Zmodyfikuj wartości wyliczane, które są ustawione dla błędu, braku danych i braku wartość na stronie Informacje o atrybucie.
   Zmodyfikuj wartości, aby uniknąć ich nakładania się z wartościami rzeczywistymi, które mogą zostać zwrócone z kolumny tabeli bazy danych.
8. Opcjonalne: Kliknij opcję Testuj w oknie Przeglądarka Java Database Connectivity (JDBC), aby przetestować i zmodyfikować instrukcję SQL.
   Zostanie otwarte okno Uruchom instrukcję SQL.
   1. Podaj lub zmodyfikuj instrukcję SQL w polu Instrukcja SQL.
   2. Kliknij opcję Uruchom, aby uruchomić tę instrukcję SQL.
      Wyniki zostaną wyświetlone w obszarze Wyniki. Modyfikuj i testuj instrukcję, aż zwracane będą odpowiednie dane.
   3. Kliknij przycisk OK, aby zapisać instrukcję, utwórz poprawne atrybuty i wróć do okna Informacje JDBC.
9. Opcjonalne: Kliknij opcję Testuj w oknie Informacje JDBC, aby przetestować grupę atrybutów w bardziej realistycznym środowisku agenta. Więcej informacji na temat testowania grup atrybutów JDBC zawiera sekcja Testowanie grup atrybutów JDBC. Aby zmienić instrukcję JDBC podczas tego testu, należy dostosować atrybuty w taki sposób, aby istniał jeden atrybut dla każdej kolumny zwracanej przez instrukcję JDBC (w poprawnej kolejności).
10. Opcjonalne: Możesz utworzyć filtr ograniczający ilość danych zwracanych przez tę grupę atrybutów, klikając opcję Zaawansowane. Więcej informacji na temat filtrowania danych z grupy atrybutów zawiera sekcja Grupy atrybutów filtrowanych.
11. Na stronie Informacje JDBC w sekcji Systemy operacyjne wybierz systemy operacyjne i kliknij przycisk Dalej. Informacje na temat systemów operacyjnych, które należy wybrać, zawiera sekcja Określanie systemów operacyjnych.
    Uwaga: Kliknij opcję Wstaw właściwość konfiguracji, aby wybrać właściwość do wstawienia. Więcej informacji zawiera Dostosowywanie konfiguracji agenta.
12. Na stronie Wybierz atrybuty kluczowe wybierz atrybuty kluczowe lub wskaż, że to źródło danych tworzy tylko jeden wiersz danych. Więcej informacji można znaleźć w sekcji Wybieranie atrybutów kluczowych.
13. Jeśli chcesz przetestować wcześniej zdefiniowane źródło danych, w oknie edytora agenta wybierz kartę Źródła danych, a następnie wybierz źródło danych JDBC. W obszarze Informacje o grupie atrybutów JDBC kliknij przycisk Testuj. Więcej informacji na temat testowania zawiera sekcja Testowanie grup atrybutów JDBC.
14. Aby wyświetlić automatycznie wygenerowane sekcje konfiguracji, kliknij kartę Wstaw właściwość konfiguracji w edytorze agentów.
    Możesz zmienić etykiety lub wartości domyślne dla tych właściwości, aby były zgodne z wartościami domyślnymi, które widzi użytkownik podczas początkowego konfigurowania agenta.
15. Opcjonalne: Wprowadź dane na stronie Informacje o atrybucie; więcej informacji na ten temat zawiera sekcja Pola i opcje definiowania atrybutów. Wykonaj ten krok, jeśli została wybrana opcja samodzielnego utworzenia źródła danych JDBC bez klikania opcji Przeglądaj w kroku 4.
    Źródło danych JDBC programu Agent Builder obsługuje gromadzenie danych z większości typów SQL. Informacje, które zawiera Tabela 2, opisują typ atrybutu tworzony przez Przeglądarkę JDBC, gdy wykryje kolumnę o jednym z tych typów. Poniżej podano obsługiwane typy danych przeznaczone do użycia z agentem monitorowania.

    Tabela 2. Obsługiwane typy danych SQL przeznaczone do użycia z agentem monitorowania

    Typ danych SQL	Tworzony atrybut IBM Tivoli Monitoring
    BIGINT	64-bitowa wartość wskaźnika wartości w programie IBM Tivoli Monitoring. Jeśli zostanie zaznaczona opcja kompatybilności z programem IBM Tivoli Monitoring w wersji 6.2, jest to 32-bitowy wskaźnik wartości.
    DECIMALDOUBLEFLOATNUMERICREAL	Podane typy SQL są tworzone jako 64-bitowe atrybuty wskaźnika wartości w programie IBM Tivoli Monitoring. Jeśli metadane bazy danych zawierają wartość skali, zostanie użyta ta wartość. W przeciwnym razie dla skali jest ustawiona wartość 1. Jeśli zostanie zaznaczona opcja kompatybilności z programem IBM Tivoli Monitoring w wersji 6.2, ten atrybut będzie 32-bitowym wskaźnikiem wartości.
    BITINTEGERSMALLINTTINYINT	Poniższe typy SQL są tworzone jako 32-bitowe atrybuty wskaźnika wartości w programie IBM Tivoli Monitoring.
    BOOLEAN	Ta wartość jest 32-bitowym wskaźnikiem wartości w programie IBM Tivoli Monitoring z wyliczeniami dla wartości TRUE i FALSE.
    TIMESTAMP	Dane w kolumnach o tym typie są przekształcane w 16-bajtowy atrybut datownika programu IBM Tivoli Monitoring.
    TIMEDATECHARLONGVARCHARVARCHAR	Te typy SQL są traktowane przez przeglądarkę jako atrybuty łańcuchowe. Jako wielkość atrybutu używana jest wielkość kolumny do 256 znaków, co jest domyślną wielkością atrybutu łańcuchowego dla przeglądarki JDBC.

    Uwaga: Jeśli gromadzisz dane o typie danych, którego tu nie podano, domyślnie używany jest atrybut łańcuchowy. Agent także próbuje zgromadzić dane z bazy danych w postaci łańcucha.

    W razie potrzeby zmodyfikuj wartości wyliczane, które są ustawione dla błędu, braku danych i braku wartość na stronie Informacje o atrybucie. Zmodyfikuj wartości, aby uniknąć ich nakładania się z wartościami rzeczywistymi, które mogą zostać zwrócone z kolumny tabeli bazy danych.