Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Come monitorare

Edge for Private Cloud v4.18.01

Questo documento descrive le tecniche di monitoraggio dei componenti supportati da un deployment on-premise di Apigee Edge.

Abilitazione di JMX

JMX è abilitato per impostazione predefinita per Cassandra e disabilitato per impostazione predefinita per tutti gli altri componenti Edge. Pertanto, devi abilitare JMX singolarmente per ogni componente.

Ogni componente supporta JMX su una porta diversa. La tabella seguente elenca la porta JMX e il file che devi modificare per abilitare JMX su quella porta:

Componente	Porta JMX	File
Server di gestione	1099	/opt/apigee/edge-management-server/bin/start
Router	1100	/opt/apigee/edge-router/bin/start
processore di messaggi	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

Ad esempio, per abilitare JMX sul server di gestione, apri /opt/apigee/edge-management-server/bin/start in un editor. Dovresti vedere la seguente riga utilizzata per avviare il server di gestione:

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

Modifica questa riga per aggiungere quanto segue:

-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

Tieni presente che questa riga specifica il numero di porta JMX 1099 per il server di gestione. Imposta il numero di porta per ogni componente come definito nella tabella precedente. Ad esempio:

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

Salva il file e riavvia il componente. Ad esempio, per riavviare il server di gestione:

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

Attivazione dell'autenticazione JMX e impostazione della password JMX

Il processo di monitoraggio per il server di gestione, il processore di messaggi, Qpid e Postgres utilizza JMX. JMX è abilitato per impostazione predefinita e l'accesso JMX remoto non richiede una password.

Per abilitare l'autenticazione JMX, ogni componente ha un'azione change_jmx_auth che utilizzi per abilitare/disabilitare l'autenticazione e impostare le credenziali JMX.

Per abilitare l'autenticazione JMX, utilizza il seguente comando:

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

dove:

comp è edge-management-server, edge-message-processor, edge-qpid-server, o edge-postgres-server.
Le opzioni sono:
- -u: nome utente
- -p: password
- -e: y (attiva) o n (disattiva)
Il file di configurazione include:
- JMX_USERNAME=username
- JMX_ENABLED=y/n
- JMX_PASSWORD=password (se non è impostata o non viene passata con -p, ti viene richiesto di inserirla)

Ad esempio, per utilizzare le opzioni nella riga di comando:

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

Se hai un file di configurazione:

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

Se esegui Edge su più nodi, esegui questo comando su tutti i nodi, specificando lo stesso nome utente e la stessa password.

Per disattivare l'autenticazione JMX in un secondo momento, utilizza il comando:

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

Server di gestione

Utilizzo di JConsole per monitorare il controllo di integrità del sistema e le informazioni sui processi

Utilizza JConsole (uno strumento conforme a JMX) per gestire e monitorare il controllo di integrità e le statistiche dei processi. Utilizzando JConsole, puoi utilizzare le statistiche JMX esposte dal server di gestione (o da qualsiasi server) e visualizzarle in un'interfaccia grafica. Per ulteriori informazioni sull'utilizzo di JConsole, consulta http://docs.oracle.com/javase/8/docs/technotes/guides/management/jconsole.html.

Utilizza JConsole e il seguente URL del servizio per monitorare gli attributi JMX (MBean) offerti tramite JMX.

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

dove <ip address> è l'indirizzo IP del server di gestione (o del rispettivo server). Per impostazione predefinita, la porta è 1099 per il server di gestione.

La tabella seguente mostra le statistiche JMX generiche:

MBean JMX	Attributi JMX
Memoria	HeapMemoryUsage
	NonHeapMemoryUsage
	Utilizzo
Nota: i valori degli attributi verranno visualizzati in quattro valori: committed, init, max e used.

Utilizzo dei controlli API Edge Application

Puoi eseguire il controllo dell'API sul server di gestione (o su qualsiasi server) richiamando il seguente comando CURL:

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

Dove <host> è l'indirizzo IP del server di gestione. Puoi specificare il tipo Accept come application/json o application/xml.

Questa chiamata restituisce "true" e "false". Se il valore è true, significa che il nodo è attivo e il servizio Java è in esecuzione.

Se non ricevi una risposta HTTP 200 (OK), Edge non è in grado di rispondere alle richieste della porta 8080.

Risoluzione dei problemi

Accedi al server ed esegui questo comando:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server status
Se il servizio non è in esecuzione, avvialo:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server start

Utilizzo dell'applicazione Edge: controlli di utenti, organizzazione e deployment

Il server di gestione svolge un ruolo fondamentale nel tenere insieme tutti gli altri pacchetti in ogni installazione on-premise. Puoi controllare lo stato di utenti, organizzazioni e deployment sul server di gestione eseguendo i seguenti comandi:

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

Il sistema dovrebbe mostrare lo stato "Deployment eseguito" per tutte le chiamate. Se questi passaggi non funzionano, procedi nel seguente modo:

Controlla i log del server di gestione (in opt/apigee/var/log/edge-management-server) per verificare la presenza di eventuali errori.
Effettua una chiamata al server di gestione per verificare se funziona correttamente.
Rimuovi il server dall'ELB, quindi riavvia il server di gestione.
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

Router

Puoi eseguire il controllo dell'API sul router (o su qualsiasi server) richiamando il seguente comando CURL:

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

Dove host è l'indirizzo IP del router.

Questa chiamata restituisce "true" e "false". Se il valore è true, significa che il nodo è attivo e il servizio Router è in esecuzione.

Se non ricevi una risposta HTTP 200 (OK), Edge non è in grado di rispondere alle richieste della porta 8081.