Edge for Private Cloud w wersji 4.17.09
Wymagania systemowe
Musisz zainstalować apigee-telegraf na wszystkich węzłach brzegowych, aby zbierać dane z panelu. Dlatego wymagania systemowe dla apigee-telegraf są takie same jak w przypadku Edge w węźle, w którym go instalujesz.
Możesz zainstalować apigee-grafana w oddzielnym węźle lub użyj jednego z istniejących węzłów brzegowych, takich jak serwer zarządzania lub brzeg Węzeł interfejsu użytkownika.
W przypadku instancji apigee-influxdb możesz zainstalować go w istniejącym węźle brzegowym, takim jak węzeł serwera zarządzania lub węzeł brzegowy interfejsu użytkownika, przy użyciu bez żadnych zmian w wymaganiach systemowych.
Jeśli zdecydujesz się zainstalować apigee-influxdb w oddzielnym węźle dla: ze względu na wydajność, węzeł powinien spełniać te wymagania:
- Procesor dwurdzeniowy
- 4 GB RAM
- 250 GB miejsca na dysku (monitorowanie powoduje trwałe usunięcie danych po 1 miesiącu)
- 1000 lub więcej IOPS
Zobacz InfluxData, aby dowiedzieć się więcej.
Wymagania dotyczące portu dla apigee-influxdb
W węzłach danych apigee-influxdb muszą być otwarte porty 8086 i 8183, aby mieć dostęp do węzeł z uruchomionym architekturą apigee-grafana oraz apigee-telegraf.
Pliki konfiguracyjne do instalowania panelu komponenty
Aby zainstalować apigee-telegraf i apigee-grafana, przekazać plik konfiguracyjny do narzędzia apigee-service. Przechowuj te pliki w katalog dostępny przez „apigee” np. /opt/apigee/customer/application, i uczynić je własnością „apigee” użytkownika.
Parametry konfiguracji apigee-telegraf
Ustaw je w pliku tekstowym przekazywanym do polecenia apigee-telegraf setup. Na przykład umieść je w plik tekstowy 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 dla apigee-grafana
Ustaw te właściwości w pliku tekstowym przekazywanym do polecenia apigee-grafana setup. Przykład: umieść 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 API InfluxDB używany przez źródło danych Grafana. Wpisz kod 8086. |
GRAFANA_USERNAME |
Nazwa użytkownika Grafana służąca do logowania się w interfejsie użytkownika panelu. |
GRAFANA_PASSWORD |
Hasło Grafana do logowania się w interfejsie panelu. |
Instrukcje instalacji
Aby zainstalować komponenty panelu, wykonaj te czynności:
- apigee-influxdb (w węzeł centralny)
- apigee-telegraf (na każdym węzła)
- apigee-grafana (na serwer centralny)
Zainstaluj apigee-influxdb w pojedynczym węźle brzegowym lub samodzielnym węźle
W samodzielnym węźle lub węźle brzegowym, na którym jest uruchomiony interfejs użytkownika serwera zarządzania lub brzegowego:
- Zainstaluj apigee-influxdb:
/opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install - Skonfiguruj bazę danych apigee-influxdb:
/opt/apigee/apigee-service/bin/apigee-service apigee-influxdb Konfiguracja - Uruchom apigee-influxdb:
/opt/apigee/apigee-service/bin/apigee-service apigee-influxdb start
Zainstaluj apigee-telegraf na każdy węzeł brzegowy
W każdym węźle instalacji Edge:
- Na pierwszym węźle Edge zainstaluj apigee-telegraf:
/opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install - Utwórz plik konfiguracji apigee-telegraf o nazwie sa_telegraf.txt.
Zwykle przechowujesz ten plik w katalogu, do którego prowadzi „apigee” użytkownika,
jako /opt/apigee/customer/application,
i uczynić go własnością „apigee” użytkownika.
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 - 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 na wszystkich węzłach brzegowych.
Zainstaluj apigee-grafana na pojedynczy węzeł brzegowy
W jednym węźle instalacji Edge, na przykład w węźle Edge UI:
- Na pierwszym węźle Edge zainstaluj apigee-grafana:
/opt/apigee/apigee-service/bin/apigee-service apigee-grafana install - Utwórz plik konfiguracyjny dla projektu apigee-grafana o nazwie sa_grafana.txt. Zazwyczaj
przechowujesz ten plik w katalogu dostępnym dla „apigee” np. /opt/apigee/customer/application,
i uczynić go własnością „apigee” użytkownika.
Ustaw w pliku te właściwości. Opis tych właściwości znajduje się 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 konfiguracyjnego:
/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ę za pomocą danych logowania podanych w pliku konfiguracji projektu apigee-grafana. W przykładzie powyżej nazwa użytkownika/hasło to admin/admin.
Rozwiązywanie problemów z instalacją
Jeśli nie widzisz danych w panelu, wykonaj poniższe czynności, aby rozwiązać problem instalacji:
- Aby zapewnić apigee-telegraf
zbiera dane
- Uruchamianie apigee-service konfiguracja apigee-telegraf, metoda idempotentna, sprawdzanie pod kątem błędów, brakujące zależności i rozwiązywać problemy.
- Uruchom ponownie apigee-telegraf i sprawdź adres /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log. w przypadku błędów
- Aby zapewnić apigee-influxdb,
odbiera dane:
- Sprawdź, czy 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 zostały utworzone te bazy danych: system, aplikacja, zdarzenia, _internal. - W polu Zapytanie wpisz „pokaż serwery”.
Upewnij się, że węzły apigee-influxdb są na liście produktów.
- W polu Zapytanie wpisz „pokaż bazy danych”.
- Sprawdź źródła danych w panelu:
- W menu głównym kliknij Źródła danych. Powinny być widoczne ikony 3 źródeł danych.
- Kliknij ikonę każdego źródła danych.
- Na stronie z informacjami o źródle danych kliknij Zapisz & Testuj Przycisk
- Jeśli źródło danych jest prawidłowo skonfigurowane, powinien pojawić się komunikat w tym formacie:
Gotowe
Źródło danych działa
Aktualizowanie panelu monitorowania wersji beta
Użyj jednej z dwóch poniższych procedur, zależnie od wersji Edge, z której uaktualniasz:
- 4.16.09, 4.17.01 i 4.17.05 należy zastosować tę samą procedurę
- Wersja 4.16.05 wymaga odinstalowania pliku apigee-collectd w ramach aktualizacji.
Aktualizacja wersja 4.16.09, 4.17.01 lub 4.17.05
Jeśli masz zainstalowaną wersję beta panelu monitorowania Apigee w wersjach 4.16.09, 4.17.01 lub 4.17.05 możesz zaktualizować do wersji beta 4.17.09.
Aby zaktualizować panel monitorowania wersji beta:
- Zaktualizuj Edge do wersji 4.17.09 zgodnie z opisem w artykule Aktualizowanie Apigee Edge w wersji 4.17.01/4.17.05 do wersji 4.17.09. Zaktualizuj Apigee Edge 4.16.09 do wersji 4.17.09 oraz Zaktualizuj Apigee Edge 4.16.01/4.16.05 do 4.17.09.
- Zaktualizuj plik apigee-influxdb na
węzeł serwera zarządzania:
/opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
gdzie configFile to plik konfiguracyjny użyty do instalacji apigee-influx.
Jeśli w panelu zarządzania zainstalowano też apigee-grafana węzła serwera, należy też wykonać ten krok, aby zaktualizować obiekt apigee-grafana. W przeciwnym razie zaktualizuj apigee-granfana w tagu kolejny krok. - Jeśli nie zainstalujesz apigee-grafana w
Węzeł serwera zarządzania, zaktualizuj apigee-grafana w węźle, w którym
zainstalowano:
> /opt/apigee/apigee-setup/bin/update.sh -c pp -f plik konfiguracyjny - Zaktualizuj plik apigee-telegraf w
węzeł 1:
/opt/apigee/apigee-service/bin/apigee-service apigee-telegraf aktualizacja
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f configFile
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart - Powtórz krok 4 dla każdego węzła.
Aktualizacja wersji 4.16.05
Wersja 4.16.05 panelu używała parametru apigee-collectd zamiast apigee-telegraf. W ramach aktualizacji do 4.17.09 odinstalowujesz interfejs apigee-collectd i instalujesz apigee-telegraf.
Aby zaktualizować panel monitorowania wersji beta:
- Zaktualizuj Edge do wersji 4.17.09 zgodnie z opisem w artykule Aktualizowanie Apigee Edge w wersji 4.17.01/4.17.05 do wersji 4.17.09. Zaktualizuj Apigee Edge 4.16.09 do wersji 4.17.09 oraz Zaktualizuj Apigee Edge 4.16.01/4.16.05 do 4.17.09.
- Zaktualizuj plik apigee-influxdb na
węzeł serwera zarządzania:
/opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
gdzie configFile to plik konfiguracyjny użyty do instalacji apigee-influx.
Jeśli w panelu zarządzania zainstalowano też apigee-grafana węzła serwera, należy też wykonać ten krok, aby zaktualizować obiekt apigee-grafana. W przeciwnym razie zaktualizuj apigee-granfana w tagu kolejny krok. - Jeśli nie zainstalujesz apigee-grafana w
Węzeł serwera zarządzania, zaktualizuj apigee-grafana w węźle, w którym
zainstalowano:
> /opt/apigee/apigee-setup/bin/update.sh -c pp -f plik konfiguracyjny - 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 odinstalowanie - Powtórz krok 4 dla każdego węzła.