Monitoring-Dashboard-Installation (Beta)

Edge for Private Cloud v4.18.01

Systemanforderungen

Sie müssen apigee-telegraf auf allen Edge-Knoten installieren, um um Dashboard-Daten zu sammeln. Daher lauten die Systemanforderungen für apigee-telegraf: Entspricht dem für den Edge- Knoten, auf dem Sie es installieren.

Du kannst apigee-grafana installieren auf einem separaten Knoten oder verwenden Sie einen der vorhandenen Edge-Knoten wie den Verwaltungsserver oder Edge UI-Knoten.

Für apigee-influxdb kannst du Installieren Sie es auf einem vorhandenen Edge-Knoten wie dem Verwaltungsserverknoten oder dem Edge-Benutzeroberflächenknoten mit keine Änderungen an den Systemanforderungen.

Wenn Sie apigee-influxdb auf einem eigenen Knoten sollte der Knoten folgende Anforderungen erfüllen:

  • 2-Kern-CPU
  • 4 GB RAM
  • 250 GB Speicherplatz (Überwachungsdaten werden nach 1 Monat dauerhaft gelöscht)
  • 1.000 oder mehr IOPS

Weitere Informationen finden Sie in der Dokument zu InfluxData .

Portanforderungen für Apigee-influxdb

Die Ports 8086 und 8183 müssen auf den apigee-influxdb-Datenknoten für den Zugriff durch den Knoten mit apigee-grafana und apigee-telegraf

Konfigurationsdateien zum Installieren des Dashboards Komponenten

apigee-telegraf installieren und apigee-grafana-Komponenten übergeben Sie eine Konfigurationsdatei an das Dienstprogramm apigee-service. Diese Dateien speichern in ein Verzeichnis, auf das der 'Apigee' zugreifen kann Nutzer, z. B. /opt/apigee/customer/application, und machen sie im Besitz von „Apigee“. Nutzer.

Konfigurationsparameter für Apigee-Telegraf

Legen Sie diese Eigenschaften in einer Textdatei fest, die Sie an die apigee-telegraf setup übergeben. . Legen Sie sie beispielsweise in einer Textdatei mit dem Namen sa_telegraf.txt fest:

Attribut

Beschreibung

INFLUXDB_URL

Geben Sie die URL des Apigee-influxdb-Knotens an, einschließlich Port 8086. Beispiel:

http://192.168.0.1:8086

Konfigurationsparameter für Apigee-grafana

Legen Sie diese Eigenschaften in einer Textdatei fest, die Sie an die apigee-grafana setup übergeben. . Legen Sie sie beispielsweise in einer Textdatei mit dem Namen sa_grafana.txt fest:

Attribut

Beschreibung

INFLUXDB_HOST

Geben Sie die IP-Adresse oder den DNS-Namen des InfluxDB-Knotens an. Beispiel:

192.168.0.1

INFLUXDB_PORT

InfluxDB API-Port, der von der Grafana-Datenquelle verwendet wird. Geben Sie 8086 an.

GRAFANA_USERNAME

Grafana-Nutzername für die Anmeldung bei der Dashboard-Benutzeroberfläche.

GRAFANA_PASSWORD

Grafana-Passwort für die Anmeldung bei der Dashboard-Benutzeroberfläche.

Installationsanleitung

Folgen Sie der Anleitung unten, um die Dashboard-Komponenten in dieser Reihenfolge zu installieren:

  • apigee-influxdb (auf einem zentralen Knoten)
  • apigee-telegraf (auf jedem Knoten)
  • apigee-grafana (auf einem zentralen Server)

Installieren apigee-influxdb auf einem einzelnen Edge-Knoten oder eigenständigen Knoten

Auf einem eigenständigen Knoten oder einem Edge-Knoten, auf dem der Verwaltungsserver oder die Edge-Benutzeroberfläche ausgeführt wird:

  1. Installieren Sie apigee-influxdb: 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install
  2. Konfigurieren Sie die Datenbank apigee-influxdb: 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup
  3. Starten Sie apigee-influxdb: 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb start

Installieren Sie Apigee-Telegraf auf jeder Edge-Knoten

Führen Sie auf jedem Knoten der Edge-Installation folgende Schritte aus:

  1. Installieren Sie apigee-telegraf auf Ihrem ersten Edge-Knoten: 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
  2. Konfigurationsdatei mit dem Namen apigee-telegraf erstellen sa_telegraf.txt. In der Regel speichern Sie diese Datei in einem Verzeichnis, auf das der Apigee Nutzer, z. B. /opt/apigee/customer/application, und machen es in den Besitz von „Apigee“. Nutzer.

    Legen Sie die folgende Eigenschaft in der Datei fest, um die URL des Apigee-influxdb-Knotens anzugeben: einschließlich Port 8086: 

    INFLUXDB_URL=http://influx_IP:8086
  3. Ändern Sie den Eigentümer in „apigee“: 
    > chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt
  4. Konfigurieren Sie apigee-telegraf: 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f
    /opt/apigee/customer/application/sa_telegraf.txt
  5. Starten Sie apigee-telegraf neu: 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
  6. Wiederholen Sie diesen Vorgang auf allen Edge-Knoten.

Installieren Sie apigee-grafana auf einem einzelnen Edge-Knoten

Führen Sie auf einem einzelnen Knoten Ihrer Edge-Installation wie dem Edge-Benutzeroberflächenknoten die folgenden Schritte aus:

  1. Installieren Sie apigee-grafana auf Ihrem ersten Edge-Knoten: 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install
  2. Erstellen Sie für apigee-grafana eine Konfigurationsdatei mit dem Namen sa_grafana.txt. In der Regel speichern Sie diese Datei in einem Verzeichnis, auf das der Apigee-Dienst zugreifen kann. Nutzende, wie z. B. /opt/apigee/customer/application und machen es zu dem Apigee. Nutzer.

    Legen Sie in der Datei die folgenden Eigenschaften fest. Diese Eigenschaften werden oben beschrieben:

    INFLUXDB_HOST=192.168.56.101
INFLUXDB_PORT=8086
GRAFANA_USERNAME=admin
GRAFANA_PASSWORD=admin
  3. Ändern Sie den Eigentümer in „apigee“: 
    > chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt
  4. apigee-grafana konfigurieren mithilfe der Konfigurationsdatei: 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f
    /opt/apigee/customer/application/sa_grafana.txt
  5. Starten Sie apigee-grafana neu: 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana restart

Um auf das Dashboard zuzugreifen, öffnen Sie die folgende URL in einem Browser:

http://grafana_IP_or_DNS:3000

Melden Sie sich mit den Anmeldedaten an, die Sie in der Konfigurationsdatei für apigee-grafana Im obigen Beispiel Der Nutzername/das Passwort lautet „admin/admin“.

Fehlerbehebung bei der Installation

Wenn im Dashboard keine Daten angezeigt werden, führen Sie das folgende Verfahren zur Fehlerbehebung aus Ihre Installation:

  1. Damit apigee-telegraf die Daten zu sammeln, <ph type="x-smartling-placeholder">
      </ph>
    1. Führen Sie den apigee-service apigee-telegraf setup aus. Er ist idempotent, prüfen Sie sowie fehlende Abhängigkeiten, um Fehler zu beheben.
    2. apigee-telegraf neu starten und prüfen /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log für Fehler
  2. So sorgen Sie dafür, dass apigee-influxdb Daten empfängt: <ph type="x-smartling-placeholder">
      </ph>
    1. Achten Sie darauf, dass die folgenden TCP-Ports auf apigee-influxdb-Datenknoten geöffnet sind: 8086 und 8183.
    2. Verwenden Sie die folgende URL, um die influxdb-Benutzeroberfläche in einem Browser zu öffnen: 
      http://influxdb_IP_or_DNS:8183
      1. Geben Sie im Feld Abfrage „Datenbank anzeigen“ ein. Achten Sie darauf, dass die folgenden Datenbanken wurden erstellt: system, application, events, _internal.
      2. Geben Sie im Feld „Abfrage“ „Server anzeigen“ ein. Stellen Sie sicher, dass Sie den apigee-influxdb Knoten sind aufgelistet.
  3. Prüfen Sie die Datenquellen für das Dashboard: <ph type="x-smartling-placeholder">
      </ph>
    1. Wählen Sie im Hauptmenü die Option Datenquellen aus. Sie sollten Symbole für drei Datenquellen angezeigt werden.
    2. Wählen Sie für jede Datenquelle das Symbol aus.
    3. Wählen Sie auf der Detailseite der Datenquelle die Option Speichern und Testen Schaltfläche.
    4. Wenn die Datenquelle richtig konfiguriert ist, sollte eine Meldung im Format
      angezeigt werden. Erfolgreich
      Datenquelle funktioniert

Beta-Monitoring-Dashboard aktualisieren

Verwenden Sie je nach Edge-Version, von der Sie ein Upgrade ausführen, eines der beiden folgenden Verfahren:

  • 4.16.09 und 4.17.0x verwenden dasselbe Verfahren
  • 4.16.05 erfordert im Rahmen des Updates eine Deinstallation von apigee-collectd.

Von Version aktualisieren 4.16.09 oder 4.17.0x

Wenn Sie die Betaversion des Apigee Monitoring-Dashboards in 4.16.09 oder 4.17.0x installiert haben, es auf die Betaversion für 4.18.01 aktualisieren kann.

So aktualisieren Sie das Beta-Monitoring-Dashboard:

  1. Aktualisieren Sie Edge auf 4.18.01, wie unter Aktualisieren von Apigee Edge beschrieben. 4.17.01/4.17.05 bis 4.17.09, Aktualisieren von Apigee Edge 4.16.09 auf 4.17.09 und Aktualisieren Sie Apigee Edge 4.16.01/4.16.05 auf 4.17.09.
  2. apigee-influxdb aktualisieren am dem Verwaltungsserverknoten: 
    > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile

    Dabei ist configFile die Konfigurationsdatei, die Sie zum Installieren apigee-influx.

    Wenn Sie auch apigee-grafana unter „Verwaltung“ installiert haben Serverknotens aktualisiert wird, wird mit diesem Schritt auch apigee-grafana aktualisiert. Andernfalls aktualisieren Sie apigee-granfana, wie im folgenden Schritt gezeigt.

  3. Wenn Sie apigee-grafana nicht auf dem Knoten des Verwaltungsservers: Aktualisieren Sie apigee-grafana auf dem Knoten, auf dem Sie es installiert: 
    > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
  4. apigee-telegraf aktualisieren am Knoten 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. Wiederholen Sie Schritt 4 für jeden Knoten.

Update von Version 4.16.05

In der Version 4.16.05 des Dashboards wurde apigee-collectd anstelle von apigee-telegraf. Im Rahmen des Updates auf 4.18.01 deinstallieren Sie apigee-collectd und installiere apigee-telegraf.

So aktualisieren Sie das Beta-Monitoring-Dashboard:

  1. Aktualisieren Sie Edge auf 4.18.01, wie unter beschrieben. Apigee Edge aktualisieren 4.16.01/4.16.05 bis 4.17.01 und Apigee Edge 4.16.09 aktualisieren auf 4.17.01.
  2. apigee-influxdb aktualisieren am dem Verwaltungsserverknoten: 
    > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile

    Dabei ist configFile die Konfigurationsdatei, die Sie zum Installieren apigee-influx.

    Wenn Sie auch apigee-grafana unter „Verwaltung“ installiert haben Serverknotens aktualisiert wird, wird mit diesem Schritt auch apigee-grafana aktualisiert. Andernfalls aktualisieren Sie apigee-granfana, wie im folgenden Schritt gezeigt.

  3. Wenn Sie apigee-grafana nicht auf dem Knoten des Verwaltungsservers: Aktualisieren Sie apigee-grafana auf dem Knoten, auf dem Sie es installiert: 
    > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
  4. Installieren Sie apigee-telegraf auf Knoten 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. Wiederholen Sie Schritt 4 für jeden Knoten.