Monitoring-Dashboard-Installation (Beta)

Edge for Private Cloud Version 4.18.01

Systemanforderungen

Sie müssen apigee-telegraf auf allen Edge-Knoten installieren, um Dashboard-Daten zu erfassen. Daher sind die Systemanforderungen für apigee-telegraf die gleichen wie für den Edge-Knoten, auf dem Sie die Anwendung 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 möchten, sollte der Knoten die folgenden Anforderungen erfüllen:

• 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 im InfluxData-Dokument.

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 offen sein.

Konfigurationsdateien zum Installieren von Dashboard-Komponenten

Zum Installieren der Komponenten apigee-telegraf und apigee-grafana ü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 Eigentümer „apigee“.

Konfigurationsparameter für Apigee-Telegraf

Legen Sie diese Attribute in einer Textdatei fest, die Sie an den Befehl apigee-telegraf setup übergeben. Legen Sie sie beispielsweise in einer Textdatei namens 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 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. apigee-influxdb installieren:

   > /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. apigee-influxdb starten:

   > /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 apigee-telegraf auf dem ersten Edge-Knoten:

   > /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 Eigentümer „apigee“.

   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“:

   > chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt

4. apigee-telegraf konfigurieren:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f
       /opt/apigee/customer/application/sa_telegraf.txt

5. apigee-telegraf neu starten:

   > /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 apigee-grafana auf dem 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-Benutzer zugreifen kann, z. B. /opt/apigee/customer/application, und machen sie zum Eigentümer „apigee“.

   Legen Sie die folgenden Eigenschaften in der Datei 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 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. apigee-grafana neu starten:

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

1. So sorgen Sie dafür, dass apigee-telegraf die Daten erhebt:
   1. Führen Sie das apigee-service apigee-telegraf setup aus. Es ist idempotent, prüfen auf Fehler und fehlende Abhängigkeiten und beheben Sie diese.
   2. apigee-telegraf neu starten und /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log auf Fehler prüfen
2. So sorgen Sie dafür, dass apigee-influxdb Daten empfängt:
   1. Die folgenden TCP-Ports auf apigee-influxdb-Datenknoten müssen offen sein: 8086 und 8183.
   2. Verwenden Sie die folgende URL, um die influxdb-UI in einem Browser zu öffnen:

      http://influxdb_IP_or_DNS:8183

      1. Geben Sie im Feld "Abfrage" den Text "Show Databases" (Datenbanken anzeigen) ein. Achten Sie darauf, dass die folgenden Datenbanken erstellt wurden: system, application, events, _internal.
      2. Geben Sie im Feld „Abfrage“ den Text „show server“ 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 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:

• 4.16.09 und 4.17.0x verwenden dasselbe Verfahren.
• Gemäß 4.16.05 musst du apigee-collectd im Rahmen des Updates deinstallieren.

Update von Version 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, können Sie sie auf die Betaversion für 4.18.01 aktualisieren.

So aktualisieren Sie das Beta-Monitoring-Dashboard:

1. Aktualisieren Sie Edge auf 4.18.01, wie unter Apigee Edge 4.17.01/4.17.05 auf 4.17.09 aktualisieren, Apigee Edge 4.16.09 auf 4.17.09 aktualisieren und Apigee Edge 4.16.01/4.16.05 auf 4.17 aktualisieren beschrieben.
2. Aktualisieren Sie apigee-influxdb auf dem Verwaltungsserver-Knoten:

   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile

   Dabei ist configFile die Konfigurationsdatei, mit der Sie apigee-influx installiert haben.

   Wenn Sie auch apigee-grafana auf dem Verwaltungsserverknoten installiert haben, wird mit diesem Schritt auch apigee-grafana aktualisiert. Andernfalls aktualisieren Sie apigee-granfana wie im folgenden Schritt beschrieben.

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:

   > /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 verwendet. Im Rahmen der Aktualisierung auf 4.18.01 deinstallierst du apigee-collectd und installierst apigee-telegraf.

So aktualisieren Sie das Beta-Monitoring-Dashboard:

1. Aktualisieren Sie Edge auf 4.18.01, wie unter Apigee Edge 4.16.01/4.16.05 auf 4.17.01 aktualisieren und Apigee Edge 4.16.09 auf 4.17.01 aktualisieren beschrieben.
2. Aktualisieren Sie apigee-influxdb auf dem Verwaltungsserver-Knoten:

   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile

   Dabei ist configFile die Konfigurationsdatei, mit der Sie apigee-influx installiert haben.

   Wenn Sie auch apigee-grafana auf dem Verwaltungsserverknoten installiert haben, wird mit diesem Schritt auch apigee-grafana aktualisiert. Andernfalls aktualisieren Sie apigee-granfana wie im folgenden Schritt beschrieben.

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:

   > /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.