Questa pagina è stata tradotta dall'API Cloud Translation.

Come monitorare

Edge per Private Cloud v. 4.17.01

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

Attivazione 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 ciascun componente.

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

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

Ad esempio, per abilitare JMX sul server di gestione, apri /opt/apigee/edge-management-server/bin/start in un editor. Dovresti visualizzare la seguente riga 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 che 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

Abilitazione dell'autenticazione JMX e impostazione della password JMX

Il processo di monitoraggio per il server di gestione, il processore di messaggi, Qpid e Postgres utilizzano tutti 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 consente di attivare/disattivare l'autenticazione e di impostare le credenziali JMX.

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

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

dove:

comp può essere 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 (attivabile)
Il file di configurazione include:
- JMX_USERNAME=nome utente
- JMX_ENABLED=y/n
- JMX_PASSWORD=password (se non impostata o non viene trasmessa con -p, ti verrà richiesto)

Ad esempio, per utilizzare le opzioni della 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 disabilitare in un secondo momento l'autenticazione JMX, 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 relative al processo

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

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

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

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

La seguente tabella mostra le statistiche JMX generiche:

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

Utilizzo dei controlli dell'API Edge Application

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

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

Dove <host> è l'indirizzo IP del server di gestione.

Questa chiamata restituisce i valori "true" e "false". Se 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 sulla porta 8080.

Risolvere i problemi

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

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

Il server di gestione svolge un ruolo vitale nel tenere insieme tutti gli altri pacchetti in ogni installazione on-premise. Puoi controllare lo stato degli utenti, dell'organizzazione e del deployment sul server di gestione inviando 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 "implementato" per tutte le chiamate. Se il problema persiste, procedi nel seguente modo:

Verifica la presenza di eventuali errori nei log del server di gestione (all'indirizzo opt/apigee/var/log/edge-management-server).
Effettua una chiamata al server di gestione per verificare che funzioni correttamente.
Rimuovi il server da ELB, quindi riavvia il server di gestione.
/opt/apigee/apigee-service/bin/apigee-service edge-management-server riavvio

Router

Puoi eseguire il controllo 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 i valori "true" e "false". Se 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 sulla porta 8081.