Instalacja panelu monitorowania (beta)

Edge dla chmury prywatnej w wersji 4.18.01

Wymagania systemowe

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

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.

W przypadku apigee-influxdb możesz zainstalować go 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 na 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, przekaż 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 apigee-telegraf setup. 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 (na 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. Rozpocznij 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 konfiguracji 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”.

   W pliku ustaw 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ę, używając danych logowania określonych w pliku konfiguracji dla 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 upewnić się, że apigee-telegraf zbiera dane:
   1. Uruchom apigee-service apigee-telegraf setup (jest idempotentny), 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 /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log nie ma błędów
2. Aby sprawdzić, czy usługa apigee-influxdb otrzymuje dane:
   1. Upewnij się, że te porty TCP są otwarte w węzłach danych apigee-influxdb: 8086 i 8183.
   2. Użyj tego adresu URL, aby otworzyć interfejs użytkownika 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 Zapytanie wpisz „show servers”. Sprawdź, czy na liście są widoczne 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 i 4.17.0x używają tej samej procedury
• Wersja 4.16.05 wymaga odinstalowania aplikacji apigee-collectd w ramach aktualizacji.

Aktualizacja 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 ją zaktualizować do wersji beta 4.18.01.

Aby zaktualizować panel monitorowania w wersji beta:

1. Zaktualizuj Edge do wersji 4.18.01 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 zainstalowano apigee-grafana na węźle serwera zarządzania, zaktualizuj apigee-grafana na węźle, na którym zainstalowano:

   > /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.18.01 odinstalujesz apigee-collectd i zainstalujesz apigee-telegraf.

Aby zaktualizować panel monitorowania w wersji beta:

1. Zaktualizuj Edge do wersji 4.18.01 zgodnie z opisem w artykułach Aktualizowanie Apigee Edge z wersji 4.16.01/4.16.05 do wersji 4.17.01 i Aktualizowanie Apigee Edge z wersji 4.16.09 do wersji 4.17.01.
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 zainstalowano apigee-grafana na węźle serwera zarządzania, zaktualizuj apigee-grafana na węźle, na którym 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.