Installation des Betamonitoring-Dashboards

Edge for Private Cloud v. 4.17.05

Systemanforderungen

Sie müssen apigee-telegraf auf allen Edge-Knoten installieren, um Dashboard-Daten zu erfassen. Daher sind die Systemanforderungen für apigee-telegraf dieselben wie für den Edge-Knoten, auf dem Sie es installieren.

Sie können apigee-grafana auf einem separaten Knoten installieren oder einen der vorhandenen Edge-Knoten wie den Management Server- oder Edge-UI-Knoten wiederverwenden.

apigee-influxdb können Sie auf einem vorhandenen Edge-Knoten wie dem Management Server-Knoten oder dem Edge-UI-Knoten installieren, ohne die Systemanforderungen zu ändern.

Wenn Sie apigee-influxdb aus Leistungsgründen auf einem eigenen Knoten installieren möchten, sollte der Knoten die folgenden Anforderungen erfüllen:

• CPU mit 2 Kernen
• 4 GB RAM
• 250 GB Speicherplatz (Monitoring-Daten werden nach einem Monat gelöscht)
• Mindestens 1.000 IOPS

Weitere Informationen finden Sie in der InfluxData-Dokumentation.

Portanforderungen für apigee-influxdb

Die Ports 8086 und 8183 müssen auf den apigee-influxdb-Datenknoten für den Zugriff durch den Knoten geöffnet sein, auf dem apigee-grafana und apigee-telegraf ausgeführt werden.

Konfigurationsdateien für die Installation von Dashboard-Komponenten

Wenn Sie die Komponenten apigee-telegraf und apigee-grafana installieren möchten, übergeben Sie eine Konfigurationsdatei an das Dienstprogramm apigee-service. Speichern Sie diese Dateien in einem Verzeichnis, auf das der Nutzer „apigee“ zugreifen kann, z. B. /opt/apigee/customer/application, und machen Sie sie zum Eigentum des Nutzers „apigee“.

Konfigurationsparameter für apigee-telegraf

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

http://192.168.0.1:8086

Konfigurationsparameter für apigee-grafana

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

192.168.0.1

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)

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

Auf einem eigenständigen Knoten oder einem Edge-Knoten, auf dem der Management Server 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

apigee-telegraf auf jedem Edge-Knoten installieren

Auf jedem Knoten Ihrer Edge-Installation:

1. Installieren Sie auf dem ersten Edge-Knoten apigee-telegraf:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
2. Erstellen Sie eine Konfigurationsdatei für apigee-telegraf mit dem Namen sa_telegraf.txt. In der Regel speichern Sie diese Datei in einem Verzeichnis, auf das der Nutzer „apigee“ zugreifen kann, z. B. /opt/apigee/customer/application, und machen sie zum Eigentum des Nutzers „apigee“.
   
   Legen Sie das folgende Attribut 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 Inhaber 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.

apigee-grafana auf einem einzelnen Edge-Knoten installieren

Auf einem einzelnen Knoten Ihrer Edge-Installation, z. B. dem Edge-UI-Knoten:

1. Installieren Sie auf dem ersten Edge-Knoten apigee-grafana:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install
2. Erstellen Sie eine Konfigurationsdatei für apigee-grafana mit dem Namen sa_grafana.txt. In der Regel speichern Sie diese Datei in einem Verzeichnis, auf das der Nutzer „apigee“ zugreifen kann, z. B. /opt/apigee/customer/application, und machen sie zum Eigentum des Nutzers „apigee“.
   
   Legen Sie die folgenden Attribute in der Datei fest. Diese Attribute werden oben beschrieben:
   INFLUXDB_HOST=192.168.56.101
   INFLUXDB_PORT=8086
   GRAFANA_USERNAME=admin
   GRAFANA_PASSWORD=admin
3. Ändern Sie den Inhaber in „apigee“:
   > chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt
4. Konfigurieren Sie apigee-grafana 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

Öffnen Sie die folgende URL in einem Browser, um auf das Dashboard zuzugreifen:

http://grafana_IP_or_DNS:3000

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

Fehlerbehebung bei der Installation

Wenn im Dashboard keine Daten angezeigt werden, gehen Sie so vor, um die Installation zu beheben:

1. So prüfen Sie, ob apigee-telegraf die Daten erfasst:
   1. Führen Sie apigee-service apigee-telegraf setup aus. Es ist idempotent. Suchen Sie nach Fehlern und fehlenden Abhängigkeiten und beheben Sie sie.
   2. Starten Sie apigee-telegraf neu und prüfen Sie /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log auf Fehler.
2. So prüfen Sie, ob apigee-influxdb Daten empfängt:
   1. Die folgenden TCP-Ports müssen auf apigee-influxdb-Datenknoten geöffnet sein: 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“ den Wert „show databases“ ein.
         Prüfen Sie, ob die folgenden Datenbanken erstellt wurden: system, application, events, _internal.
      2. Geben Sie im Feld „Abfrage“ den Befehl „show servers“ ein.
         Prüfen Sie, ob die apigee-influxdb-Knoten aufgeführt sind.
3. Prüfen Sie die Datenquellen für das Dashboard:
   1. Wählen Sie im Hauptmenü Datenquellen aus. Es sollten Symbole für drei Datenquellen angezeigt werden.
   2. Wählen Sie für jede Datenquelle das entsprechende Symbol aus.
   3. Wählen Sie auf der Detailseite für die Datenquelle die Schaltfläche Speichern und testen aus.
   4. Wenn die Datenquelle richtig konfiguriert ist, sollte eine Meldung in folgendem 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.01 verwenden dasselbe Verfahren
• Für 4.16.05 müssen Sie apigee-collectd im Rahmen des Updates deinstallieren.

Update von Version 4.16.09 oder 4.17.01

Wenn Sie die Betaversion des Apigee Monitoring-Dashboards in 4.16.09 oder 4.17.01 installiert haben, können Sie sie auf die Betaversion für 4.17.05 aktualisieren.

So aktualisieren Sie das Beta-Monitoring-Dashboard:

1. Aktualisieren Sie Edge auf 4.17.05, wie unter Apigee Edge 4.17.01 auf 4.17.05 aktualisieren, Apigee Edge 4.16.09 auf 4.17.05 aktualisieren und Apigee Edge 4.16.01/4.16.05 auf 4.17.05 aktualisieren beschrieben.
2. Aktualisieren Sie apigee-influxdb auf dem Management Server-Knoten:
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
   
   Dabei ist configFile die Konfigurationsdatei, die Sie zur Installation von apigee-influx verwendet haben.
   
   Wenn Sie apigee-grafana auch auf dem Management Server-Knoten installiert haben, wird apigee-grafana in diesem Schritt ebenfalls aktualisiert. Andernfalls aktualisieren Sie apigee-granfana wie im folgenden Schritt gezeigt.
3. Wenn Sie apigee-grafana nicht auf dem Management Server-Knoten installiert haben, aktualisieren Sie apigee-grafana auf dem Knoten, auf dem Sie es installiert haben:
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
4. Aktualisieren Sie apigee-telegraf auf 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 Dashboard-Version 4.16.05 wurde apigee-collectd anstelle von apigee-telegraf verwendet. Im Rahmen des Updates auf 4.17.05 deinstallieren Sie apigee-collectd und installieren apigee-telegraf.

So aktualisieren Sie das Beta-Monitoring-Dashboard:

1. Aktualisieren Sie Edge auf 4.17.05, wie unter Apigee Edge 4.17.01 auf 4.17.05 aktualisieren, Apigee Edge 4.16.09 auf 4.17.05 aktualisieren und Apigee Edge 4.16.01/4.16.05 auf 4.17.05 aktualisieren beschrieben.
2. Aktualisieren Sie apigee-influxdb auf dem Management Server-Knoten:
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
   
   Dabei ist configFile die Konfigurationsdatei, die Sie zur Installation von apigee-influx verwendet haben.
   
   Wenn Sie apigee-grafana auch auf dem Management Server-Knoten installiert haben, wird apigee-grafana in diesem Schritt ebenfalls aktualisiert. Andernfalls aktualisieren Sie apigee-granfana wie im folgenden Schritt gezeigt.
3. Wenn Sie apigee-grafana nicht auf dem Management Server-Knoten installiert haben, aktualisieren Sie apigee-grafana auf dem Knoten, auf dem Sie es installiert haben:
   > /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.