Você está lendo a documentação do Apigee Edge.
Acesse a documentação da
Apigee X. info
Sintoma
O usuário não consegue criar uma sessão de rastreamento na interface do Edge.
Mensagem de erro
Você vai receber uma mensagem de erro na interface do Edge, conforme mostrado abaixo:
Error creating trace session for API proxy <api proxy name>, revision <revision number>, environment <environment name>.
Failed to create DebugSession <session number>
Confira a captura de tela de uma mensagem de erro de exemplo observada na interface do Edge:

Causas possíveis
Confira abaixo algumas das possíveis causas desse erro:
| Causa | Descrição | Instruções de solução de problemas aplicáveis para |
| Problema de conectividade de rede | Falha na comunicação entre o servidor de gerenciamento e o processador de mensagens devido a problemas de conectividade de rede ou regras de firewall. | Usuários da nuvem privada do Edge |
| O ambiente não foi carregado no processador de mensagens | O ambiente específico (em que você está tentando ativar o rastreamento) não foi carregado nos processadores de mensagens devido a um erro. | |
| Entradas obsoletas do processador de mensagens | O servidor de gerenciamento está fazendo referência a processadores de mensagens inexistentes (desatualizados). | |
| Processador de mensagens inacessível | O processador de mensagens foi interrompido ou ficou inacessível. | |
| Problema de alta utilização de recursos | Os processadores de mensagens estão apresentando alta utilização de recursos (CPU, memória ou carga). | |
| O proxy de API não foi implantado em um ou mais processadores de mensagens | O proxy de API não pode ser implantado em um ou mais processadores de mensagens devido à falta de notificação de eventos durante a implantação. | |
| Problema com a interface do Edge | A interface do usuário do Edge não consegue criar uma sessão de rastreamento devido a um erro. |
Etapas comuns do diagnóstico
Execute esta API de gerenciamento:
curl -v <management-server-host>:8080/v1/runtime/organizations/<org-name>/environments/<env-name>/apis/<apiproxy-name>/revisions/<revision-number>/debugsessions -u <user>Se você receber algum erro, anote-o. Acesse Problema de conectividade de rede.
Se você receber uma resposta de sucesso, isso indica que a sessão de rastreamento pode ser criada pela API Management. No entanto, pode haver um problema com a interface do Edge que impede a criação de uma sessão de rastreamento na interface. Acesse Problema com a interface do Edge.
Causa: problema de conectividade de rede
Diagnóstico
Verifique o registro do servidor de gerenciamento
/opt/apigee/var/log/edge-management-server/logs/system.loge confira se há erros durante a criação da sessão de rastreamento/depuração.Exemplo de erro do registro do servidor de gerenciamento
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>O exemplo de erro acima mostra que estamos recebendo erros "Connection refused" quando o servidor de gerenciamento tenta se conectar ao processador de mensagens na porta 8082. Por isso, o servidor de gerenciamento não consegue criar a sessão de rastreamento.
Se você não encontrar erros relacionados à conectividade de rede ou um erro semelhante ao mostrado no exemplo acima, vá para O ambiente não foi carregado no processador de mensagens.
Se você encontrar erros relacionados à conectividade de rede ou um erro semelhante ao mostrado no exemplo acima, siga as etapas abaixo.
Teste a conectividade do servidor de gerenciamento com o processador de mensagens na porta 8082 seguindo estas etapas:
Se o telnet estiver disponível, use-o:
telnet <MessageProcessor_IP> 8082Se o telnet não estiver disponível, use o netcat para verificar a conectividade da seguinte maneira:
nc -vz <MessageProcessor_IP> 8082Se você receber a resposta "Conexão recusada" ou "Tempo limite da conexão excedido", vá para a próxima etapa.
Faça login em cada um dos processadores de mensagens com o endereço IP correspondente que mostrou o erro e siga estas etapas:
Verifique se o processador de mensagens está detectando na porta 8082:
netstat -an | grep LISTEN | grep 8082Se o processador de mensagens estiver escutando na porta 8082, vá para a etapa 7.
Se o processador de mensagens não estiver escutando na porta 8082, reinicie-o usando este comando:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restartAguarde até que o processador de mensagens seja totalmente iniciado usando este comando:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor wait_for_readyDepois que o processador de mensagens estiver ativo, verifique novamente se ele está escutando na porta 8082.
Se o processador de mensagens estiver escutando na porta 8082, vá para a etapa 7.
Verifique se você já pode iniciar a sessão de rastreamento na interface. Se o problema não aparecer mais, pule as etapas abaixo.
Se o processador de mensagens estiver em execução e escutando na porta 8082, mas você ainda não conseguir se conectar de outros servidores, como o Management Server, provavelmente há um firewall bloqueando as conexões externas.
Use o comando adequado para verificar as regras de firewall. Por exemplo, você pode executar o comando iptables para listar todas as regras de firewall definidas no seu sistema:
iptables -L -nSe não houver regras de firewall definidas para a porta 8082, vá para Problema de alta utilização de recursos.
Se houver regras de firewall configuradas na porta 8082, acesse a seção "Resolução" abaixo.
Resolução
- Trabalhe com o administrador de rede para permitir o tráfego de entrada/saída na porta 8082 de servidores externos.
Se o problema persistir, acesse Precisa de informações de diagnóstico.
Causa: o ambiente não foi carregado no processador de mensagens
Diagnóstico
- Verifique os registros do servidor de gerenciamento
/opt/apigee/var/log/edge-management-server/logs/system.loge confira se há erros durante a criação da sessão de rastreamento/depuração. Você pode receber uma mensagem de erro como "no valid responses from MP(s)" durante a criação da sessão de rastreamento/depuração, conforme mostrado abaixo:
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}Esse erro indica que os processadores de mensagens não estão respondendo ao servidor de gerenciamento por algum motivo.
Se você não encontrar um erro semelhante ao mostrado no exemplo acima, vá para Entradas do processador de mensagens desatualizadas.
Se você encontrar um erro semelhante ao mostrado no exemplo acima, siga estas etapas.
Uma das causas mais prováveis desse erro é que o ambiente em que você está tentando criar a sessão de rastreamento não está carregado nos processadores de mensagens.
Faça login em cada um dos processadores de mensagens e verifique se o ambiente específico em que você está tentando criar a sessão de rastreamento está carregado no processador de mensagens usando o comando abaixo:
curl -s http://localhost:8082/v1/runtime/organizations/<org-name>/environmentsExemplo de resposta:
Na saída do comando acima, você vai encontrar a lista de ambientes pertencentes à organização específica carregados no processador de mensagens. Por exemplo, se os ambientes preprod e test forem carregados no processador de mensagens, a saída será assim:
[ "preprod", "test" ]
Se o ambiente específico, por exemplo, "dev", em que você está tentando criar uma sessão de rastreamento, estiver listado como parte do comando acima, vá para Entradas do processador de mensagens obsoletas.
Se o ambiente específico, por exemplo, "dev", não estiver listado como parte do comando acima, verifique
/opt/apigee/var/log/edge-message-processor/logs/system.loge/opt/apigee/var/log/edge-message-processor/logs/startupruntimeerrors.lognos processadores de mensagens para encontrar erros durante o carregamento de ambientes.Há vários erros que podem levar à falha ao carregar um ambiente no processador de mensagens. A resolução depende do erro ocorrido.
Resolução
O ambiente pode não ser carregado no processador de mensagens por vários motivos. Esta seção ilustra alguns motivos possíveis que podem levar a esse problema e explica como resolvê-lo.
Se você encontrar um dos seguintes erros no registro do processador de mensagens, isso significa que há um problema com os certificados/chaves adicionados ao keystore/truststore especificado no ambiente especificado.
Erro 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 certErro 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 certPara conferir os detalhes do keystore/truststore especificado na mensagem de erro mostrada na etapa anterior, use a seguinte chamada de API de gerenciamento:
curl -v "http://<management-IPaddress>:8080/v1/organizations/<org-name>/environments/<env-name>/keystores/myTruststore" -u <user>Exemplo de saída:
{ "certs": [ "mycert", "mycert-new" ], "keys": [ "mycert" ], "name": "myTruststore" }O exemplo de saída mostra que há dois certificados e uma chave no truststore myTruststore. Normalmente, o truststore não contém uma chave. Se for o caso, é melhor ter um único certificado e uma única chave.
Receba os detalhes sobre os dois certificados usando a seguinte API:
curl -s http://<management-IPaddress>:8080/v1/runtime/organizations/<org-name>/environments/<env-name>/keystores/<keystore-name>/certs/<cert-name>Verifique a data de validade de cada certificado e determine qual deles expirou ou é mais antigo.
Exclua o certificado expirado ou indesejado do truststore "myTruststore".
Se o problema persistir ou se você encontrar um erro diferente dos mencionados na etapa 1 acima, acesse Precisa de informações de diagnóstico.
Causa: entradas de processador de mensagens desatualizadas OU processadores de mensagens inacessíveis
Diagnóstico
- Se a interface do Edge demorar muito e não conseguir criar a sessão de rastreamento, confira algumas das possíveis causas:
- O servidor de gerenciamento pode estar se referindo a processadores de mensagens não existentes (desatualizados)
- Os processadores de mensagens foram interrompidos ou ficaram inacessíveis
- Os processadores de mensagens estão apresentando alto uso de memória/CPU
- Verifique os registros do servidor de gerenciamento
/opt/apigee/var/log/edge-management-server/logs/system.loge confira se há erros durante a criação da sessão de rastreamento/depuração. Você pode receber uma mensagem de erro como "o servidor <UUID> não está ativo ou acessível" durante a criação de uma sessão de rastreamento/depuração, conforme mostrado abaixo:
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 serverDepois de um tempo, outro erro pode aparecer: "Connection timed out", como mostrado abaixo:
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>Esses dois erros podem ser causados por processadores de mensagens específicos:
- Estar desatualizado (não existir mais)
- Estar inativo/inacessível por algum motivo
Siga a resolução adequada dependendo do cenário encontrado.
Resolução
Cenário 1 : os processadores de mensagens estão desatualizados (não existem)
Receba a lista de processadores de mensagens usando a API de gerenciamento abaixo:
curl -u <sysadmin> "http://<management-server-host>:8080/v1/servers?pod=<podName>®ions=<regionName>"Anote o endereço IP ou o nome do host que correspondem aos UUIDs dos processadores de mensagens mencionados na mensagem de erro nos registros do servidor de gerenciamento (etapa 3 do diagnóstico acima). Verifique se eles são processadores de mensagens válidos usando uma das seguintes maneiras:
- Diagrama de configuração da topologia mais recente da nuvem privada
- Tabela de mapeamento mais recente de nome do host e endereço IP do servidor de borda
Se você considerar que eles são processadores de mensagens válidos, vá para Cenário 2 : os processadores de mensagens estão inacessíveis.
Exclua os processadores de mensagens desatualizados (inexistentes) usando as APIs de gerenciamento abaixo:
Cancele o registro do processador de mensagens nos ambientes da organização:
curl -X POST http://<management-server-host>:8080/v1/o/<orgName>/e/<envName>/servers -d "uuid={uuid}®ion=<regionName>&pod=<podName}&action=remove"Cancelar o registro do tipo de servidor:
curl http://<management-server-host>:8080/v1/servers -X POST -d "type={message-processor}®ion=<regionName>&pod=<podName>&uuid=<uuid>&action=remove"Exclua o servidor:
curl http://<management-ip>:8080/v1/servers/<uuid> -X DELETE
Repita a etapa 3 se você tiver o mesmo problema em outros ambientes da organização.
Cenário 2: não é possível acessar os processadores de mensagens
- Faça login em cada um dos processadores de mensagens determinando os endereços IP/nomes de host com base nos UUIDs observados na mensagem de erro nos registros do servidor de gerenciamento.
Reinicie o processador de mensagens:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
Verifique novamente se é possível criar a sessão de rastreamento. Se o problema persistir, acesse Precisa de informações de diagnóstico.
Causa: problema de uso intenso de recursos
Diagnóstico
Faça login em cada processador de mensagens e verifique se há alta utilização de algum recurso: CPU, memória ou carga. Use o comando
topem sistemas operacionais baseados em Unix para receber informações sobre o uso de recursos do processo do processador de mensagens:topSe os processadores de mensagens não estiverem com alta utilização de recursos, acesse Precisa coletar informações de diagnóstico.
Se os processadores de mensagens estiverem com uso alto de CPU ou uso da memória, isso pode estar fazendo com que eles não respondam ao servidor de gerenciamento a tempo. Isso impede que você crie uma sessão de rastreamento.
Se algum processador de mensagens estiver apresentando alto uso da CPU, gere três dumps de encadeamento a cada 30 segundos usando o seguinte comando:
sudo <JAVA_HOME>/bin/jstack -l <pid> > <filename>Se algum processador de mensagens estiver com uso da memória alto, gere um heap dump usando o seguinte comando:
sudo -u apigee <JAVA_HOME>/bin/jmap -dump:live,format=b,file=<filename> <pid>Mova para "Resolução".
Resolução
Reinicie o processador de mensagens usando o comando abaixo. Isso vai reduzir o uso da CPU e da memória:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restartMonitore as chamadas de API e confirme se o problema ainda existe.
Entre em contato com o suporte do Apigee Edge e forneça os despejos de encadeamento, despejo de heap e registros do processador de mensagens (
/opt/apigee/var/log/edge-message-processor/logs/system.log)) para ajudar na investigação da causa do alto uso de CPU/memória.
Causa: o proxy de API não foi implantado em um ou mais processadores de mensagens
Raramente, um proxy de API pode não ser implantado em um ou mais processadores de mensagens. Isso acontece principalmente devido à falta de notificação de evento do servidor de gerenciamento para o processador de mensagens durante a implantação do proxy de API específico. Nesse caso, também não será possível criar a sessão de rastreamento na interface do Edge.
Diagnóstico
Faça login em cada um dos processadores de mensagens e verifique se a revisão específica do proxy de API está implantada usando o seguinte comando:
curl -v localhost:8082/v1/runtime/organizations/<orgname>/environments/<envname>/apis/<apiname>/revisionsExemplo de resposta:
A lista de revisões vai aparecer como a saída do comando acima. Por exemplo, se a revisão 12 for implantada, a saída será assim:
[ "12" ]
Se a revisão específica do proxy de API não aparecer como saída do comando mencionado na etapa 1 acima, reinicie o processador de mensagens específico conforme explicado na Resolução abaixo.
Repita as etapas 1 e 2 para todos os processadores de mensagens.
Se a revisão específica do proxy de API estiver implantada em todos os processadores de mensagens, esse não será o motivo do problema. Acesse É necessário coletar informações de diagnóstico.
Resolução
Reinicie os processadores de mensagens específicos em que a revisão específica do proxy de API não está implantada:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
Causa: problema com a interface do Edge
Diagnóstico
- Verifique os registros da interface do Edge
/opt/apigee/var/log/edge-ui/application.loge/opt/apigee/var/log/edge-ui/edge-ui.logpara conferir se há erros. - Entre em contato com o suporte do Apigee Edge e compartilhe esses arquivos para uma investigação mais detalhada.
É necessário coletar informações de diagnóstico
Se o problema persistir mesmo depois de seguir as instruções acima, colete as seguintes informações de diagnóstico. Entre em contato e compartilhe com o suporte do Apigee Edge:
Saída do 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 do servidor de gerenciamento
/opt/apigee/var/log/edge-management-server/logs/system.log.Registros do processador de mensagens
/opt/apigee/var/log/edge-message-processor/logs/system.log.Saída dos comandos telnet/nc do servidor de gerenciamento para o processador de mensagens:
telnet <MessageProcessor_IP> 8082 nc -vz <MessageProcessor_IP> 8082Saída do comando netstat abaixo nos processadores de mensagens:
netstat -an > netstat.txtSe o problema for com a interface do Edge, forneça os registros da interface do Edge
/opt/apigee/var/log/edge-ui/application.loge/opt/apigee/var/log/edge-ui/edge-ui.log..Detalhes sobre quais seções deste Playbook foram testadas e outras informações que vão ajudar a acelerar a resolução do problema.