No se pudo crear la sesión de registro

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

  1. 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>
    
  2. Si recibes algún error, toma nota de él. Ve a Problema de conectividad de red.

  3. 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

  1. Revisa el registro del servidor de administración /opt/apigee/var/log/edge-management-server/logs/system.log y 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>
    
  2. 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.

  3. 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.

  4. 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.

  5. Para probar la conectividad del servidor de administración al Message Processor en el puerto 8082, sigue estos pasos:

    1. Si telnet está disponible, úsalo:

      telnet <MessageProcessor_IP> 8082
      
    2. Si telnet no está disponible, usa netcat para verificar la conectividad de la siguiente manera:

      nc -vz <MessageProcessor_IP> 8082
      
    3. Si recibes la respuesta "Conexión rechazada" o "Se agotó el tiempo de espera de la conexión", ve al siguiente paso.

  6. Accede a cada uno de los procesadores de mensajes con la dirección IP correspondiente que mostró el error y realiza los siguientes pasos:

    1. Verifica si el Message Processor está escuchando en el puerto 8082:

      netstat -an | grep LISTEN | grep 8082
      
    2. Si el Message Processor está a la escucha en el puerto 8082, ve al paso 7.

    3. 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 restart
      
    4. Espera 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_ready
      
    5. Una vez que el Message Processor esté en funcionamiento, vuelve a verificar si está escuchando en el puerto 8082.

    6. Si el Message Processor está a la escucha en el puerto 8082, continúa con el paso 7.

  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.

  8. 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.

  9. 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 -n
    
  10. Si no hay reglas de firewall establecidas para el puerto 8082, ve a Problema de uso elevado de recursos.

  11. 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

  1. 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

  1. Revisa los registros del servidor de administración /opt/apigee/var/log/edge-management-server/logs/system.log y verifica si hay errores durante la creación de la sesión de seguimiento o depuración.
  2. 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.

  3. Si no ves un error similar al que se muestra en el ejemplo anterior, ve a Entradas obsoletas del procesador de mensajes.

  4. Si observas un error similar al que se muestra en el ejemplo anterior, sigue estos pasos.

  5. 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.

  6. 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>/environments
    

    Resultado 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" ]

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

  8. Si el entorno específico, por ejemplo, "dev", no aparece en el comando anterior, verifica /opt/apigee/var/log/edge-message-processor/logs/system.log y /opt/apigee/var/log/edge-message-processor/logs/startupruntimeerrors.log en los procesadores de mensajes para detectar errores durante la carga de los entornos.

  9. 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.

  1. 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 cert
    

    Error 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 cert 
    
  2. Obté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" 
    }
    
  3. 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.

  4. 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>
    
  5. Verifica la fecha de vencimiento de cada uno de los certificados y determina cuál es el certificado vencido o más antiguo.

  6. 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

  1. Si la IU de Edge tarda mucho tiempo y no puede crear la sesión de registro, estas son algunas de las posibles causas:
    1. Es posible que el servidor de administración haga referencia a procesadores de mensajes inexistentes (obsoletos).
    2. Se detuvieron los Message Processor o no se puede acceder a ellos
    3. Los procesadores de mensajes tienen un uso alto de memoria o CPU
  2. Revisa los registros del servidor de administración /opt/apigee/var/log/edge-management-server/logs/system.log y verifica si hay errores durante la creación de la sesión de seguimiento o depuración.
  3. 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 server
    

    Despué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>
    
  4. Estos dos errores podrían deberse a procesadores de mensajes específicos:

    1. Estar inactivo (ya no existe)
    2. Estar inactivo o no estar disponible por algún motivo
  5. 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)

  1. 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>&regions=<regionName>"
    
  2. 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:

    1. Diagrama de configuración de la topología de la nube privada más reciente
    2. 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.

  3. Borra los Message Processors obsoletos (inexistentes) con las siguientes APIs de administración:

    1. 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}&region=<regionName>&pod=<podName}&action=remove" 
      
    2. Tipo de servidor para anular el registro:

      curl http://<management-server-host>:8080/v1/servers -X POST -d "type={message-processor}&region=<regionName>&pod=<podName>&uuid=<uuid>&action=remove"
      
    3. Borra el servidor:

      curl http://<management-ip>:8080/v1/servers/<uuid> -X DELETE
      
  4. 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

  1. 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.
  2. 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

  1. 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 top en sistemas operativos basados en Unix para obtener la información de uso de recursos del proceso de Message Processor:

    top
    
  2. Si los Message Processor no experimentan una alta utilización de recursos, ve a Debes recopilar información de diagnóstico.

  3. 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.

    1. 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>
      
    2. 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>
      
      
    3. Ve a Resolución.

Solución

  1. 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 restart
    
  2. Supervisa las llamadas a la API y confirma si el problema persiste.

  3. 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

  1. 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>/revisions
    

    Resultado 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" ]

  2. 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.

  3. Repite los pasos 1 y 2 para todos los procesadores de mensajes.

  4. 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

  1. 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

  1. Verifica los registros de la IU de Edge /opt/apigee/var/log/edge-ui/application.log y /opt/apigee/var/log/edge-ui/edge-ui.log para ver si hay errores.
  2. 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:

  1. 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>
    
  2. Registro del servidor de administración

    /opt/apigee/var/log/edge-management-server/logs/system.log.
    
  3. Registros del Message Processor

    /opt/apigee/var/log/edge-message-processor/logs/system.log.
    
  4. Resultado de los comandos telnet/nc del servidor de administración al Message Processor:

    telnet <MessageProcessor_IP> 8082
    nc -vz <MessageProcessor_IP> 8082
    
  5. Resultado del siguiente comando netstat en los Message Processor:

    netstat -an > netstat.txt
    
  6. Si 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.log y /opt/apigee/var/log/edge-ui/edge-ui.log..

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