Instalacja panelu monitorowania (beta)

Edge for Private Cloud w wersji 4.18.01

Wymagania systemowe

Musisz zainstalować apigee-telegraf we wszystkich węzłach brzegowych, aby zbierać dane z panelu. W związku z tym wymagania systemowe usługi apigee-telegraf są takie same jak w przypadku Edge w węźle, w którym go instalujesz.

Możesz zainstalować aplikację 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 apigee-influxdb można: 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 osobnym 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 Dokument InfluxData .

Wymagania dotyczące portu dla apigee-influxdb

W węzłach danych apigee-influxdb muszą być otwarte porty 8086 i 8183, aby uzyskać dostęp węzeł uruchomiony apigee-grafana i apigee-telegraf

Pliki konfiguracyjne do instalowania panelu komponenty

Aby zainstalować: apigee-telegraf i apigee-grafana, przekazujesz plik konfiguracyjny do narzędzia apigee-service. Przechowuj te pliki w katalog dostępny przez „apigee” użytkownika, takiego jak /opt/apigee/customer/application, i uczynić je własnością „apigee” użytkownika.

Parametry konfiguracji apigee-telegraf

Ustaw te właściwości w pliku tekstowym, który przekazujesz do apigee-telegraf setup . Na przykład umieść 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 dla apigee-grafana

Ustaw te właściwości w pliku tekstowym, który przekazujesz do apigee-grafana setup . Na 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 centralnym węźle)
  • apigee-telegraf (w każdym węźle)
  • apigee-grafana (na serwerze centralnym)
.

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 setup
  3. Rozpoczęcie 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 konfiguracyjny usługi apigee-telegraf o nazwie sa_telegraf.txt Zwykle plik znajduje się w katalogu, do którego „apigee” użytkownik, taki jak /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 funkcję 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 usługi apigee-grafana o nazwie sa_grafana.txt. Zwykle przechowujesz ten plik w katalogu, do którego prowadzi „apigee” użytkownika, na przykład /opt/apigee/customer/application i ustaw własność na „apigee” użytkownika.

    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 w 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ę za pomocą danych logowania podanych w pliku konfiguracji dla 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. Uruchom polecenie apigee-service apigee-telegraf setup, jest idempotentne, sprawdź błędów, braku zależności i rozwiązywać je.
    2. Uruchom ponownie apigee-telegraf i sprawdź /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log w przypadku błędów
  2. Aby upewnić się, że usługa apigee-influxdb otrzymuje dane:
    1. Sprawdź, czy w apigee-influxdb węzłach danych są otwarte te porty TCP: 8086 i 8183.
    2. Użyj poniższego adresu URL, aby otworzyć interfejs influxdb w przeglądarce:
      http://influxdb_IP_or_DNS:8183
      1. W polu Zapytanie wpisz „pokaż bazy danych”. Sprawdź, czy następujące bazy danych utworzone: system, application, events, _internal.
      2. W polu Zapytanie wpisz „pokaż serwery”. Upewnij się, że jest wyświetlana ikona Na liście znajduje się apigee-influxdb węzłó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 i 4.17.0x należy wykonać tę samą procedurę
  • Wersja 4.16.05 wymaga odinstalowania apigee-collectd w ramach aktualizacji.

Aktualizacja 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że go zaktualizować do wersji beta 4.18.01.

Aby zaktualizować panel monitorowania wersji beta:

  1. Aktualizacja Edge do wersji 4.18.01 zgodnie z opisem w artykule Aktualizowanie Apigee Edge Od 4.17.01/4.17.05 do 4.17.09, zaktualizuj Apigee Edge w wersji 4.16.09 do 4.17.09 i zaktualizować Apigee Edge 4.16.01/4.16.05 do wersji 4.17.09.
  2. Zaktualizuj urządzenie apigee-influxdb 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 zainstalowano też aplikację apigee-grafana w Zarządzaniu węzła serwera, należy też wykonać ten krok (apigee-grafana). W przeciwnym razie zaktualizuj apigee-granfana zgodnie z poniższym krokiem.

  3. Jeśli nie zainstalowano aplikacji apigee-grafana 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 configfile
  4. Zaktualizuj urządzenie apigee-telegraf węzeł 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 parametru apigee-collectd zamiast apigee-telegraf W ramach aktualizacji do wersji 4.18.01 odinstalowujesz apigee-collectd i zainstaluj aplikację apigee-telegraf.

Aby zaktualizować panel monitorowania wersji beta:

  1. Zaktualizuj Edge do wersji 4.18.01 zgodnie z opisem na stronie Zaktualizuj Apigee Edge od 4.16.01/4.16.05 do 4.17.01 oraz Zaktualizuj Apigee Edge 4.16.09 do 4.17.01.
  2. Zaktualizuj urządzenie apigee-influxdb 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 zainstalowano też aplikację apigee-grafana w Zarządzaniu węzła serwera, należy też wykonać ten krok (apigee-grafana). W przeciwnym razie zaktualizuj apigee-granfana zgodnie z poniższym krokiem.

  3. Jeśli nie zainstalowano aplikacji apigee-grafana 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 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.