Stai visualizzando la documentazione di Apigee Edge.
Consulta la
documentazione di Apigee X. info
Sintomo
L'utente non è in grado di creare una sessione di tracciamento nella UI di Edge.
Messaggio di errore
Riceverai un messaggio di errore nell'interfaccia utente di Edge come mostrato di seguito:
Error creating trace session for API proxy <api proxy name>, revision <revision number>, environment <environment name>.
Failed to create DebugSession <session number>
Ecco lo screenshot di un messaggio di errore di esempio osservato nella UI di Edge:

Possibili cause
Di seguito sono elencate alcune delle possibili cause di questo errore:
| Causa | Descrizione | Istruzioni per la risoluzione dei problemi applicabili a |
| Problema di connettività di rete | Errore di comunicazione tra il server di gestione e il processore di messaggi a causa di problemi di connettività di rete o regole firewall. | Utenti di Edge Private Cloud |
| Ambiente non caricato sul processore di messaggi | L'ambiente specifico (in cui stai tentando di attivare la traccia) non è stato caricato sul processore o sui processori di messaggi a causa di un errore. | |
| Voci del processore di messaggi obsolete | Il server di gestione fa riferimento a processori di messaggi inesistenti (obsoleti). | |
| Message Processor Unreachable | Il processore di messaggi è stato arrestato o non è più raggiungibile. | |
| Problema di utilizzo elevato delle risorse | I processori di messaggi stanno riscontrando un elevato utilizzo delle risorse (CPU, memoria o carico). | |
| Proxy API non di cui non è stato eseguito il deployment su uno o più Message Processor | Il proxy API potrebbe non essere sottoposto a deployment su uno o più Message Processor a causa della mancata notifica degli eventi durante il deployment. | |
| Problema con la UI Edge | L'interfaccia utente Edge non è in grado di creare una sessione di traccia a causa di un errore. |
Passaggi di diagnostica comuni
Esegui questa API di gestione:
curl -v <management-server-host>:8080/v1/runtime/organizations/<org-name>/environments/<env-name>/apis/<apiproxy-name>/revisions/<revision-number>/debugsessions -u <user>Se ricevi errori, annotali. Vai a Problema di connettività di rete.
Se ricevi una risposta positiva, significa che la sessione di traccia può essere creata tramite l'API di gestione. Tuttavia, potrebbe esserci un problema con la UI di Edge che impedisce la creazione della sessione di traccia nella UI. Vai a Problema con la UI di Edge.
Causa: problema di connettività di rete
Diagnosi
Controlla il log del server di gestione
/opt/apigee/var/log/edge-management-server/logs/system.loge verifica la presenza di errori durante la creazione della sessione di traccia/debug.Esempio di errore dal log del server di gestione
2018-02-08 09:08:21,310 org:myorg env:uat qtp1073741635-1074 ERROR DISTRIBUTION - DebugSessionAPI.createDebugSession() : createDebugSession : Unable to connect to the server with UUID cedeabd2-e4d1-40bb-8f18-d6afc8835e5b org.apache.http.conn.HttpHostConnectException: Connect to 10.84.75.92:8082 [/10.84.75.92] failed: Connection refused at org.apache.http.impl.conn.HttpClientConnectionOperator.connect(HttpClientConnectionOperator.java:140) ~[httpclient-4.3.5.jar:4.3.5] at org.apache.http.impl.conn.PoolingHttpClientConnectionManager.connect(PoolingHttpClientConnectionManager.java:318) ~[httpclient-4.3.5.jar:4.3.5] at org.apache.http.impl.execchain.MainClientExec.establishRoute(MainClientExec.java:363) ~[httpclient-4.3.5.jar:4.3.5] ...<snipped> Caused by: java.net.ConnectException: Connection refused at java.net.PlainSocketImpl.socketConnect(Native Method) ~[na:1.8.0_65] at java.net.AbstractPlainSocketImpl.doConnect(AbstractPlainSocketImpl.java:350) ~[na:1.8.0_65] ...<snipped>L'errore di esempio riportato sopra mostra che vengono visualizzati errori "Connessione rifiutata" quando il server di gestione tenta di connettersi al processore di messaggi sulla porta n. 8082. Pertanto, il server di gestione non è in grado di creare la sessione di traccia.
Se non visualizzi errori relativi alla connettività di rete o un errore simile a quello mostrato nell'esempio precedente, vai a Ambiente non caricato sul processore di messaggi.
Se riscontri errori relativi alla connettività di rete o un errore simile a quello mostrato nell'esempio precedente, segui i passaggi riportati di seguito.
Verifica la connettività dal server di gestione al processore di messaggi sulla porta 8082 seguendo questi passaggi:
Se telnet è disponibile, utilizzalo:
telnet <MessageProcessor_IP> 8082Se telnet non è disponibile, utilizza netcat per controllare la connettività nel seguente modo:
nc -vz <MessageProcessor_IP> 8082Se ricevi la risposta "Connessione rifiutata" o "Timeout della connessione", vai al passaggio successivo.
Accedi a ogni Message Processor con l'indirizzo IP corrispondente che ha mostrato l'errore ed esegui i seguenti passaggi:
Controlla se il processore di messaggi è in ascolto sulla porta 8082:
netstat -an | grep LISTEN | grep 8082Se il processore di messaggi è in ascolto sulla porta 8082, vai al passaggio 7.
Se il processore di messaggi non è in ascolto sulla porta 8082, riavvia il processore di messaggi utilizzando questo comando:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restartAttendi che il processore di messaggi abbia completato l'avvio utilizzando questo comando:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor wait_for_readyUna volta avviato il processore di messaggi, controlla di nuovo se è in ascolto sulla porta 8082.
Se il processore di messaggi è in ascolto sulla porta 8082, vai al passaggio 7.
Controlla se ora riesci ad avviare la sessione di tracciamento nella UI. Se il problema non si verifica più, salta i passaggi riportati di seguito.
Se il processore di messaggi è in esecuzione e in ascolto sulla porta 8082, ma non riesci ancora a connetterti da altri server come Management Server, probabilmente è presente un firewall che blocca le connessioni esterne.
Utilizza il comando appropriato per controllare le regole firewall. Ad esempio, puoi eseguire il comando iptables per elencare tutte le regole firewall definite nel sistema:
iptables -L -nSe non sono impostate regole firewall per la porta 8082, vai a Problema di utilizzo elevato delle risorse.
Se sono presenti regole firewall configurate sulla porta 8082, vai alla sezione Risoluzione dei problemi di seguito.
Risoluzione
- Collabora con l'amministratore di rete per consentire il traffico in entrata/uscita sulla porta 8082 dai server esterni.
Se il problema persiste, vai a Informazioni di diagnostica da raccogliere.
Causa: ambiente non caricato sul processore di messaggi
Diagnosi
- Controlla i log del server di gestione
/opt/apigee/var/log/edge-management-server/logs/system.loge verifica la presenza di errori durante la creazione della sessione di tracciamento/debug. Durante la creazione della sessione di traccia/debug, potresti visualizzare un messaggio di errore come "nessuna risposta valida dai MP", come mostrato di seguito:
2018-01-30 08:28:09,721 org:mynonprod env:uat qtp2007599722-712162 ERROR DISTRIBUTION - DebugSessionAPI.createDebugSession() : no valid responses from MP(s), throwing error 2018-01-30 08:28:09,723 org:mynonprod env:uat qtp2007599722-712162 ERROR REST - CustomJAXRSInvoker.performInvocation() : CustomJAXRSInvoker.performInvocation : Method com.apigee.distribution.DebugSessionAPI.createDebugSession threw an exception. 2018-01-30 08:28:09,724 org:mynonprod env:uat qtp2007599722-712162 ERROR REST - ExceptionMapper.toResponse() : Error occurred : Failed to create DebugSession 1517297564678 2018-01-30 08:28:09,724 org:mynonprod env:uat qtp2007599722-712162 ERROR REST - ExceptionMapper.toResponse() : Returning error response : ErrorResponse{errorCode = distribution.CreateDebugSessionFailed, errorMessage = Failed to create DebugSession 1517297564678}Questo errore indica che i processori di messaggi non rispondono al server di gestione per qualche motivo.
Se non visualizzi un errore simile a quello mostrato nell'esempio precedente, vai a Voci del processore di messaggi obsoleti.
Se si verifica un errore simile a quello mostrato nell'esempio precedente, segui questi passaggi.
Una delle cause più probabili di questo errore è che l'ambiente in cui stai tentando di creare la sessione di traccia non è caricato sui processori di messaggi.
Accedi a ogni processore di messaggi e controlla se l'ambiente specifico in cui stai tentando di creare la sessione di traccia è caricato su processore di messaggi utilizzando il seguente comando:
curl -s http://localhost:8082/v1/runtime/organizations/<org-name>/environmentsOutput di esempio:
Nell'output del comando precedente, vedrai l'elenco degli ambienti appartenenti all'organizzazione specifica caricati sul processore di messaggi. Ad esempio, se gli ambienti preprod e test vengono caricati sul processore di messaggi, l'output sarà il seguente:
[ "preprod", "test" ]
Se l'ambiente specifico, ad esempio "dev", in cui stai tentando di creare una sessione di tracciamento, è elencato nel comando precedente, vai a Voci del processore di messaggi obsoleti.
Se l'ambiente specifico, ad esempio "dev", non è elencato nel comando precedente, controlla
/opt/apigee/var/log/edge-message-processor/logs/system.loge/opt/apigee/var/log/edge-message-processor/logs/startupruntimeerrors.lognei Message Processor per eventuali errori durante il caricamento degli ambienti.Potrebbero verificarsi molti errori diversi che potrebbero causare il mancato caricamento di un ambiente sul processore di messaggi. La risoluzione dipende dall'errore verificatosi.
Risoluzione
L'ambiente potrebbe non essere caricato sul processore di messaggi per diversi motivi. Questa sezione illustra un paio di possibili motivi che possono causare questo problema e spiega come risolverlo.
Se visualizzi uno dei seguenti errori nel log del processore di messaggi, il problema è dovuto a un problema riscontrato con i certificati/le chiavi aggiunti al keystore/truststore specificato nell'ambiente specificato.
Errore n. 1: java.security.KeyStoreException: Cannot overwrite own certificate
2018-01-30 12:04:38,248 pool-47-thread-4 ERROR MESSAGING.RUNTIME - AbstractConfigurator.propagateEvent() : Error while handling the update for the Configurator com.apigee.kernel.exceptions.spi.UncheckedException: Failed to add certificate : mycert in key store : mytruststore in environment : test at com.apigee.entities.configurators.KeyStore.setCertificateEntry(KeyStore.java:156) ~[config-entities-1.0.0.jar:na] at com.apigee.entities.configurators.KeyStore.handleUpdate(KeyStore.java:101) ~[config-entities-1.0.0.jar:na] at com.apigee.entities.AbstractConfigurator.propagateEvent(AbstractConfigurator.java:85) ~[config-entities-1.0.0.jar:na] at com.apigee.messaging.runtime.Environment.handleUpdate(Environment.java:238) [message-processor-1.0.0.jar:na] … Caused by: java.security.KeyStoreException: Cannot overwrite own certificate at com.sun.crypto.provider.JceKeyStore.engineSetCertificateEntry(JceKeyStore.java:355) ~[sunjce_provider.jar:1.8.0_151] at java.security.KeyStore.setCertificateEntry(KeyStore.java:1201) ~[na:1.8.0_151] at com.apigee.entities.configurators.KeyStore.setCertificateEntry(KeyStore.java:153) ~[config-entities-1.0.0.jar:na] ... 20 common frames omitted 2018-01-30 12:04:38,250 pool-47-thread-4 ERROR MESSAGING.RUNTIME - AbstractConfigurator.rollbackTransaction() : Error in processing the changes : Unknown resource type certErrore n. 2: java.security.KeyStoreException: Cannot overwrite secret key
2017-11-01 03:28:47,560 pool-21-thread-7 ERROR MESSAGING.RUNTIME - AbstractConfigurator.propagateEvent() : Error while handling the update for the Configurator com.apigee.kernel.exceptions.spi.UncheckedException: Failed to add certificate : mstore in key store : myTruststore in environment : dev at com.apigee.entities.configurators.KeyStore.setCertificateEntry(KeyStore.java:156) ~[config-entities-1.0.0.jar:na] at com.apigee.entities.configurators.KeyStore.handleUpdate(KeyStore.java:101) ~[config-entities-1.0.0.jar:na] ... Caused by: java.security.KeyStoreException: Cannot overwrite secret key at com.sun.crypto.provider.JceKeyStore.engineSetCertificateEntry(JceKeyStore.java:354) ~[sunjce_provider.jar:1.8.0_144] at java.security.KeyStore.setCertificateEntry(KeyStore.java:1201) ~[na:1.8.0_144] at com.apigee.entities.configurators.KeyStore.setCertificateEntry(KeyStore.java:153) ~[config-entities-1.0.0.jar:na] ... 20 common frames omitted 2017-11-01 03:28:47,562 pool-21-thread-7 ERROR MESSAGING.RUNTIME - AbstractConfigurator.rollbackTransaction() : Error in processing the changes : Unknown resource type certRecupera i dettagli del keystore/truststore specificato nel messaggio di errore mostrato nel passaggio precedente utilizzando la seguente chiamata API di gestione:
curl -v "http://<management-IPaddress>:8080/v1/organizations/<org-name>/environments/<env-name>/keystores/myTruststore" -u <user>Output di esempio:
{ "certs": [ "mycert", "mycert-new" ], "keys": [ "mycert" ], "name": "myTruststore" }L'output di esempio mostra che sono presenti due certificati e una chiave nel truststore myTruststore. In genere, il truststore non contiene una chiave. In questo caso, è meglio avere un unico certificato e un'unica chiave.
Ottieni i dettagli sui due certificati utilizzando la seguente API:
curl -s http://<management-IPaddress>:8080/v1/runtime/organizations/<org-name>/environments/<env-name>/keystores/<keystore-name>/certs/<cert-name>Controlla la data di scadenza di ciascun certificato e determina il certificato scaduto/più vecchio.
Elimina il certificato scaduto o indesiderato dall'archivio attendibilità "myTruststore".
Se il problema persiste o se visualizzi un errore diverso da quelli menzionati nel passaggio 1 precedente, vai a Informazioni diagnostiche da raccogliere.
Causa: voci del processore di messaggi obsolete O processori di messaggi non raggiungibili
Diagnosi
- Se l'interfaccia utente Edge richiede molto tempo e non riesce a creare la sessione di tracciamento, ecco alcune delle possibili cause:
- Il server di gestione potrebbe fare riferimento a processori di messaggi non esistenti (obsoleti)
- Il processore o i processori di messaggi sono stati arrestati o non sono più raggiungibili
- I Message Processor riscontrano un utilizzo elevato di memoria/CPU
- Controlla i log del server di gestione
/opt/apigee/var/log/edge-management-server/logs/system.loge verifica se si sono verificati errori durante la creazione della sessione di traccia/debug. Durante la creazione della sessione di traccia/debug, potresti visualizzare un messaggio di errore simile a "server <UUID> is either not up or reachable", come mostrato di seguito:
2017-12-27 07:42:38,975 org:cocacola env:prod qtp2007599722-222063 INFO DISTRIBUTION - DebugSessionAPI.createDebugSession() : server 458b5910-2646-441c-a6e2-428b6d84e021 is either not up or reachable, skipping the serverDopo un po' potrebbe verificarsi un altro errore "Sessione di connessione scaduta", come mostrato di seguito:
2017-12-27 07:44:46.000 UTC org:cocacola env:prod qtp2007599722-222063 ERROR DISTRIBUTION - DebugSessionAPI.createDebugSession() : createDebugSession : Unable to connect to the server with UUID {}, skipping it458b5910-2646-441c-a6e2-428b6d84e021 org.apache.http.conn.HttpHostConnectException: Connect to 192.168.101.7:8080 [/192.168.101.7] failed: Connection timed out (Connection timed out) at org.apache.http.impl.conn.HttpClientConnectionOperator.connect(HttpClientConnectionOperator.java:140) ~[httpclient-4.3.5.jar:4.3.5] at org.apache.http.impl.conn.PoolingHttpClientConnectionManager.connect(PoolingHttpClientConnectionManager.java:318) ~[httpclient-4.3.5.jar:4.3.5] at org.apache.http.impl.execchain.MainClientExec.establishRoute(MainClientExec.java:363) ~[httpclient-4.3.5.jar:4.3.5] at org.apache.http.impl.execchain.MainClientExec.execute(MainClientExec.java:219) ~[httpclient-4.3.5.jar:4.3.5] …<snipped> Caused by: java.net.ConnectException: Connection timed out (Connection timed out) at java.net.PlainSocketImpl.socketConnect(Native Method) ~[na:1.8.0_144] at java.net.AbstractPlainSocketImpl.doConnect(AbstractPlainSocketImpl.java:350) ~[na:1.8.0_144] …<snipped>Questi due errori potrebbero essere causati da uno o più processori di messaggi specifici:
- Essere non aggiornati (non esistere più)
- Essere inattivo/non raggiungibile per qualche motivo
Segui la risoluzione appropriata a seconda dello scenario riscontrato.
Risoluzione
Scenario 1 : i processori di messaggi sono obsoleti (non esistono)
Ottieni l'elenco dei processori di messaggi utilizzando l'API di gestione riportata di seguito:
curl -u <sysadmin> "http://<management-server-host>:8080/v1/servers?pod=<podName>®ions=<regionName>"Annota l'indirizzo IP o il nome host corrispondente agli UUID dei Message Processor menzionati nel messaggio di errore nei log del server di gestione (passaggio 3 della diagnosi riportata sopra). Verifica se si tratta di responsabili del trattamento dei messaggi validi utilizzando uno dei seguenti metodi:
- Diagramma di configurazione della topologia di cloud privato più recente
- Tabella di mapping tra l'ultimo indirizzo IP del server edge e il nome host
Se li ritieni validi processori di messaggi, passa allo Scenario 2 : i processori di messaggi non sono raggiungibili.
Elimina i Message Processor obsoleti (inesistenti) utilizzando le seguenti API di gestione:
Annulla la registrazione del processore di messaggi dagli ambienti dell'organizzazione:
curl -X POST http://<management-server-host>:8080/v1/o/<orgName>/e/<envName>/servers -d "uuid={uuid}®ion=<regionName>&pod=<podName}&action=remove"Annulla la registrazione del tipo di server:
curl http://<management-server-host>:8080/v1/servers -X POST -d "type={message-processor}®ion=<regionName>&pod=<podName>&uuid=<uuid>&action=remove"Elimina il server:
curl http://<management-ip>:8080/v1/servers/<uuid> -X DELETE
Ripeti il passaggio 3 se riscontri lo stesso problema in altri ambienti della tua organizzazione.
Scenario 2: i processori di messaggi non sono raggiungibili
- Accedi a ogni processore di messaggi determinando gli indirizzi IP/i nomi host in base agli UUID osservati nel messaggio di errore nei log del server di gestione.
Riavvia il processore di messaggi:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
Controlla di nuovo se riesci a creare la sessione di tracciamento. Se il problema persiste, vai alla sezione Must Gather Diagnostic Information.
Causa: problema di utilizzo elevato delle risorse
Diagnosi
Accedi a ogni processore di messaggi e controlla se l'utilizzo di risorse(CPU, memoria o carico) è elevato. Puoi utilizzare il comando
topsui sistemi operativi basati su Unix per ottenere le informazioni sull'utilizzo delle risorse del processo processore di messaggi:topSe i processori di messaggi non registrano un utilizzo elevato delle risorse, vai a Raccogliere le informazioni diagnostiche necessarie.
Se il processore o i processori di messaggi registrano un utilizzo elevato della CPU o della memoria utilizzata, è possibile che il processore di messaggi non risponda in tempo al server di gestione. Ciò alla fine ti impedisce di creare una sessione di tracciamento.
Se un processore di messaggi sta riscontrando un elevato utilizzo della CPU, genera tre dump dei thread ogni 30 secondi utilizzando il seguente comando:
sudo <JAVA_HOME>/bin/jstack -l <pid> > <filename>Se un processore di messaggi ha un utilizzo elevato della memoria utilizzata, genera un dump dell'heap utilizzando il seguente comando:
sudo -u apigee <JAVA_HOME>/bin/jmap -dump:live,format=b,file=<filename> <pid>Sposta in Risoluzione.
Risoluzione
Riavvia il processore di messaggi utilizzando il comando riportato di seguito. In questo modo, l'utilizzo di CPU e memoria utilizzata dovrebbe diminuire:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restartMonitora le chiamate API e verifica se il problema persiste.
Contatta l'assistenza Apigee Edge e fornisci i dump dei thread, i dump dell'heap e i log del processore di messaggi (
/opt/apigee/var/log/edge-message-processor/logs/system.log)per aiutarli a esaminare la causa dell'elevato utilizzo di CPU/memoria utilizzata.
Causa: il proxy API non è stato eseguito il deployment su uno o più Message Processor
Di rado, un proxy API potrebbe non essere sottoposto a deployment su uno o più Message Processor. Ciò si verifica principalmente a causa della notifica di un evento mancante dal server di gestione al processore di messaggi durante il deployment del proxy API specifico. Anche in questo caso, non potrai creare la sessione di traccia nella UI di Edge.
Diagnosi
Accedi a ogni Message Processor e controlla se la revisione specifica del proxy API è implementata utilizzando il seguente comando:
curl -v localhost:8082/v1/runtime/organizations/<orgname>/environments/<envname>/apis/<apiname>/revisionsOutput di esempio:
Vedrai l'elenco delle revisioni come output del comando precedente. Ad esempio, se viene eseguita il deployment della revisione 12, l'output sarà il seguente:
[ "12" ]
Se la revisione specifica del proxy API non viene visualizzata come output del comando menzionato nel passaggio 1 precedente, riavvia il processore di messaggi specifico come spiegato nella Soluzione riportata di seguito.
Ripeti i passaggi 1-2 per tutti i processori di messaggi.
Se la revisione specifica del proxy API viene implementata su tutti i processori di messaggi, questo non è il motivo del problema. Vai a Must Gather Diagnostic Information.
Risoluzione
Riavvia i processori di messaggi specifici su cui non è stato eseguito il deployment della revisione specifica del proxy API:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
Causa: problema con la UI di Edge
Diagnosi
- Controlla i log dell'interfaccia utente Edge
/opt/apigee/var/log/edge-ui/application.loge/opt/apigee/var/log/edge-ui/edge-ui.loge verifica la presenza di errori. - Contatta l'assistenza Apigee Edge e condividi questi file per ulteriori indagini.
Informazioni diagnostiche da raccogliere
Se il problema persiste anche dopo aver seguito le istruzioni riportate sopra, raccogli le seguenti informazioni diagnostiche. Contattali e condividili con l'assistenza Apigee Edge:
Output del comando:
curl -v <management-server-host>:8080/v1/runtime/organizations/<org-name>/environments/<env-name>/apis/<apiproxy-name>/revisions/<revision-number>/debugsessions -u <user>Log del server di gestione
/opt/apigee/var/log/edge-management-server/logs/system.log.Log del processore di messaggi
/opt/apigee/var/log/edge-message-processor/logs/system.log.Output dei comandi telnet/nc dal server di gestione al processore di messaggi:
telnet <MessageProcessor_IP> 8082 nc -vz <MessageProcessor_IP> 8082Output del comando netstat riportato di seguito sui processori di messaggi:
netstat -an > netstat.txtSe è stato riscontrato un problema con l'interfaccia utente Edge, fornisci i log dell'interfaccia utente Edge
/opt/apigee/var/log/edge-ui/application.loge/opt/apigee/var/log/edge-ui/edge-ui.log.Dettagli sulle sezioni di questo Playbook che sono state provate e qualsiasi altro approfondimento che ci aiuti ad accelerare la risoluzione del problema.