Instalacja panelu monitorowania wersji beta

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:

  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 Konfiguracja
  3. 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:

  1. Na pierwszym węźle Edge zainstaluj apigee-telegraf:
    /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
  2. 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
  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.

Zainstaluj apigee-grafana na pojedynczy węzeł brzegowy

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

  1. Na pierwszym węźle Edge zainstaluj apigee-grafana:
    /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install
  2. 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
  3. Zmień właściciela na „apigee”:
    > chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt
  4. 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
  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ę 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:

  1. Aby zapewnić apigee-telegraf zbiera dane
    1. Uruchamianie apigee-service konfiguracja apigee-telegraf, metoda idempotentna, sprawdzanie pod kątem błędów, brakujące zależności i rozwiązywać problemy.
    2. Uruchom ponownie apigee-telegraf i sprawdź adres /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log. w przypadku błędów
  2. Aby zapewnić apigee-influxdb, odbiera 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 zostały utworzone te bazy danych: system, aplikacja, zdarzenia, _internal.
      2. W polu Zapytanie wpisz „pokaż serwery”.
        Upewnij się, że węzły apigee-influxdb są na liście produktów.
  3. Sprawdź źródła danych w panelu:
    1. W menu głównym kliknij Źródła danych. Powinny być widoczne ikony 3 źródeł danych.
    2. Kliknij ikonę każdego źródła danych.
    3. Na stronie z informacjami o źródle danych kliknij Zapisz & Testuj Przycisk
    4. 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:

  1. 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.
  2. 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.
  3. 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
  4. 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
  5. 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:

  1. 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.
  2. 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.
  3. 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
  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 odinstalowanie
  5. Powtórz krok 4 dla każdego węzła.