Diese Seite wurde von der Cloud Translation API übersetzt.

Überwachung

Edge for Private Cloud Version 4.17.05

In diesem Dokument werden die Monitoringtechniken 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 die JMX-Ports und die Datei aufgeführt, die Sie zum Aktivieren von JMX für diesen Port ändern:

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

Wenn Sie beispielsweise JMX auf dem Verwaltungsserver aktivieren möchten, öffnen Sie /opt/apigee/edge-management-server/bin/start in einem Editor. Sie sollten die folgende Zeile sehen, die zum Starten des Management-Servers 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

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

In dieser Zeile wird die JMX-Portnummer für den Management Server mit 1099 angegeben. 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 den Management-Server, Message Processor, Qpid und Postgres verwendet JMX. Standardmäßig ist für den Remote-JMX-Zugriff kein Passwort erforderlich.

Zum Aktivieren der JMX-Authentifizierung hat jede Komponente eine 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:

>  /<inst_root>/apigee/apigee-service/bin/apigee-service comp change_jmx_auth optionsOrConfigFile

wobei

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 (disierbar)
Konfigurationsdatei:
- JMX_NUTZERNAME=Nutzername
- JMX_ENABLED=y/n
- JMX_PASS=Passwort (wenn nicht festgelegt oder nicht mit -p übergeben, werden Sie dazu aufgefordert)

So verwenden Sie Optionen in der Befehlszeile:

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

Wenn Sie eine Konfigurationsdatei haben:

> /<inst_root>/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.

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

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

Verwaltungsserver

Mit der JConsole Systemdiagnose und Prozessinformationen überwachen

Verwenden Sie die JConsole (ein JMX-konformes Tool), um Systemdiagnosen und Prozessstatistiken zu verwalten und zu überwachen. Mit der JConsole können Sie vom Management-Server (oder jedem Server) bereitgestellte JMX-Statistiken abrufen und in einer grafischen Oberflä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 Management-Servers (oder des jeweiligen Servers). Für den Verwaltungsserver ist standardmäßig 1099 Port.

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

JMX MBeans	JMX-Attribute
Arbeitsspeicher	HeapMemoryUsage
	Nicht-HeapMemoryUsage
	Nutzung
Hinweis:Die Attributwerte werden in vier Werten angezeigt: zugesagt, init, max und verwendet.

Edge Application API-Prüfungen verwenden

Sie können die API-Prüfung auf dem Verwaltungsserver (oder einem beliebigen Server) mit dem folgenden CURL-Befehl ausführen:

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

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

Bei diesem Aufruf werden „true“ und „false“ zurückgegeben. Bei der Einstellung „true“ bedeutet das, dass der Knoten ausgeführt wird und der Java-Dienst ausgeführt wird.

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

Fehlerbehebung

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

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

Management Server spielt eine wichtige Rolle dabei, alle anderen Pakete in jeder lokalen Installation zusammenzuhalten. Mit den folgenden Befehlen können Sie auf dem Verwaltungsserver den Nutzer-, Organisations- und Bereitstellungsstatus 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 Fehler auftreten, gehen Sie so vor:

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

Router

Sie können die API-Prüfung auf dem Router (oder einem beliebigen Server) mit dem folgenden CURL-Befehl ausführen:

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

Dabei ist „host“ die IP-Adresse des Routers.

Bei diesem Aufruf werden „true“ und „false“ zurückgegeben. Bei der Einstellung „true“ bedeutet das, dass der Knoten eingerichtet ist und der Routerdienst ausgeführt wird.

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