Instalacja panelu monitorowania (beta)

Edge for Private Cloud w wersji 4.18.01

Wymagania systemowe

Aby zbierać dane panelu, musisz zainstalować apigee-telegraf na wszystkich węzłach brzegowych. Dlatego wymagania systemowe dotyczące instancji apigee-telegraf są takie same jak dla węzła brzegowego, na którym go instalujesz.

Możesz zainstalować apigee-grafana w oddzielnym węźle lub ponownie użyć jednego z istniejących węzłów brzegowych, takich jak węzeł zarządzania serwerem zarządzania lub interfejsem użytkownika brzegowego.

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

Jeśli ze względów związanych z wydajnością zdecydujesz się zainstalować apigee-influxdb w własnym węźle, musi on spełniać te wymagania:

• Procesor 2-rdzeniowy
• 4 GB RAM
• 250 GB miejsca na dysku (dane monitorowania są trwale usuwane po miesiącu)
• 1000 lub więcej IOPS

Więcej informacji znajdziesz w dokumentacji InfluxData.

Wymagania dotyczące portu dla apigee-influxdb

Porty 8086 i 8183 muszą być otwarte w węzłach danych apigee-influxdb, aby umożliwić dostęp węzełowi z systemem apigee-grafana i apigee-telegraf.

Pliki konfiguracyjne do instalowania komponentów panelu

Aby zainstalować komponenty apigee-telegraf i apigee-grafana, należy przekazać plik konfiguracyjny do narzędzia apigee-service. Zapisz te pliki w katalogu dostępnym dla użytkownika „apigee”, np. /opt/apigee/customer/application, i przyznaj je użytkownikowi „apigee”.

Parametry konfiguracji apigee-telegraf

Ustaw te właściwości w pliku tekstowym przekazywanym do polecenia apigee-telegraf setup. Na przykład umieść je 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 przekazywanym do polecenia apigee-grafana setup. Na przykład umieść je w pliku tekstowym o nazwie sa_grafana.txt:

192.168.0.1

Instrukcje instalacji

Aby zainstalować komponenty panelu w następującej kolejności:

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

Zainstaluj apigee-influxdb w jednym węźle brzegowym lub samodzielnym

W samodzielnym węźle lub węźle brzegowym, 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. Uruchomienie apigee-influxdb:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb start

Zainstaluj apigee-telegraf w każdym węźle brzegowym

W każdym węźle instalacji Edge:

1. W pierwszym węźle brzegowym zainstaluj apigee-telegraf:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install

2. Utwórz plik konfiguracyjny dla platformy apigee-telegraf o nazwie sa_telegraf.txt. Zwykle zapisujesz ten plik w katalogu dostępnym dla użytkownika „apigee”, np. /opt/apigee/customer/application, i ustawiasz go jako właściciela 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 instancję apigee-telegraf:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart

6. Powtórz ten proces we wszystkich węzłach brzegowych.

Zainstaluj apigee-grafana w jednym węźle brzegowym

W jednym węźle instalacji Edge, na przykład węzła UI Edge:

1. W pierwszym węźle brzegowym zainstaluj apigee-grafana:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install

2. Utwórz plik konfiguracyjny dla platformy apigee-grafana o nazwie sa_grafana.txt. Zwykle zapisujesz ten plik w katalogu dostępnym dla użytkownika „apigee”, np. /opt/apigee/customer/application, i ustawiasz go jako właściciela użytkownika „apigee”.

   Ustaw w pliku te właściwości. Te właściwości są 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 przy użyciu pliku konfiguracyjnego:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f
       /opt/apigee/customer/application/sa_grafana.txt

5. Uruchom ponownie instancję apigee-grafana:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana restart

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

http://grafana_IP_or_DNS:3000

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

Rozwiązywanie problemów z instalacją

Jeśli nie widzisz danych w panelu, wykonaj tę procedurę, aby rozwiązać problemy z instalacją:

1. Aby mieć pewność, że apigee-telegraf gromadzi dane
   1. Uruchom apigee-service apigee-telegraf setup, to działanie idempotentne, sprawdź błędy i brakujące zależności, a następnie je napraw.
   2. Uruchom ponownie instancję apigee-telegraf i sprawdź, czy w domenie /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log nie ma błędów
2. Aby upewnić się, że apigee-influxdb otrzymuje dane:
   1. Sprawdź, czy w 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 „pokaż bazy danych”. Upewnij się, że utworzono te bazy danych: system, application, events, _internal.
      2. W polu Zapytanie wpisz „pokaż serwery”. Sprawdź, czy 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 być widoczne ikony 3 źródeł danych.
   2. Wybierz ikonę 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 tym formacie:
      Sukces
      Źródło danych działa

Aktualizuję panel monitorowania wersji beta

Wykonaj jedną z tych procedur w zależności od wersji Edge, z której chcesz przejść:

• 4.16.09 i 4.17.0x używają tej samej procedury.
• 4.16.05 wymaga odinstalowania apigee-collectd w ramach aktualizacji.

Zaktualizuj z wersji 4.16.09 lub 4.17.0x

Jeśli masz zainstalowaną wersję beta panelu monitorowania Apigee w wersji 4.16.09 lub 4.17.0x, możesz zaktualizować ją do wersji beta (4.18.01).

Aby zaktualizować panel monitorowania beta:

1. Zaktualizuj Edge do wersji 4.18.01 zgodnie z opisem w sekcjach Aktualizacja Apigee Edge z wersji 4.17.01/4.17.05 do 4.17.09, Aktualizacja Apigee Edge do wersji 4.16.09 do 4.17.09 oraz Aktualizacja Apigee Edge do wersji 4.16.01/4.9.16.
2. Zaktualizuj instancję apigee-influxdb w węźle serwera zarządzania:

   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile

   gdzie configFile to plik konfiguracyjny użyty do zainstalowania apigee-influx.

   Jeśli zainstalowano też usługę apigee-grafana w węźle serwera zarządzania, ten krok spowoduje też zaktualizowanie instancji apigee-grafana. W przeciwnym razie zaktualizuj apigee-granfana, jak pokazano poniżej.

3. Jeśli usługa apigee-grafana nie została zainstalowana w węźle serwera zarządzania, zaktualizuj apigee-grafana w węźle, w którym ją zainstalowano:

   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile

4. Zaktualizuj instancję 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

Panel w wersji 4.16.05 zamiast apigee-telegraf używał apigee-collectd. Podczas aktualizacji do wersji 4.18.01 odinstalowujesz apigee-collectd i zainstalujesz apigee-telegraf.

Aby zaktualizować panel monitorowania beta:

1. Zaktualizuj Edge do wersji 4.18.01 zgodnie z opisem w sekcjach Aktualizacja Apigee Edge z wersji 4.16.01/4.16.05 do 4.17.01 i Aktualizacja Apigee Edge do wersji 4.16.09 do wersji 4.17.01.
2. Zaktualizuj instancję apigee-influxdb w węźle serwera zarządzania:

   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile

   gdzie configFile to plik konfiguracyjny użyty do zainstalowania apigee-influx.

   Jeśli zainstalowano też usługę apigee-grafana w węźle serwera zarządzania, ten krok spowoduje też zaktualizowanie instancji apigee-grafana. W przeciwnym razie zaktualizuj apigee-granfana, jak pokazano poniżej.

3. Jeśli usługa apigee-grafana nie została zainstalowana w węźle serwera zarządzania, zaktualizuj apigee-grafana w węźle, w którym ją zainstalowano:

   > /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.