Instalacja panelu monitorowania wersji beta

Edge for Private Cloud wer. 4.17.05

Wymagania systemowe

Aby zbierać dane panelu, musisz zainstalować apigee-telegraf na wszystkich węzłach brzegowych. Dlatego wymagania systemowe 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 Edge.

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 wydajności zdecydujesz się zainstalować apigee-influxdb w własnym węźle, musi on spełniać następujące 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 mogły uzyskać dostęp do węzła obsługującego apigee-grafana i apigee-telegraf.

Pliki konfiguracyjne do instalowania komponentów panelu

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

Parametry konfiguracji apigee-telegraf

Skonfiguruj te właściwości w pliku tekstowym, który przekazujesz do polecenia apigee-telegraf setup. Możesz na przykład umieścić 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. Możesz na przykład umieścić 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 find
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

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 instalacja
2. Utwórz plik konfiguracyjny apigee-telegraf o nazwie sa_telegraf.txt. Zwykle zapisujesz ten plik w katalogu dostępnym dla użytkownika „apigee”, takim jak /opt/apigee/customer/application, i ustawiasz go w katalogu użytkownika „apigee”.
   
   Ustaw w pliku tę właściwość, aby określić adres URL węzła apigee-influxdb z uwzględnieniem portu 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 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 instalacja
2. Utwórz plik konfiguracyjny apigee-grafana o nazwie sa_grafana.txt. Zwykle plik jest przechowywany w katalogu dostępnym dla użytkownika „apigee”, takim jak /opt/apigee/customer/application, i staje się jego własnością użytkownika „apigee”.
   
   Ustaw w pliku poniższe 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 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 ten URL w przeglądarce:

http://grafana_IP_or_DNS:3000

Zaloguj się przy użyciu danych logowania podanych w pliku konfiguracyjnym 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 usługa apigee-telegraf gromadzi dane
   1. Uruchom konfigurację apigee-service apigee-telegraf, jest ona idempotentna, sprawdź, czy nie występują błędy i brakujące zależności, i rozwiąż je.
   2. Uruchom ponownie apigee-telegraf i sprawdź, czy na stronie /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log nie ma błędów.
2. Aby upewnić się, że usługa apigee-influxdb otrzymuje dane:
   1. Upewnij się, że 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.01 używają tej samej procedury
• 4.16.05 wymaga odinstalowania pakietu apigee-collectd w ramach aktualizacji.

Zaktualizuj z wersji 4.16.09 lub 4.17.01

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

Aby zaktualizować panel monitorowania beta:

1. Zaktualizuj Edge do wersji 4.17.05 zgodnie z opisem w sekcjach Aktualizacja Apigee Edge z wersji 4.17.01 do 4.17.05, Aktualizacja Apigee Edge do wersji 4.16.09 do 4.17.05 oraz Aktualizacja Apigee Edge do wersji 4.16.01/4.16.05.17.05.
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 w węźle serwera zarządzania zainstalowano też apigee-grafana, ten krok spowoduje też zaktualizowanie obiektu apigee-grafana. W przeciwnym razie zaktualizuj apigee-granfana, jak pokazano w kolejnym kroku.
3. Jeśli nie zainstalowano elementu apigee-grafana w węźle serwera zarządzania, zaktualizuj element apigee-grafana w węźle, w którym został zainstalowany:
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f plik konfiguracji
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 ge-apie/grafe-apise/grafe/apigerestart -f configFile
   >
5. Powtórz krok 4 dla każdego węzła.