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:
Attribut |
Beschreibung |
---|---|
|
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 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:
Attribut |
Beschreibung |
---|---|
|
Geben Sie die IP-Adresse oder den DNS-Namen des InfluxDB-Knotens an. Beispiel: 192.168.0.1 |
|
Von der Grafana-Datenquelle verwendeter InfluxDB-API-Port. Geben Sie 8086 an. |
|
Grafana-Benutzername für die Anmeldung in der Dashboard-Benutzeroberfläche. |
|
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:
apigee-influxdb
installieren:> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install
- Konfigurieren Sie die Datenbank
apigee-influxdb
:> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup
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:
- Installieren Sie
apigee-telegraf
auf dem ersten Edge-Knoten:> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
- Erstellen Sie eine Konfigurationsdatei für
apigee-telegraf
mit dem Namensa_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
- Ändern Sie den Inhaber in „apigee“:
> chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt
apigee-telegraf
konfigurieren:> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f /opt/apigee/customer/application/sa_telegraf.txt
apigee-telegraf
neu starten:> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
- 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
apigee-grafana
auf dem ersten Edge-Knoten:> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install
- Erstellen Sie für
apigee-grafana
eine Konfigurationsdatei mit dem Namensa_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
- Ändern Sie den Inhaber in „apigee“:
> chown 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
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:
- So sorgen Sie dafür, dass
apigee-telegraf
die Daten erhebt:- 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. apigee-telegraf
neu starten und/opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log
auf Fehler prüfen
- Führen Sie das
- So sorgen Sie dafür, dass
apigee-influxdb
Daten empfängt:- Die folgenden TCP-Ports auf
apigee-influxdb
-Datenknoten müssen offen sein: 8086 und 8183. - Verwenden Sie die folgende URL, um die influxdb-UI in einem Browser zu öffnen:
http://influxdb_IP_or_DNS:8183
- 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
. - Geben Sie im Feld „Abfrage“ den Text „show server“ ein. Prüfen Sie, ob die
apigee-influxdb
-Knoten aufgeführt sind.
- Geben Sie im Feld "Abfrage" den Text "Show Databases" (Datenbanken anzeigen) ein. Achten Sie darauf, dass die folgenden Datenbanken erstellt wurden:
- Die folgenden TCP-Ports auf
- 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
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:
- 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.
- 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 auchapigee-grafana
aktualisiert. Andernfalls aktualisieren Sieapigee-granfana
wie im folgenden Schritt beschrieben. - Wenn Sie
apigee-grafana
nicht auf dem Verwaltungsserver-Knoten installiert haben, aktualisieren Sieapigee-grafana
auf dem Knoten, auf dem Sie es installiert haben:> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
- 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
- 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:
- 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.
- 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 auchapigee-grafana
aktualisiert. Andernfalls aktualisieren Sieapigee-granfana
wie im folgenden Schritt beschrieben. - Wenn Sie
apigee-grafana
nicht auf dem Verwaltungsserver-Knoten installiert haben, aktualisieren Sieapigee-grafana
auf dem Knoten, auf dem Sie es installiert haben:> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
- 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
- Wiederholen Sie Schritt 4 für jeden Knoten.