Instalacja panelu monitorowania wersji beta

Edge dla chmury prywatnej w wersji 4.17.09

Wymagania systemowe

Aby zbierać dane panelu, musisz zainstalować apigee-telegraf we wszystkich węzłach Edge. Dlatego wymagania systemowe apigee-telegraf są takie same jak w przypadku węzła Edge, na którym instalujesz tę usługę.

Możesz zainstalować apigee-grafana na osobnym węźle lub ponownie użyć jednego z istniejących węzłów Edge, takich jak serwer zarządzania lub węzeł interfejsu Edge.

apigee-influxdb możesz zainstalować na istniejącym węźle Edge, takim jak węzeł serwera zarządzania lub węzeł interfejsu Edge, bez zmiany wymagań systemowych.

Jeśli ze względu na wydajność zdecydujesz się zainstalować apigee-influxdb na osobnym węźle, węzeł ten powinien spełniać te wymagania:

• procesor dwurdzeniowy,
• 4 GB RAM
• 250 GB miejsca na dysku (dane monitorowania są usuwane po miesiącu)
• Co najmniej 1000 IOPS

Więcej informacji znajdziesz w dokumentacji InfluxData.

Wymagania dotyczące portów dla apigee-influxdb

Porty 8086 i 8183 muszą być otwarte w węzłach danych apigee-influxdb, aby umożliwić dostęp węzłowi, na którym działa apigee-grafana i apigee-telegraf.

Pliki konfiguracji do instalowania komponentów panelu

Aby zainstalować komponenty apigee-telegraf i apigee-grafana, musisz przekazać plik konfiguracji do narzędzia apigee-service. Zapisz te pliki w katalogu dostępnym dla użytkownika „apigee”, np. /opt/apigee/customer/application, i ustaw użytkownika „apigee” jako ich właściciela.

Parametry konfiguracji apigee-telegraf

Ustaw te właściwości w pliku tekstowym, który przekazujesz do polecenia setup apigee-telegraf. Możesz je na przykład ustawić w pliku tekstowym o nazwie sa_telegraf.txt:

http://192.168.0.1:8086

Parametry konfiguracji apigee-grafana

Ustaw te właściwości w pliku tekstowym, który przekazujesz do polecenia apigee-grafana setup. Możesz je na przykład ustawić w pliku tekstowym o nazwie sa_grafana.txt:

192.168.0.1

Instrukcje instalacji

Aby zainstalować komponenty panelu, wykonaj te czynności w podanej kolejności:

• apigee-influxdb (w węźle centralnym)
• apigee-telegraf (na każdym węźle)
• apigee-grafana (na serwerze centralnym)

Instalowanie apigee-influxdb w jednym węźle Edge lub węźle samodzielnym

Na węźle samodzielnym lub węźle Edge, na którym działa serwer zarządzania lub interfejs użytkownika Edge:

1. Zainstaluj apigee-influxdb:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install
2. Skonfiguruj bazę danych apigee-influxdb:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup
3. Uruchom apigee-influxdb:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb start

Instalowanie apigee-telegraf na każdym węźle Edge

Na każdym węźle instalacji Edge:

1. Na pierwszym węźle Edge zainstaluj apigee-telegraf:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
2. Utwórz plik konfiguracyjny dla apigee-telegraf o nazwie sa_telegraf.txt. Zwykle ten plik jest przechowywany w katalogu dostępnym dla użytkownika „apigee”, np. /opt/apigee/customer/application, i jest własnością użytkownika „apigee”.
   
   Ustaw w pliku tę właściwość, aby określić adres URL węzła apigee-influxdb, w tym port 8086:
   INFLUXDB_URL=http://influx_IP:8086
3. Zmień właściciela na „apigee”:
   > chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt
4. Skonfiguruj apigee-telegraf:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f /opt/apigee/customer/application/sa_telegraf.txt
5. Uruchom ponownie apigee-telegraf:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
6. Powtórz ten proces na wszystkich węzłach brzegowych.

Instalowanie apigee-grafana na pojedynczym węźle Edge

W jednym węźle instalacji Edge, np. w węźle interfejsu Edge:

1. Na pierwszym węźle Edge zainstaluj apigee-grafana:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install
2. Utwórz plik konfiguracji dla apigee-grafana o nazwie sa_grafana.txt. Zwykle ten plik jest przechowywany w katalogu dostępnym dla użytkownika „apigee”, np. /opt/apigee/customer/application, i jest własnością użytkownika „apigee”.
   
   Ustaw w pliku te właściwości. Te właściwości zostały opisane powyżej:
   INFLUXDB_HOST=192.168.56.101
   INFLUXDB_PORT=8086
   GRAFANA_USERNAME=admin
   GRAFANA_PASSWORD=admin
3. Zmień właściciela na „apigee”:
   > chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt
4. Skonfiguruj apigee-grafana za pomocą pliku konfiguracji:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f /opt/apigee/customer/application/sa_grafana.txt
5. Uruchom ponownie apigee-grafana:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana restart

Aby uzyskać dostęp do panelu, otwórz w przeglądarce ten adres URL:

http://grafana_IP_or_DNS:3000

Zaloguj się przy użyciu danych logowania podanych w pliku konfiguracji apigee-grafana. W przykładzie powyżej nazwa użytkownika i hasło to admin/admin.

Rozwiązywanie problemów z instalacją

Jeśli nie widzisz danych w panelu, wykonaj te czynności, aby rozwiązać problemy z instalacją:

1. Aby sprawdzić, czy apigee-telegraf zbiera dane:
   1. Uruchom polecenie apigee-service apigee-telegraf setup, które jest idempotentne, sprawdź, czy nie ma błędów i brakujących zależności, i rozwiąż je.
   2. Uruchom ponownie apigee-telegraf i sprawdź, czy w pliku /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log nie ma błędów.
2. Aby sprawdzić, czy apigee-influxdb odbiera dane:
   1. Upewnij się, że na węzłach danych apigee-influxdb są otwarte te porty TCP: 8086 i 8183.
   2. Użyj tego adresu URL, aby otworzyć interfejs influxdb w przeglądarce:
      http://influxdb_IP_or_DNS:8183
      1. W polu Zapytanie wpisz „show databases”.
         Sprawdź, czy zostały utworzone te bazy danych: system, application, events, _internal.
      2. W polu Query (Zapytanie) wpisz „show servers”.
         Upewnij się, że na liście znajdują się węzły apigee-influxdb.
3. Sprawdź źródła danych w panelu:
   1. W menu głównym wybierz Źródła danych. Powinny wyświetlić się ikony 3 źródeł danych.
   2. Wybierz ikonę dla każdego źródła danych.
   3. Na stronie z informacjami o źródle danych kliknij przycisk Zapisz i przetestuj.
   4. Jeśli źródło danych jest skonfigurowane prawidłowo, powinien pojawić się komunikat w formie:
      Sukces
      Źródło danych działa

Aktualizowanie panelu monitorowania w wersji beta

Użyj jednej z 2 poniższych procedur w zależności od wersji Edge, z której przeprowadzasz uaktualnienie:

• Wersje 4.16.09, 4.17.01 i 4.17.05 używają tej samej procedury
• Wersja 4.16.05 wymaga odinstalowania apigee-collectd w ramach aktualizacji.

Aktualizacja z wersji 4.16.09, 4.17.01 lub 4.17.05

Jeśli masz zainstalowaną wersję beta panelu monitorowania Apigee w wersji 4.16.09, 4.17.01 lub 4.17.05, możesz ją zaktualizować do wersji beta 4.17.09.

Aby zaktualizować panel monitorowania w wersji beta:

1. Zaktualizuj Edge do wersji 4.17.09 zgodnie z opisem w artykułach Aktualizowanie Apigee Edge z wersji 4.17.01/4.17.05 do wersji 4.17.09, Aktualizowanie Apigee Edge z wersji 4.16.09 do wersji 4.17.09 i Aktualizowanie Apigee Edge z wersji 4.16.01/4.16.05 do wersji 4.17.09.
2. Zaktualizuj apigee-influxdb w węźle serwera zarządzania:
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
   
   gdzie configFile to plik konfiguracji użyty do zainstalowania apigee-influx.
   
   Jeśli na węźle serwera zarządzania zainstalowano też apigee-grafana, ten krok spowoduje również zaktualizowanie apigee-grafana. W przeciwnym razie zaktualizuj apigee-granfana, jak pokazano w następnym kroku.
3. Jeśli nie masz zainstalowanego apigee-grafana na węźle serwera zarządzania, zaktualizuj apigee-grafana na węźle, na którym jest zainstalowany:
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
4. Zaktualizuj apigee-telegraf w węźle 1:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf update
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f configFile
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
5. Powtórz krok 4 dla każdego węzła.

Aktualizacja z wersji 4.16.05

Wersja 4.16.05 panelu używała apigee-collectd zamiast apigee-telegraf. W ramach aktualizacji do wersji 4.17.09 odinstaluj apigee-collectd i zainstaluj apigee-telegraf.

Aby zaktualizować panel monitorowania w wersji beta:

1. Zaktualizuj Edge do wersji 4.17.09 zgodnie z opisem w artykułach Aktualizowanie Apigee Edge z wersji 4.17.01/4.17.05 do wersji 4.17.09, Aktualizowanie Apigee Edge z wersji 4.16.09 do wersji 4.17.09 i Aktualizowanie Apigee Edge z wersji 4.16.01/4.16.05 do wersji 4.17.09.
2. Zaktualizuj apigee-influxdb w węźle serwera zarządzania:
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
   
   gdzie configFile to plik konfiguracji użyty do zainstalowania apigee-influx.
   
   Jeśli na węźle serwera zarządzania zainstalowano też apigee-grafana, ten krok spowoduje również zaktualizowanie apigee-grafana. W przeciwnym razie zaktualizuj apigee-granfana, jak pokazano w następnym kroku.
3. Jeśli nie masz zainstalowanego apigee-grafana na węźle serwera zarządzania, zaktualizuj apigee-grafana na węźle, na którym jest zainstalowany:
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
4. Zainstaluj apigee-telegraf w węźle 1:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-collectd stop
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f configFile
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
   > /opt/apigee/apigee-service/bin/apigee-service apigee-collectd uninstall
5. Powtórz krok 4 dla każdego węzła.