Diese Seite wurde von der Cloud Translation API übersetzt.

Überwachung

Edge for Private Cloud Version 4.18.01

In diesem Dokument werden die Monitoringtechniken von Komponenten beschrieben, die von einer lokalen Bereitstellung von Apigee Edge unterstützt werden.

JMX aktivieren

JMX ist standardmäßig für Cassandra aktiviert und für alle anderen Edge-Komponenten standardmäßig deaktiviert. Sie müssen daher JMX für jede Komponente einzeln aktivieren.

Jede Komponente unterstützt JMX an einem anderen Port. In der folgenden Tabelle sind der JMX-Port und die Datei aufgeführt, die Sie ändern, um JMX für diesen Port zu aktivieren:

Komponente	JMX-Port	Datei
Verwaltungsserver	1099	/opt/apigee/edge-management-server/bin/start
Router	1100	/opt/apigee/edge-router/bin/start
Message Processor	1101	/opt/apigee/edge-message-processor/bin/start
QPID	1102	/opt/apigee/edge-qpid-server/bin/start
Postgres	1103	/opt/apigee/edge-postgres-server/bin/start

Öffnen Sie beispielsweise /opt/apigee/edge-management-server/bin/start in einem Editor, um JMX auf dem Verwaltungsserver zu aktivieren. Sie sollten die folgende Zeile sehen, die zum Starten des Verwaltungsservers verwendet wird:

exec $JAVA -classpath "$classpath" -Xms$min_mem -Xmx$max_mem $xx_opts -Djava.security.auth.login.config=$conf_path/jaas.config 
-Dinstallation.dir=$install_dir $sys_props -Dconf.dir=$conf_path 
-Ddata.dir=$data_dir $* $debug_options com.apigee.kernel.MicroKernel

Fügen Sie dieser Zeile Folgendes hinzu:

-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=1099 
-Dcom.sun.management.jmxremote.local.only=false  
-Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false

Beachten Sie, dass in dieser Zeile die JMX-Portnummer für den Management Server als 1099 angegeben wird. Legen Sie die Portnummer für jede Komponente wie in der Tabelle oben definiert fest. Beispiel:

exec $JAVA -classpath "$classpath" -Xms$min_mem -Xmx$max_mem $xx_opts 
-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=1099 
-Dcom.sun.management.jmxremote.local.only=false  
-Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false 
-Djava.security.auth.login.config=$conf_path/jaas.config 
-Dinstallation.dir=$install_dir $sys_props -Dconf.dir=$conf_path -Ddata.dir=$data_dir $* $debug_options com.apigee.kernel.MicroKernel

Speichern Sie die Datei und starten Sie die Komponente dann neu. So starten Sie beispielsweise den Verwaltungsserver neu:

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

JMX-Authentifizierung aktivieren und JMX-Passwort festlegen

Der Monitoringprozess für Management Server, Message Processor, Qpid und Postgres verwenden alle JMX. JMX ist standardmäßig aktiviert und für den Remote-JMX-Zugriff ist kein Passwort erforderlich.

Zum Aktivieren der JMX-Authentifizierung verfügt jede Komponente über die Aktion change_jmx_auth, mit der Sie die Authentifizierung aktivieren/deaktivieren und die JMX-Anmeldedaten festlegen.

Verwenden Sie den folgenden Befehl, um die JMX-Authentifizierung zu aktivieren:

>  /opt/apigee/apigee-service/bin/apigee-service comp change_jmx_auth optionsOrConfigFile

Dabei gilt:

comp ist entweder Edge-Management-Server, Edge-Nachrichtenprozessor, Edge-Qpid-server oder Edge-Postgres-Server.
Folgende Optionen sind verfügbar:
- -u: Nutzername
- -p: Passwort
- -e: y (aktivieren) oder n (auswählbar)
Die Konfigurationsdatei enthält:
- JMX_USERNAME=Nutzername
- JMX_AKTIVIERT=y/n
- JMX_PASSWORT=Passwort (wenn das Passwort nicht festgelegt oder nicht mit -p übergeben wird, erhalten Sie eine Eingabeaufforderung)

So verwenden Sie Optionen in der Befehlszeile:

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server change_jmx_auth -u foo -p bar -e y

Wenn Sie eine Konfigurationsdatei haben:

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server change_jmx_auth -f configFile

Wenn Sie Edge auf mehreren Knoten ausführen, führen Sie diesen Befehl auf allen Knoten aus und geben Sie dabei denselben Nutzernamen und dasselbe Passwort an.

Verwenden Sie den folgenden Befehl, um später die JMX-Authentifizierung zu deaktivieren:

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server change_jmx_auth -e n

Verwaltungsserver

Mit JConsole die Systemdiagnose des Systems überwachen und Informationen verarbeiten

Verwenden Sie die JConsole (ein JMX-kompatibles Tool), um Systemdiagnose- und Verarbeitungsstatistiken zu verwalten und zu überwachen. Mit der JConsole können Sie vom Management Server (oder einem anderen Server) bereitgestellte JMX-Statistiken abrufen und in einer grafischen Benutzeroberfläche darstellen. Weitere Informationen zur Verwendung der JConsole finden Sie unter http://docs.oracle.com/javase/8/docs/technotes/guides/management/jconsole.html.

Verwenden Sie JConsole und die folgende Dienst-URL, um die über JMX angebotenen JMX-Attribute (MBeans) zu überwachen.

service:jmx:rmi:///jndi/rmi://<ip address>:<port>/jmxrmi

Dabei ist <ip address> die IP-Adresse des Managementservers (oder des jeweiligen Servers). Standardmäßig ist der Port 1099 für den Verwaltungsserver festgelegt.

Die folgende Tabelle zeigt die allgemeinen JMX-Statistiken:

JMX-MBeans	JMX-Attribute
Arbeitsspeicher	HeapMemoryUsage
	NonHeapMemoryUsage
	Nutzung
Hinweis: Attributwerte werden in vier Werten angezeigt: Commit, init, max und used.

Edge Application API-Prüfungen verwenden

Sie können eine API-Prüfung auf dem Management Server (oder einem beliebigen Server) durchführen, indem Sie den folgenden CURL-Befehl aufrufen:

curl http://<host>:8080/v1/servers/self/up -H "Accept: application/json"

Dabei ist <host> die IP-Adresse des Verwaltungsservers. Sie können den Accept-Typ application/json oder application/xml festlegen.

Dieser Aufruf gibt „true“ und „false“ zurück. Wenn „true“ festgelegt ist, ist der Knoten aktiv und der Java-Dienst wird ausgeführt.

Wenn Sie keine HTTP 200-Antwort (OK) erhalten, kann der Edge nicht auf Port 8080-Anfragen antworten.

Fehlerbehebung

Melden Sie sich beim Server an und führen Sie den folgenden Befehl aus:
/opt/apigee/apigee-service/bin/apigee-service-edge-management-server status
Wenn der Dienst nicht ausgeführt wird, starten Sie den Dienst:
/opt/apigee/apigee-service/bin/apigee-service-Edge-management-server start

Edge-Anwendung verwenden – Nutzer-, Organisations- und Bereitstellungsprüfungen

Der Managementserver spielt eine entscheidende Rolle dabei, alle anderen Parzellen in jeder lokalen Installation zusammenzuhalten. Sie können den Nutzer-, Organisations- und Bereitstellungsstatus auf dem Verwaltungsserver mit den folgenden Befehlen prüfen:

curl -u userEmail:password http://localhost:8080/v1/users
curl -u userEmail:password http://localhost:8080/v1/organizations
curl -u userEmail:password http://localhost:8080/v1/organizations/orgname/deployments

Das System sollte für alle Aufrufe den Status „Bereitgestellt“ anzeigen. Wenn diese nicht funktionieren, gehen Sie so vor:

Prüfen Sie die Management Server-Logs (unter opt/apigee/var/log/edge-management-server) auf Fehler.
Rufen Sie den Verwaltungsserver auf, um zu prüfen, ob er ordnungsgemäß funktioniert.
Entfernen Sie den Server aus dem ELB und starten Sie dann den Verwaltungsserver neu.
/opt/apigee/apigee-service/bin/apigee-service, Edge-Management-Serverneustart

Router

Sie können eine API-Prüfung auf dem Router (oder einem beliebigen Server) durchführen, indem Sie den folgenden CURL-Befehl aufrufen:

curl http://<host>:8081/v1/servers/self/up

Dabei ist Host die IP-Adresse des Routers.

Dieser Aufruf gibt „true“ und „false“ zurück. Bei „true“ bedeutet dies, dass der Knoten aktiv ist und der Routerdienst ausgeführt wird.

Wenn Sie keine HTTP 200-Antwort (OK) erhalten, kann Edge nicht auf Port 8081-Anfragen antworten.