Integrowanie z IBM ITM V6

Podsumowanie

Integracja produktu IBM Tivoli Monitoring V6 z Instana jest realizowana przez aktualizację agentów ITM V6 lub ITCAM V7 do komunikacji w trybie dual . Dzięki temu agenty będą nadal wysyłać dane do serwera TEMS IBM oraz do nowej usługi IBM Monitoring Instana Integration Service. Usługa IBM Monitoring Instana Integration Service odbiera i transformuje ładunki metryk z agentów i na żądanie przekazuje te ładunki do czujnika ibm-apmproxy . Czujnik ibm-apmproxy w agencie hosta Instana wysyła ładunki do serwera Instana, na którym są przetwarzane ładunki, tworzy jednostki na serwerze Instana i zapisuje metryki do wyświetlenia w interfejsie użytkownika Instana. Począwszy od usługi IBM Monitoring Instana Integration Service 1.1.0, agenty IBM Application Performance Monitoring (APM) V8 mogą być również zintegrowane z serwerem Instana za pomocą tej usługi. Agenty IBM APM V8 muszą być połączone tylko z jednym serwerem monitorowania, APM v8 lub usługą IBM Monitoring Instana Integration Service. Począwszy od produktu IBM Monitoring Instana Integration Service 1.1.1, z serwerem Instana można zintegrować agenty IBM APM V8 MQ i ACE (IIB) oraz agenty ITCAM V7 MQ i IIB. Począwszy od usługi IBM Monitoring Instana Integration Service 1.1.3, agenty WAS IBM APM V8 i agenty WAS ITCAM V7 można zintegrować z serwerem Instana.

Aktywowanie obsługi IBM ITM V6

Aby aktywować tę obsługę, należy wykonać następujące czynności:

1. Pobierz pakiet wdrożenia dla usługi IBM Monitoring Instana Integration Service ze strony https://github.com/instana/ibm-monitoring-integration i postępuj zgodnie z instrukcjami, aby wdrożyć tę usługę. Jeśli ta usługa została wcześniej wdrożona, ponowne jej wdrożenie przy użyciu nowego pakietu wdrażania spowoduje jej zaktualizowanie.
2. Włącz czujnik ibm-apmproxy w agencie hosta Instana.
3. Skonfiguruj obsługiwane agenty ITM V6 lub ITCAM V7 do komunikacji z usługą IBM Monitoring Instana Integration Service.

Pakiet wdrożeniowy umożliwia wdrożenie usługi IBM Monitoring Instana Integration Service w systemie, który nie ma połączenia z Internetem (tzw. "powietrze-ograniczone").

Wdrożenie obsługuje tryb wysokiej dostępności (HA) dla nowych wdrożeń. Jeśli tryb HA jest włączony, tworzone są trzy instancje zasobników dla komponentów stanfulset (zookeeper i kafka). W przypadku komponentów bezstanowych można określić liczbę replik (minimalna liczba replik wynosi 2).

Przyjmowanie wielkości mierzonych przez czujnik ibm-apmproxy w agencie hosta jest domyślnie dezaktywowane. Aby włączyć odbieranie danych agenta ITM w agencie hosta, zapoznaj się z sekcją Konfiguracja czujnika . Należy zauważyć, że obsługa ITM V6 ponownie wykorzystuje czujnik ibm-apmproxy, który został pierwotnie udostępniony na potrzeby integracji z produktem IBM APM V8.

Aktywowanie wsparcia IBM APM V8

Agenty APM V8 połączone z usługą IBM Monitoring Instana Integration Service mogą wyświetlać tylko wielkości mierzone w interfejsie użytkownika Instana i nie mogą wysyłać wielkości mierzonych do serwera APM V8 . Jeśli wymagane jest wyświetlanie wielkości mierzonych z agentów APM V8 zarówno w interfejsie użytkownika APM V8 , jak i w interfejsie użytkownika Instana, należy zapoznać się z informacjami na temat obsługi interfejsu APM V8 w sekcji ibm-apmproxy sensor documentation (Dokumentacja czujnika ibm-apmproxy).

Jeśli usługa IBM Monitoring Instana Integration Service nie została jeszcze wdrożona, należy wykonać następujące czynności:

1. Pobierz pakiet wdrożenia z serwisu IBM Monitoring Instana Integration Service pod adresem https://github.com/instana/ibm-monitoring-integration i postępuj zgodnie z instrukcjami, aby wdrożyć usługę.
2. Włącz czujnik ibm-apmproxy w agencie hosta Instana.
3. Skonfiguruj obsługiwane agenty APM V8 do komunikacji z usługą IBM Monitoring Instana Integration Service.

Jeśli wdrożono już usługę IBM Monitoring Instana Integration Service do użytku z agentami ITM V6 i ITCAM V7 , należy wykonać następujące czynności:

1. Pobierz pakiet wdrożenia dla usługi IBM Monitoring Instana Integration Service ze strony https://github.com/instana/ibm-monitoring-integration i znajdź dokumentację dotyczącą konfigurowania agentów.
2. Skonfiguruj obsługiwane agenty APM V8 do komunikacji z usługą IBM Monitoring Instana Integration Service.

Obsługiwane Wersje

Usługa IBM Monitoring Instana Integration ma ogólnie dostępną obsługę wielkości mierzonych dla następujących agentów ITM, ITCAM i APM V8 :

• Linux w wersji 6.3.0.7 z pakietem poprawek 6 lub nowszym w systemach xLinux, zLinuxi pLinux
• IBM APM V8 Linux w wersji 06.35.14.0.21 lub nowszej w systemach xLinux, zLinuxi pLinux
• Datapower agent w wersji 7.1.1 FP3 lub nowszej
• IBM APM V8 Datapower agent 8.20.06 lub nowszy
• Agent dla systemu Windows, wersja 6.3.0.7 , pakiet poprawek 6 lub nowszy
• IBM APM V8 agent systemu operacyjnego Windows w wersji 06.35.14.17 lub nowszej
• Agent systemu operacyjnego Unix w wersji 6.3.0.7 , pakiet poprawek 6 lub nowszy w systemie AIX
• IBM APM V8 agent systemu operacyjnego Unix 06.35.14.17 lub nowszy w systemie AIX
• IBM MQ agent w wersji 7.3 FP3 lub nowszej
• IBM ACE (IIB) agent w wersji 7.3 FP3 lub nowszej
• Agent IBM APM V8 MQ w wersji 8.20.04 lub nowszej
• Agent IBM APM V8 ACE w wersji 8.20.04 lub nowszej
• IBM WAS agent w wersji 7.2 IF12 lub nowszej
• Agent IBM WAS V8 w wersji 8.20.04 lub nowszej

Uwaga: agenty ITM i ITCAM muszą być zainstalowane z poprawką 6.3.0.7 IF0009 TEMA (środowisko podstawowe). Agenty APM V8 muszą być zainstalowane z poprawką 8.1.4.0 IF0018 TEMA (środowisko podstawowe).

Konfiguracja

com.instana.plugin.ibmapmproxy:
  enabled: true
  # host: Provide the hostname or IP address of the system where the IBM Monitoring Instana Integration Service is running.  No quotation marks are needed.
  host: '<INSERT_HOST_HERE>' # Instana Integration Component host
  # port: provide the port defined for contacting the IBM Monitoring Instana Integration Service. No quotation marks are needed.
  port: 443 # Instana Integration Component port Default
  datainterval: 1 # Default
  heartbeatinterval: 15 # Default  
  # protocol: indicate whether to connect with the IBM Monitoring Instana Integration Service using the secure (SSL) port or the insecure port.  Values are either "http" or "https".  Default is "https".  No quotation marks are needed. Ensure the value provided for the "port" variable is the appropriate port for your server.
  protocol: https # Default

Kolekcja metryk

Aby wyświetlić pomiary, należy wybrać opcję Infrastruktura na pasku bocznym interfejsu użytkownika Instana, kliknąć konkretnego monitorowanego hosta, a następnie wyświetlić panel kontrolny hosta ze wszystkimi zgromadzonymi pomiarami i monitorowanymi procesami.

Za pomocą tej integracji gromadzone są tylko metryki. Przy użyciu tej ścieżki nie są gromadzone żadne dane śledzenia z agentów ITCAM.

Lista wielkości mierzonych pobranych z agenta systemu operacyjnego Linux , agenta systemu operacyjnego Windows i agenta systemu operacyjnego Unix znajduje się w serwisie Instana Host sensor . Listę wielkości mierzonych zgromadzonych przez agenta IBM Datapower zawiera czujnik IBM Datapower . Listę wielkości mierzonych zgromadzonych z agenta IBM MQ zawiera czujnik IBM MQ . Patrz czujnik IBM ACE , aby uzyskać listę wielkości mierzonych dla agenta IBM ACE (IIB). Patrz czujnik IBM WAS , aby uzyskać listę zgromadzonych wielkości mierzonych z agenta IBM WebSphere Application Server (WAS).

Uwagi:

1. Obsługa wielkości mierzonych IBM DataPower za pośrednictwem tej integracji wymaga, aby serwer Instana był w wersji Build 201 lub nowszej.
2. Obsługa metryk IBM ACE (IIB) za pośrednictwem tej integracji wymaga, aby serwer Instana był w wersji Build 216 lub nowszej.
3. Aby zapewnić obsługę wielkości mierzonych serwera WAS IBM za pośrednictwem tej integracji, agent systemu operacyjnego IBM musi być zainstalowany i uruchomiony w tym samym systemie, co agent serwera WAS IBM .
4. Niektóre metryki oczekiwane w hoście Instana, związane z danymi, MQ, ACE (IIB) i związane z serwerem WAS nie są obecnie gromadzone przez agenty IBM . Te pomiary będą puste lub będą miały wartość null w interfejsie użytkownika Instana. Z pakietem instalacyjnym dostarczany jest dokument PDF o nazwie InstanaVisualizationOfITMAgents.pdf , który ułatwia odwzorowanie wielkości mierzonych w interfejsie użytkownika Instana na portal ITM Tivoli Enterprise Portal (TEP). Interfejs użytkownika.
5. Wielkości mierzone są gromadzone z obsługiwanych agentów monitorowania IBM , które są przyłączone do usługi IBM Monitoring Instana Integration Service i przekazywane do Instana, a następnie w interfejsie użytkownika Instana są tworzone jednostki Host, Datapower, MQ, ACE (IIB) i WAS.
6. Wielkości mierzone są gromadzone przez agenty monitorowania IBM w odstępie czasu zdefiniowanym w plikach subskrypcji, które są dostarczane agentom z usługi IBM Monitoring Instana Integration Service. Dostępne wielkości mierzone dla wszystkich obsługiwanych agentów są pobierane przez czujnik apmproxy co sekundę, gdy te wielkości mierzone stają się dostępne w usłudze IBM Monitoring Instana Integration Service.

Znane problemy

Podczas sprawdzania wielkości mierzonych w interfejsie użytkownika Instana dla jednostki hosta, która jest tworzona przez usługę IBM Monitoring Instana Integration, może się okazać, że przycisk Otwórz zarządzanie agentami w interfejsie użytkownika Instana nie działa. Jest to oczekiwane i normalne, ponieważ wielkości mierzone nie są dostarczane przez agenta Instana, który działa bezpośrednio na monitorowanym hoście.
Jeśli w tym scenariuszu konieczne jest sprawdzenie działania agenta Instana, wybierz opcję Agenty w bocznym obszarze nawigacyjnym i znajdź agenta Instana, który jest uruchomiony na tym samym hoście co usługa IBM Monitoring Integration.

Podpisy poprawności

Informacje na temat sygnatury poprawności zawiera dokumentacja czujnika ibm-apmproxy.

Informacje dodatkowe