Edge for Private Cloud Version 4.17.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 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:
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 den Befehl apigee-grafana setup übergeben. Legen Sie sie beispielsweise in einer Textdatei namens 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 |
Von der Grafana-Datenquelle verwendeter InfluxDB-API-Port. Geben Sie 8086 an. |
GRAFANA_USERNAME |
Grafana-Benutzername für die Anmeldung in der Dashboard-Benutzeroberfläche. |
GRAFANA_PASSWORD |
Grafana-Passwort für die Anmeldung in 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 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:
- Installieren Sie apigee-influxdb:
> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb Installation installieren - Konfigurieren Sie die Datenbank apigee-influxdb:
> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb-Einrichtung - 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:
- Installieren Sie auf dem ersten Edge-Knoten apigee-telegraf:
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install - Erstellen Sie eine Konfigurationsdatei für apigee-telegraf. 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 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 - Ändern Sie den Inhaber in „apigee“:
> ändern Sie Apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt - Konfigurieren Sie apigee-telegraf:
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf-Einrichtung -f /opt/apigee/customer/application/sa_telegraf.txt - Starten Sie apigee-telegraf neu:
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf neustart - 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:
- Installieren Sie auf dem ersten Edge-Knoten apigee-grafana:
> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install - Erstellen Sie eine Konfigurationsdatei für apigee-grafana. 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 - Ändern Sie den Inhaber in „apigee“:
> chank apigee:apigee /opt/apigee/customer/application/sa_grafana.txt - 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 - 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:
- Damit apigee-telegraf die Daten erfasst,
- Führen Sie das apigee-service apigee-telegraf-Setup aus. Es ist idempotent, prüfen auf Fehler, fehlende Abhängigkeiten und beheben Sie diese.
- Starten Sie apigee-telegraf neu und prüfen Sie /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log auf Fehler.
- So sorgen Sie dafür, dass apigee-influxdb Daten empfängt:
- Achten Sie darauf, dass die folgenden TCP-Ports auf apigee-influxdb-Datenknoten geöffnet sind: 8086 und 8183.
- Verwenden Sie die folgende URL, um die influxdb-Benutzeroberfläche in einem Browser zu öffnen:
http://influxdb_IP_or_DNS:8183- 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. - Geben Sie im Feld „Abfrage“ „showserver“ (Server anzeigen) ein.
Achten Sie darauf, dass die Knoten apigee-influxdb aufgelistet sind.
- Geben Sie im Feld "Abfrage" den Text "Show Databases" (Datenbanken anzeigen) ein.
- Prüfen Sie die Datenquellen für das Dashboard:
- Wählen Sie im Hauptmenü Datenquellen aus. Es sollten Symbole für drei Datenquellen angezeigt werden.
- Wählen Sie für jede Datenquelle das Symbol aus.
- Klicken Sie auf der Detailseite der Datenquelle auf die Schaltfläche Speichern und testen.
- Wenn die Datenquelle richtig konfiguriert ist, sollte folgende Meldung angezeigt werden:
Erfolgreich
Datenquelle funktioniert
Beta-Monitoring-Dashboard aktualisieren
Wenn Sie die Betaversion des Apigee Monitoring-Dashboards in 4.16.09 installiert haben, können Sie sie auf die Betaversion für 4.17.01 aktualisieren.
Sie müssen die Dashboard-Komponenten in der folgenden Reihenfolge aktualisieren:
- apigee-influxdb
- apigee-telegraf auf jedem Knoten
- apigee-grafana
So aktualisieren Sie das Beta-Monitoring-Dashboard:
- Aktualisieren Sie Edge auf 4.17.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.
- Aktualisieren von apigee-influxdb aktualisieren:
> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb update
> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb Einrichtung
> /opt/apigee/apigee-service/bin/apigee-service, apigee-influxdb neu gestartet, aktualisiert - 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 /opt/apigee/customer/apigee/apigee/sa_telegraf.txt, apigee/apigee/sa_telegraf.txt, /apigee/apigee/apigee-service, neu starten, / apigee/apigee-service, neu starten
/ apigee/apigee-service, neu starten - Wiederholen Sie Schritt 3 für jeden Knoten.
- Aktualisieren von apigee-grafana:
> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana update
> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana-Setup -f /opt/apigee/customer/application/sa_apigeegrafana.txt
> /opt/apigee/apigee-service-neustart