Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Überwachung

Edge for Private Cloud v. 4.17.01

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

JMX aktivieren

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

Jede Komponente unterstützt JMX auf einem anderen Port. In der folgenden Tabelle sind der JMX-Port und die Datei aufgeführt, die Sie ändern müssen, um JMX auf diesem Port zu aktivieren:

Komponente	JMX-Port	Datei
Verwaltungsserver	1099	/opt/apigee/edge-management-server/bin/start
Message Processor	1101	/opt/apigee/edge-mesage-processor/bin/start
Qpid	1102	/opt/apigee/edge-qpid-server/bin/start
Postgres	1103	/opt/apigee/edge-postgres-server/bin/start

Wenn Sie beispielsweise JMX auf dem Management Server aktivieren möchten, öffnen Sie /opt/apigee/edge-management-server/bin/start in einem Editor. Die folgende Zeile sollte zum Starten des Management Servers verwendet werden:

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

Bearbeiten Sie diese Zeile, um Folgendes hinzuzufügen:

-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 ist. 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 neu. So starten Sie beispielsweise den Management Server neu:

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

JMX-Authentifizierung aktivieren und JMX-Passwort festlegen

Für das Monitoring von Management Server, Message Processor, Qpid und Postgres wird JMX verwendet. 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 eine change_jmx_auth-Aktion, mit der Sie die Authentifizierung aktivieren/deaktivieren und die JMX-Anmeldedaten festlegen können.

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-message-processor, edge-qpid-server oder edge-postgres-server.
Folgende Optionen sind verfügbar:
- -u: Nutzername
- -p: Passwort
- -e: y (aktivieren) oder n (deaktivieren)
Die Konfigurationsdatei enthält:
- JMX_USERNAME=username
- JMX_ENABLED=y/n
- JMX_PASSWORD=password (wenn nicht festgelegt oder nicht mit -p übergeben, werden Sie dazu aufgefordert)

So verwenden Sie beispielsweise 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 denselben Nutzernamen und dasselbe Passwort an.

Wenn Sie die JMX-Authentifizierung später deaktivieren möchten, verwenden Sie den folgenden Befehl:

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

Verwaltungsserver

JConsole zum Überwachen der Systemdiagnose und zum Verarbeiten von Informationen verwenden

Verwenden Sie JConsole (ein JMX-kompatibles Tool), um Systemdiagnosen und Prozessstatistiken zu verwalten und zu überwachen. Mit JConsole können Sie JMX-Statistiken nutzen, die vom Management Server (oder einem beliebigen Server) bereitgestellt werden, und sie in einer grafischen Oberfläche anzeigen lassen. Weitere Informationen zur Verwendung von 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 Management Servers (oder des entsprechenden Servers). Der Standardport für den Management Server ist 1099.

In der folgenden Tabelle sind die allgemeinen JMX-Statistiken aufgeführt:

JMX-MBeans	JMX-Attribute
Arbeitsspeicher	HeapMemoryUsage
	NonHeapMemoryUsage
	Nutzung
Hinweis: Attributwerte werden in vier Werten angezeigt: „committed“, „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

Dabei ist <host> die IP-Adresse des Management Servers.

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

Wenn Sie keine HTTP-200-Antwort (OK) erhalten, kann Edge nicht auf Anfragen an Port 8080 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 ihn:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server start

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

Der Management Server spielt eine wichtige Rolle, um alle anderen Pakete 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 „deployed“ anzeigen. Wenn diese fehlschlagen, gehen Sie so vor:

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

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. Wenn „true“, ist der Knoten aktiv und der Router-Dienst wird ausgeführt.

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