Installation des Betamonitoring-Dashboards

Edge for Private Cloud Version 4.17.09

Systemanforderungen

Sie müssen apigee-telegraf auf allen Edge-Knoten installieren, um Dashboard-Daten zu erfassen. Daher sind die Systemanforderungen für apigee-telegraf identisch mit denen 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 Verwaltungsserver oder den Edge-UI-Knoten wiederverwenden.

Für apigee-influxdb können Sie es 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, sollte der Knoten die folgenden Anforderungen haben:

• 2-Kern-CPU
• 4 GB RAM
• 250 GB Speicherplatz (Monitoringdaten werden nach 1 Monat dauerhaft gelöscht)
• 1.000 oder mehr 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 offen sein, damit der Knoten, auf dem apigee-grafana und apigee-telegraf ausgeführt wird, zugreifen kann.

Konfigurationsdateien zum Installieren von Dashboard-Komponenten

Übergeben Sie eine Konfigurationsdatei an das Dienstprogramm apigee-service, um die Komponenten apigee-telegraf und apigee-grafana zu installieren. Speichern Sie diese Dateien in einem Verzeichnis, auf das der „apigee“-Benutzer zugreifen kann, z. B. /opt/apigee/customer/application, und machen Sie sie zum Eigentümer „apigee“-Benutzer.

Konfigurationsparameter für Apigee-Telegraf

Legen Sie diese Attribute in einer Textdatei fest, die Sie an den Befehl apigee-telegraf setup übergeben. Sie können sie beispielsweise in einer Textdatei namens sa_telegraf.txt festlegen:

http://192.168.0.1:8086

Konfigurationsparameter für Apigee-Grafana

Legen Sie diese Eigenschaften in einer Textdatei fest, die Sie an den Befehl apigee-grafana setup übergeben. Legen Sie sie beispielsweise in einer Textdatei namens 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)

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

Auf einem eigenständigen Knoten oder einem Edge-Knoten, auf dem der Management Server oder die Edge-UI ausgeführt wird:

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

Apigee-Telegraf auf jedem Edge-Knoten installieren

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

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 legen die Datei dem Nutzer "apigee" als Eigentümer fest.
   
   Legen Sie das folgende Attribut in der Datei fest, um die URL des Knotens „apigee-influxdb“ einschließlich Port 8086 anzugeben:
   INFLUXDB_URL=http://influx_IP:8086
3. Ändern Sie den Inhaber in „apigee“:
   > ändern Sie Apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt
4. Konfigurieren Sie apigee-telegraf:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf-Einrichtung -f /opt/apigee/customer/application/sa_telegraf.txt
5. Starten Sie apigee-telegraf neu:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf neustart
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 legen sie als Eigentümer des Apigee-Benutzers fest.
   
   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_PASSWORT=admin
3. Ändern Sie den Inhaber in „apigee“:
   > chank 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 neu gestartet

Ö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, führen Sie die folgenden Schritte aus, um Fehler bei der Installation zu beheben:

1. Damit apigee-telegraf die Daten erfasst,
   1. Führen Sie das apigee-service apigee-telegraf-Setup aus. Es ist idempotent, prüfen auf Fehler, fehlende Abhängigkeiten und beheben Sie diese.
   2. Starten Sie apigee-telegraf neu und prüfen Sie /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log auf Fehler.
2. So sorgen Sie dafür, dass apigee-influxdb Daten empfängt:
   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" den Text "Show Databases" (Datenbanken anzeigen) ein.
         Prüfen Sie, ob die folgenden Datenbanken erstellt wurden: system, application, events, _internal.
      2. Geben Sie im Feld „Abfrage“ „showserver“ (Server anzeigen) ein.
         Achten Sie darauf, dass die Knoten apigee-influxdb aufgelistet 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 Symbol aus.
   3. Klicken Sie auf der Detailseite der Datenquelle auf die Schaltfläche Speichern und testen.
   4. Wenn die Datenquelle richtig konfiguriert ist, sollte folgende Meldung angezeigt werden:
      Erfolgreich
      Datenquelle funktioniert

Beta-Monitoring-Dashboard aktualisieren

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

• Für 4.16.09, 4.17.01 und 4.17.05 wird das gleiche Verfahren angewendet.
• 4.16.05 erfordert, dass Sie apigee-collectd im Rahmen des Updates deinstallieren.

Aktualisierung von Version 4.16.09, 4.17.01 oder 4.17.05

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

So aktualisieren Sie das Beta-Monitoring-Dashboard:

1. Aktualisieren Sie Edge auf 4.17.09, wie unter Apigee Edge 4.17.01/4.17.05 auf 4.17.09 aktualisieren beschrieben, Apigee Edge 4.16.09 auf 4.17.09 aktualisieren und Apigee Edge 4.16.01/4.16.05 auf 4.17 aktualisieren.17
2. Aktualisieren Sie apigee-influxdb auf dem Management Server-Knoten:
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
   
   , wobei configFile die Konfigurationsdatei ist, die Sie zum Installieren von apigee-influx verwendet haben.
   
   Wenn Sie auch apigee-grafana auf dem Verwaltungsserver-Knoten installiert haben, wird mit diesem Schritt auch apigee-grafana aktualisiert. Aktualisieren Sie andernfalls apigee-granfana wie im folgenden Schritt gezeigt.
3. Wenn Sie apigee-grafana nicht auf dem Verwaltungsserver-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:
   apigee-telegraf
   configFile
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-collectd verwendet. Im Rahmen der Aktualisierung auf 4.17.09 deinstallieren Sie apigee-collectd und installieren apigee-telegraf.

So aktualisieren Sie das Beta-Monitoring-Dashboard:

1. Aktualisieren Sie Edge auf 4.17.09, wie unter Apigee Edge 4.17.01/4.17.05 auf 4.17.09 aktualisieren beschrieben, Apigee Edge 4.16.09 auf 4.17.09 aktualisieren und Apigee Edge 4.16.01/4.16.05 auf 4.17 aktualisieren.17
2. Aktualisieren Sie apigee-influxdb auf dem Management Server-Knoten:
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
   
   , wobei configFile die Konfigurationsdatei ist, die Sie zum Installieren von apigee-influx verwendet haben.
   
   Wenn Sie auch apigee-grafana auf dem Verwaltungsserver-Knoten installiert haben, wird mit diesem Schritt auch apigee-grafana aktualisiert. Aktualisieren Sie andernfalls apigee-granfana wie im folgenden Schritt gezeigt.
3. Wenn Sie apigee-grafana nicht auf dem Verwaltungsserver-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:
   apigee-telegraf
5. Wiederholen Sie Schritt 4 für jeden Knoten.