Instalacja panelu monitorowania wersji beta

Edge for Private Cloud wer. 4.17.01

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:

  1. Zainstaluj apigee-influxdb:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb find
  2. Skonfiguruj bazę danych apigee-influxdb:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup
  3. 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:

  1. W pierwszym węźle brzegowym zainstaluj apigee-telegraf:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf instalacja
  2. Utwórz plik konfiguracyjny apigee-telegraf. Zwykle przechowujesz ten plik w katalogu dostępnym dla użytkownika „apigee”, np. /opt/apigee/customer/application, i ustawiasz go jako właściciela 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
  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 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:

  1. W pierwszym węźle brzegowym zainstaluj apigee-grafana:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana instalacja
  2. Utwórz plik konfiguracyjny apigee-grafana. Zwykle zapisuje się ten plik w katalogu dostępnym dla użytkownika „apigee”, takim jak /opt/apigee/customer/application, i czyni go 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
  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 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ą:

  1. Aby mieć pewność, że usługa apigee-telegraf gromadzi dane
    1. 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.
    2. Uruchom ponownie apigee-telegraf i sprawdź, czy na stronie /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log nie ma błędów.
  2. Aby upewnić się, że usługa apigee-influxdb otrzymuje dane:
    1. Upewnij się, że 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 utworzono te bazy danych: system, application, events, _internal.
      2. W polu Zapytanie wpisz „pokaż serwery”.
        Sprawdź, czy na liście znajdują się węzły apigee-influxdb.
  3. Sprawdź źródła danych w panelu:
    1. W menu głównym wybierz Źródła danych. Powinny być widoczne ikony 3 źródeł danych.
    2. Wybierz ikonę 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 tym formacie:
      Sukces
      Źródło danych działa

Aktualizuję panel monitorowania wersji beta

Jeśli masz zainstalowaną wersję beta panelu monitorowania Apigee w wersji 4.16.09, możesz zaktualizować ją do wersji beta 4.17.01.

Komponenty panelu musisz aktualizować w tej kolejności:

  • apigee-influxdb
  • apigee-telegraf w każdym węźle
  • apigee-grafana

Aby zaktualizować panel monitorowania beta:

  1. Zaktualizuj Edge do wersji 4.17.01 zgodnie z opisem w sekcjach Aktualizacja Apigee Edge z wersji 4.16.01/4.16.05 do 4.17.01 i Aktualizacja Apigee Edge do wersji 4.16.09 do wersji 4.17.01.
  2. Zaktualizuj apigee-influxdb:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb aktualizacja
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb konfiguracja
    > /opt/apigee/apige
  3. 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 -fage/opt/apigee/customer/application>

  4. Powtórz krok 3 dla każdego węzła.
  5. Zaktualizuj apigee-grafana:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana update