Edge for Private Cloud wer. 4.17.09
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:
Właściwość |
Opis |
---|---|
INFLUXDB_URL |
Podaj adres URL węzła apigee-influxdb, w tym port 8086. Na przykład: 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:
Właściwość |
Opis |
---|---|
INFLUXDB_HOST |
Podaj adres IP lub nazwę DNS węzła InfluxDB. Na przykład: 192.168.0.1 |
INFLUXDB_PORT |
Port interfejsu InfluxDB API używany przez źródło danych Grafana. Podaj numer 8086. |
GRAFANA_USERNAME |
Nazwa użytkownika Grafana do logowania się do interfejsu panelu. |
GRAFANA_PASSWORD |
Hasło Grafana do logowania się w interfejsie panelu. |
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:
- Zainstaluj apigee-influxdb:
> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb find - Skonfiguruj bazę danych apigee-influxdb:
> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup - 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:
- W pierwszym węźle brzegowym zainstaluj apigee-telegraf:
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf instalacja - 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 - Zmień właściciela na „apigee”:
> chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt - Skonfiguruj apigee-telegraf:
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f /opt/apigee/customer/application/sa_telegraf.txt - Uruchom ponownie apigee-telegraf:
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart - 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:
- W pierwszym węźle brzegowym zainstaluj apigee-grafana:
> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana instalacja - 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 - Zmień właściciela na „apigee”:
> chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt - 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 - 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ą:
- Aby mieć pewność, że usługa apigee-telegraf
gromadzi dane
- 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.
- Uruchom ponownie apigee-telegraf i sprawdź, czy na stronie /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log nie ma błędów.
- Aby upewnić się, że usługa apigee-influxdb
otrzymuje dane:
- Upewnij się, że w węzłach danych apigee-influxdb są otwarte te porty TCP: 8086 i 8183.
- Użyj tego adresu URL, aby otworzyć interfejs influxdb w przeglądarce:
http://influxdb_IP_or_DNS:8183- W polu Zapytanie wpisz „pokaż bazy danych”.
Upewnij się, że utworzono te bazy danych: system, application, events, _internal. - W polu Zapytanie wpisz „pokaż serwery”.
Sprawdź, czy na liście znajdują się węzły apigee-influxdb.
- W polu Zapytanie wpisz „pokaż bazy danych”.
- Sprawdź źródła danych w panelu:
- W menu głównym wybierz Źródła danych. Powinny być widoczne ikony 3 źródeł danych.
- Wybierz ikonę każdego źródła danych.
- Na stronie z informacjami o źródle danych kliknij przycisk Zapisz i przetestuj.
- 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, 4.17.01 i 4.17.05 korzystają z tej samej procedury
- 4.16.05 wymaga odinstalowania pakietu apigee-collectd w ramach aktualizacji.
Zaktualizuj 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 zaktualizować ją do wersji beta 4.17.09.
Aby zaktualizować panel monitorowania beta:
- Zaktualizuj Edge do wersji 4.17.09 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.09.
- 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. - 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 - 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
> - Powtórz krok 4 dla każdego węzła.
Aktualizacja z wersji 4.16.05
Panel w wersji 4.16.05 używał metody apigee-collectd zamiast apigee-collectd. Przy aktualizacji do wersji 4.17.09 odinstalowujesz aplikację apigee-collectd i instalujesz aplikację apigee-telegraf.
Aby zaktualizować panel monitorowania beta:
- Zaktualizuj Edge do wersji 4.17.09 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.09.
- 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. - 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 - 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-service/bin/apigee-service apigee-telegraf instalacja
> ge/geapi
configFile - Powtórz krok 4 dla każdego węzła.