Monitoring-Dashboard-Installation (Beta)

Edge for Private Cloud v4.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 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 kann auf einem vorhandenen Edge-Knoten wie dem Management Server-Knoten oder dem Edge-UI-Knoten installiert werden, ohne dass sich die Systemanforderungen ä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 „apigee“-Nutzer zugreifen kann, z. B. /opt/apigee/customer/application, und machen Sie sie zum Eigentum des „apigee“-Nutzers.

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 mit dem Namen sa_telegraf.txt fest:

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

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-Nutzername für die Anmeldung in der Dashboard-UI.

GRAFANA_PASSWORD

Grafana-Passwort für die Anmeldung bei 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)

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 Properties 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. Damit apigee-telegraf die Daten erfasst
    1. Führen Sie apigee-service apigee-telegraf setup aus. Es ist idempotent. Prüfen Sie auf Fehler und fehlende 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 „Query“ (Abfrage) „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.0x verwenden dasselbe Verfahren
  • Für 4.16.05 ist es erforderlich, dass Sie 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 es 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.09 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 für die 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.18.01 deinstallieren Sie apigee-collectd und installieren 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 Management Server-Knoten: 
    > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile

    Dabei ist configFile die Konfigurationsdatei, die Sie für die 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.