Estás viendo la documentación de Apigee Edge.
Ir a la documentación de
Apigee X. info
Síntoma
El usuario no puede crear una sesión de registro en la IU de Edge.
Mensaje de error
Recibirás un mensaje de error en la IU de Edge, como se muestra a continuación:
Error creating trace session for API proxy <api proxy name>, revision <revision number>, environment <environment name>.
Failed to create DebugSession <session number>
Esta es la captura de pantalla de un mensaje de error de ejemplo que se observa en la IU de Edge:

Causas posibles
A continuación, se indican algunas de las posibles causas de este error:
| Causa | Descripción | Instrucciones de solución de problemas aplicables para |
| Problema de conectividad de red | Falla en la comunicación entre el servidor de administración y el Message Processor debido a problemas de conectividad de red o reglas de firewall. | Usuarios de Edge Private Cloud |
| El entorno no se cargó en Message Processor | No se cargó un entorno específico (en el que intentas habilitar el seguimiento) en los Message Processor debido a un error. | |
| Entradas obsoletas del procesador de mensajes | El servidor de administración hace referencia a procesadores de mensajes inexistentes (obsoletos). | |
| Message Processor no disponible | El Message Processor se detuvo o no se puede acceder a él. | |
| Problema de uso elevado de recursos | Los Message Processor experimentan un uso alto de recursos (CPU, memoria o carga). | |
| El proxy de API no se implementó en uno o más Message Processors | Es posible que el proxy de API no se implemente en uno o más procesadores de mensajes debido a que falta la notificación de eventos durante la implementación. | |
| Problema con la IU de Edge | La IU de Edge no puede crear una sesión de registro debido a un error. |
Pasos comunes de diagnóstico
Ejecuta esta API de Management:
curl -v <management-server-host>:8080/v1/runtime/organizations/<org-name>/environments/<env-name>/apis/<apiproxy-name>/revisions/<revision-number>/debugsessions -u <user>Si recibes algún error, toma nota de él. Ve a Problema de conectividad de red.
Si recibes una respuesta correcta, significa que la sesión de registro de seguimiento se puede crear a través de la API de Management. Sin embargo, es posible que haya un problema con la IU de Edge, por lo que no se puede crear una sesión de registro en la IU. Ve a Problema con la IU de Edge.
Causa: Problema de conectividad de red
Diagnóstico
Revisa el registro del servidor de administración
/opt/apigee/var/log/edge-management-server/logs/system.logy verifica si hay errores durante la creación de la sesión de seguimiento o depuración.Error de muestra del registro del servidor de administración
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>El error de muestra anterior muestra que recibimos errores de "Connection refused" cuando el servidor de administración intenta conectarse al Message Processor en el puerto núm. 8082. Por lo tanto, el servidor de administración no puede crear la sesión de registro.
Si no ves ningún error relacionado con la conectividad de red o un error similar al que se muestra en el ejemplo anterior, ve a No se cargó el entorno en el Message Processor.
Si observas errores relacionados con la conectividad de red o un error similar al que se muestra en el ejemplo anterior, sigue los pasos que se indican a continuación.
Para probar la conectividad del servidor de administración al Message Processor en el puerto 8082, sigue estos pasos:
Si telnet está disponible, úsalo:
telnet <MessageProcessor_IP> 8082Si telnet no está disponible, usa netcat para verificar la conectividad de la siguiente manera:
nc -vz <MessageProcessor_IP> 8082Si recibes la respuesta "Conexión rechazada" o "Se agotó el tiempo de espera de la conexión", ve al siguiente paso.
Accede a cada uno de los procesadores de mensajes con la dirección IP correspondiente que mostró el error y realiza los siguientes pasos:
Verifica si el Message Processor está escuchando en el puerto 8082:
netstat -an | grep LISTEN | grep 8082Si el Message Processor está a la escucha en el puerto 8082, ve al paso 7.
Si el Message Processor no está escuchando en el puerto 8082, reinícialo con este comando:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restartEspera hasta que el Message Processor se haya iniciado por completo con este comando:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor wait_for_readyUna vez que el Message Processor esté en funcionamiento, vuelve a verificar si está escuchando en el puerto 8082.
Si el Message Processor está a la escucha en el puerto 8082, continúa con el paso 7.
Comprueba si ahora puedes iniciar la sesión de registro en la IU. Si el problema ya no se observa, omite los pasos que se indican a continuación.
Si el Message Processor se está ejecutando y está escuchando en el puerto 8082, pero aún no puedes conectarte desde los otros servidores, como el servidor de administración, es probable que haya un firewall que esté bloqueando las conexiones externas.
Usa el comando adecuado para verificar las reglas de firewall. Por ejemplo, puedes ejecutar el comando iptables para enumerar todas las reglas de firewall definidas en tu sistema:
iptables -L -nSi no hay reglas de firewall establecidas para el puerto 8082, ve a Problema de uso elevado de recursos.
Si hay reglas de firewall configuradas en el puerto 8082, ve a la sección Resolución que se encuentra más abajo.
Solución
- Trabaja con tu administrador de red para permitir el tráfico entrante y saliente en el puerto 8082 desde servidores externos.
Si el problema persiste, consulta Recopila información de diagnóstico.
Causa: El entorno no se cargó en el Message Processor
Diagnóstico
- Revisa los registros del servidor de administración
/opt/apigee/var/log/edge-management-server/logs/system.logy verifica si hay errores durante la creación de la sesión de seguimiento o depuración. Es posible que veas un mensaje de error como "no valid responses from MP(s)" durante la creación de la sesión de seguimiento o depuración, como se muestra a continuación:
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}Este error indica que los Message Processor no responden al servidor de administración por algún motivo.
Si no ves un error similar al que se muestra en el ejemplo anterior, ve a Entradas obsoletas del procesador de mensajes.
Si observas un error similar al que se muestra en el ejemplo anterior, sigue estos pasos.
Una de las causas más probables de este error es que el entorno en el que intentas crear la sesión de seguimiento no se cargó en los Message Processors.
Accede a cada uno de los Message Processor y verifica si el entorno específico en el que intentas crear la sesión de seguimiento se cargó en el Message Processor con el siguiente comando:
curl -s http://localhost:8082/v1/runtime/organizations/<org-name>/environmentsResultado de ejemplo:
En el resultado del comando anterior, verás la lista de entornos que pertenecen a la organización específica y que se cargaron en el Message Processor. Por ejemplo, si los entornos preprod y test se cargan en Message Processor, verás el siguiente resultado:
[ "preprod", "test" ]
Si el entorno específico, por ejemplo, "dev", en el que intentas crear una sesión de registro, aparece como parte del comando anterior, ve a Entradas obsoletas del procesador de mensajes.
Si el entorno específico, por ejemplo, "dev", no aparece en el comando anterior, verifica
/opt/apigee/var/log/edge-message-processor/logs/system.logy/opt/apigee/var/log/edge-message-processor/logs/startupruntimeerrors.logen los procesadores de mensajes para detectar errores durante la carga de los entornos.Puede haber muchos errores diferentes que podrían provocar la falla de la carga de un entorno en Message Processor. La resolución depende del error que se produjo.
Solución
Es posible que el entorno no se cargue en Message Processor por varios motivos. En esta sección, se ilustran algunos motivos posibles que pueden provocar este problema y se explica cómo resolverlo.
Si ves uno de los siguientes errores en el registro de Message Processor, se debe a un problema con los certificados o las claves que se agregaron al almacén de claves o almacén de certificados de confianza especificados en el entorno especificado.
Error 1: java.security.KeyStoreException: No se puede anular el certificado propio
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 certError 2: java.security.KeyStoreException: No se puede reemplazar la clave secreta
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 certObtén los detalles del almacén de claves o almacén de confianza especificado en el mensaje de error que se mostró en el paso anterior con la siguiente llamada a la API de administración:
curl -v "http://<management-IPaddress>:8080/v1/organizations/<org-name>/environments/<env-name>/keystores/myTruststore" -u <user>Resultado de ejemplo:
{ "certs": [ "mycert", "mycert-new" ], "keys": [ "mycert" ], "name": "myTruststore" }El resultado de ejemplo muestra que hay dos certificados y una clave en el almacén de confianza myTruststore. Por lo general, el almacén de certificados de confianza no contiene una clave. Si es así, es mejor tener un solo certificado y una sola clave.
Obtén los detalles de los dos certificados con la siguiente API:
curl -s http://<management-IPaddress>:8080/v1/runtime/organizations/<org-name>/environments/<env-name>/keystores/<keystore-name>/certs/<cert-name>Verifica la fecha de vencimiento de cada uno de los certificados y determina cuál es el certificado vencido o más antiguo.
Borra el certificado vencido o no deseado del almacén de certificados de confianza "myTruststore".
Si el problema persiste o ves algún error que no sea uno de los que se mencionan en el paso 1, consulta Recopila información de diagnóstico.
Causa: Entradas obsoletas del Message Processor O Message Processors inaccesibles
Diagnóstico
- Si la IU de Edge tarda mucho tiempo y no puede crear la sesión de registro, estas son algunas de las posibles causas:
- Es posible que el servidor de administración haga referencia a procesadores de mensajes inexistentes (obsoletos).
- Se detuvieron los Message Processor o no se puede acceder a ellos
- Los procesadores de mensajes tienen un uso alto de memoria o CPU
- Revisa los registros del servidor de administración
/opt/apigee/var/log/edge-management-server/logs/system.logy verifica si hay errores durante la creación de la sesión de seguimiento o depuración. Es posible que veas un mensaje de error como "el servidor <UUID> no está en funcionamiento o no se puede acceder a él" durante la creación de la sesión de seguimiento o depuración, como se muestra a continuación:
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 serverDespués de un tiempo, es posible que aparezca un error más: "Se agotó el tiempo de espera de la conexión", como se muestra a continuación:
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>Estos dos errores podrían deberse a procesadores de mensajes específicos:
- Estar inactivo (ya no existe)
- Estar inactivo o no estar disponible por algún motivo
Sigue la resolución adecuada según la situación que se presente.
Solución
Situación 1 : Los Message Processor están inactivos (no existen)
Obtén la lista de Message Processors con la siguiente API de administración:
curl -u <sysadmin> "http://<management-server-host>:8080/v1/servers?pod=<podName>®ions=<regionName>"Anota la dirección IP o el nombre de host que corresponden a los UUID de los procesadores de mensajes mencionados en el mensaje de error de los registros del servidor de administración (paso 3 del diagnóstico anterior). Verifica si estos son procesadores de mensajes válidos de una de las siguientes maneras:
- Diagrama de configuración de la topología de la nube privada más reciente
- Tabla de asignación de nombre de host y dirección IP del servidor perimetral más reciente
Si los consideras procesadores de mensajes válidos, ve al Caso 2 : No se puede acceder a los procesadores de mensajes.
Borra los Message Processors obsoletos (inexistentes) con las siguientes APIs de administración:
Anula el registro del Message Processor en los entornos de la organización:
curl -X POST http://<management-server-host>:8080/v1/o/<orgName>/e/<envName>/servers -d "uuid={uuid}®ion=<regionName>&pod=<podName}&action=remove"Tipo de servidor para anular el registro:
curl http://<management-server-host>:8080/v1/servers -X POST -d "type={message-processor}®ion=<regionName>&pod=<podName>&uuid=<uuid>&action=remove"Borra el servidor:
curl http://<management-ip>:8080/v1/servers/<uuid> -X DELETE
Repite el paso 3 si tienes el mismo problema en otros entornos de tu organización.
Situación 2: No se puede acceder a los Message Processor
- Accede a cada uno de los Message Processor(s) determinando las direcciones IP o los nombres de host según los UUID que se observan en el mensaje de error de los registros del servidor de administración.
Reinicia el procesador de mensajes:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
Vuelve a verificar si puedes crear la sesión de registro. Si el problema persiste, consulta Recopila información de diagnóstico.
Causa: Problema de uso elevado de recursos
Diagnóstico
Accede a cada uno de los Message Processors y verifica si hay un uso elevado de algún recurso(CPU, memoria o carga). Puedes usar el comando
topen sistemas operativos basados en Unix para obtener la información de uso de recursos del proceso de Message Processor:topSi los Message Processor no experimentan una alta utilización de recursos, ve a Debes recopilar información de diagnóstico.
Si los procesadores de mensajes experimentan un uso elevado de la CPU o la memoria, es posible que esto impida que respondan al servidor de administración a tiempo. Esto, con el tiempo, te impedirá crear sesiones de registro.
Si algún Message Processor experimenta un uso elevado de la CPU, genera tres volcados de subprocesos cada 30 segundos con el siguiente comando:
sudo <JAVA_HOME>/bin/jstack -l <pid> > <filename>Si algún procesador de mensajes tiene un uso elevado de memoria, genera un volcado de montón con el siguiente comando:
sudo -u apigee <JAVA_HOME>/bin/jmap -dump:live,format=b,file=<filename> <pid>Ve a Resolución.
Solución
Reinicia el Message Processor con el siguiente comando. Esto debería reducir el uso de CPU y memoria:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restartSupervisa las llamadas a la API y confirma si el problema persiste.
Comunícate con el equipo de asistencia de Apigee Edge y proporciona los volcados de subprocesos, el volcado de montón y los registros de Message Processor (
/opt/apigee/var/log/edge-message-processor/logs/system.log)) para ayudarlos a investigar la causa del uso elevado de CPU o memoria.
Causa: El proxy de API no se implementó en uno o más Message Processors
En raras ocasiones, es posible que un proxy de API no se implemente en uno o más Message Processors. Esto sucede principalmente porque falta una notificación de evento del servidor de administración al Message Processor durante la implementación del proxy de API específico. En este caso, tampoco podrás crear la sesión de registro en la IU de Edge.
Diagnóstico
Accede a cada uno de los Message Processors y verifica si se implementó la revisión específica del proxy de API con el siguiente comando:
curl -v localhost:8082/v1/runtime/organizations/<orgname>/environments/<envname>/apis/<apiname>/revisionsResultado de ejemplo:
Verás la lista de revisiones como resultado del comando anterior. Por ejemplo, si se implementa la revisión 12, verás el siguiente resultado:
[ "12" ]
Si la revisión específica del proxy de API no aparece como resultado del comando mencionado en el paso 1 anterior, reinicia el Message Processor específico como se explica en la Resolución a continuación.
Repite los pasos 1 y 2 para todos los procesadores de mensajes.
Si la revisión específica del proxy de API se implementa en todos los Message Processors, este no es el motivo del problema. Ve a Se debe recopilar información de diagnóstico.
Solución
Reinicia los Message Processors específicos en los que no se implementó la revisión específica del proxy de API:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
Causa: Problema con la IU de Edge
Diagnóstico
- Verifica los registros de la IU de Edge
/opt/apigee/var/log/edge-ui/application.logy/opt/apigee/var/log/edge-ui/edge-ui.logpara ver si hay errores. - Comunícate con el equipo de asistencia de Apigee Edge y comparte estos archivos para que se realice una investigación más detallada.
Se debe recopilar información de diagnóstico
Si el problema persiste incluso después de seguir las instrucciones anteriores, recopila la siguiente información de diagnóstico. Comunícate con el equipo de asistencia de Apigee Edge y comparte los siguientes datos:
Resultado 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>Registro del servidor de administración
/opt/apigee/var/log/edge-management-server/logs/system.log.Registros del Message Processor
/opt/apigee/var/log/edge-message-processor/logs/system.log.Resultado de los comandos telnet/nc del servidor de administración al Message Processor:
telnet <MessageProcessor_IP> 8082 nc -vz <MessageProcessor_IP> 8082Resultado del siguiente comando netstat en los Message Processor:
netstat -an > netstat.txtSi se detectó que el problema está relacionado con la IU de Edge, proporciona los registros de la IU de Edge
/opt/apigee/var/log/edge-ui/application.logy/opt/apigee/var/log/edge-ui/edge-ui.log..Detalles sobre qué secciones de este Playbook se probaron y cualquier otra estadística que nos ayude a acelerar la resolución de este problema