Referência da mensagem de erro

Você está lendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X. info

Esta página contém links para playbooks de solução de problemas de erros e outros problemas que você pode encontrar ao usar o Apigee Edge. Cada playbook de solução de problemas explica como diagnosticar e resolver cada tipo de problema.

Problemas de análise

Estes tópicos explicam como solucionar problemas em que os dados de análise não aparecem nos painéis de análise ou em relatórios personalizados.

Mensagem ou descrição do erro Playbook
The report timed out: Try again with a smaller date range or a larger aggregation interval.

Relatórios de análise com tempo limite excedido

ou:

Tempo limite do relatório excedido
Talvez você não observe nenhuma mensagem de erro, a menos que o espaço em disco esteja completamente cheio no servidor Postgres. Servidor Postgres com pouco espaço em disco
Nenhum erro observado. Variável personalizada não visível para relatórios personalizados de análise
No traffic in the selected date range Dados não aparecendo nos painéis de análise
O tópico explica como fazer uma tarefa comumente solicitada. Como adicionar e excluir componentes de análise em grupos de análise
Could not get data for path Dimensões personalizadas não aparecendo quando vários axgroups foram configurados

Erros de implantação

A implantação de proxies de API pode falhar por vários motivos, como problemas de conectividade de rede entre servidores de borda, problemas com o armazenamento de dados do Cassandra, exceções do ZooKeeper e erros no pacote de proxy de API. Esta seção fornece informações e orientações sobre alguns procedimentos específicos que podem ser seguidos para solucionar erros de implantação.
Mensagem ou descrição do erro Playbook
Error: Call timed out; either server is down or server is not reachable Erro de tempo limite
Unexpected error Error while fetching children for path Erro ao buscar filhos para o caminho
Error while accessing datastore;Please retry later Erro ao acessar o armazenamento de dados
Configuration failed, associated contexts = [] Falha na configuração
Unexpected error occurred while processing the updates, associated contexts = [] Erro ao processar atualizações

Erros do portal do desenvolvedor

Estes tópicos ajudam você com problemas que podem ocorrer ao usar o portal do desenvolvedor. Antes de tentar corrigir problemas do portal do desenvolvedor, confira se você tem um entendimento básico de como o portal do desenvolvedor funciona, conforme explicado em Visão geral da solução de problemas do portal do desenvolvedor.
Mensagem ou descrição do erro Playbook
An internal error has occurred. Please retry your request. Erro interno do portal do desenvolvedor
The website encountered an unexpected error. Please try again later. OR There was an error trying to create the App. Please try again later. Problemas de comunicação do portal do desenvolvedor

Problemas de monetização

Os tópicos a seguir ajudam a solucionar e corrigir problemas comuns de monetização.

Mensagem ou descrição do erro Playbook 
<error>
   <messages>
        <message>Exceeded developer limit configuration -</message>
        <message>Is Developer Suspended - true</message>
   </messages>
</error>
Desenvolvedor suspenso
Talvez você não observe nenhuma mensagem de erro, mas verá problemas conforme explicado na seção Sintoma em Problemas de configuração de monetização. Problemas de configuração de monetização

Problemas do roteador de borda

O roteador de borda é implementado com o NGINX. Durante o processo de upgrade do Edge ou ao mudar a configuração do roteador, você pode encontrar erros de configuração do NGINX. O tópico a seguir ajuda a resolver esses problemas.

Mensagem ou descrição do erro Playbook
Nenhuma mensagem de erro será exibida. No entanto, talvez não seja possível executar os proxies de API devido aos arquivos de configuração incorretos. Arquivos de configuração incorretos
429 Too Many Requests: Tuning Nginx Router connection limits 429 Muitas solicitações

Problemas do OpenLDAP

Os tópicos a seguir ajudam a solucionar e corrigir problemas comuns do OpenLDAP.

Mensagem ou descrição do erro Playbook
Unknown username and password combination. O SMTP está desativado e os usuários precisam redefinir a senha
Nenhum erro aparece. A interface do Edge simplesmente não mostra a lista de usuários que deveriam ter sido replicados em todos os servidores OpenLDAP. O LDAP não está replicando.
SLAPD Dead But Pid File Exists Não é possível iniciar o OpenLDAP
Unknown username and password combination. Corrupção de dados do OpenLDAP

Erros de execução

Os tópicos a seguir ajudam a solucionar e corrigir problemas comuns de execução.

Mensagem ou descrição do erro Playbook
HTTP/1.1 500 Internal Server Error OU 
{
   "fault":{
      "detail":{
         "errorcode":"steps.servicecallout.ExecutionFailed"
      },
      "faultstring":"Execution of ServiceCallout callWCSAuthServiceCallout failed.
        Reason: ResponseCode 400 is treated as error"
   }
}
500 Erro interno do servidor
HTTP/1.1 502 Bad Gateway OU 
{
   "fault": {
      "faultstring": "Unexpected EOF at target",
      "detail": {
           "errorcode": "messaging.adaptors.http.UnexpectedEOFAtTarget"
       }
    }
}
502 Bad Gateway
HTTP/1.1 503 Service Unavailable OU HTTP/1.1 503 Service Unavailable: Back-end server is at capacity OU 
{
   "fault": {
      "faultstring": "The Service is temporarily unavailable",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.ServiceUnavailable"
       }
    }
}
503 Serviço não disponível
HTTP/1.1 503 Service Unavailable OU Received fatal alert: handshake_failure Falhas de handshake de SSL
HTTP/1.1 503 Service Unavailable 
{
 "fault": {
    "faultstring":"The Service is temporarily unavailable",
    "detail":{
        "errorcode":"messaging.adaptors.http.flow.ServiceUnavailable"
    }
 }
}
Falhas de handshake de SSL : certificado de cliente incorreto
HTTP/1.1 504 Gateway Timeout 
{
   "fault": {
      "faultstring": "Gateway Timeout",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.GatewayTimeout"
       }
    }
}
504 Gateway Tempo limite do gateway

Problemas do Zookeeper

Os tópicos a seguir ajudam a solucionar e corrigir problemas comuns do Zookeeper.
Mensagem ou descrição do erro Playbook
org: env: main ERROR ZOOKEEPER - ZooKeeperServiceImpl.exists() : Could not detect existence of path: /regions/dc-1/pods/analytics/servers/abc123/reachable , reason: KeeperErrorCode = ConnectionLoss

OU

org.apache.zookeeper.KeeperException$ConnectionLossException: KeeperErrorCode = ConnectionLoss

OU

A interface do Edge pode mostrar este erro:

Error Fetching Deployments Error while checking path existence for path: path 		Zookeeper Erros de perda de conexão
Problemas relacionados a dados, geralmente chamados de problemas de fiação, podem se manifestar como um de vários problemas. Consulte Problemas de dados do Zookeeper para mais detalhes. Problemas de dados do Zookeeper
+ apigee-service apigee-zookeeper status apigee-service: apigee-zookeeper: Not running (DEAD) apigee-all: Error: status failed on [apigee-zookeeper] Não é possível iniciar o Zookeeper

Ferramentas e registros de diagnóstico

Estes tópicos descrevem ferramentas e registros que podem ser usados para ajudar a diagnosticar determinados tipos de problemas que podem ocorrer ao usar o Apigee Edge.

  • Utilitário de sniffer de pacotes TCP/IP (tcpdump)
    A ferramenta tcpdump é um sniffer de pacotes de linha de comando que permite capturar ou filtrar pacotes TCP/IP recebidos ou transferidos por uma rede.
  • Heap dumps
    Os heap dumps são um snapshot da memória de um processo Java. Eles contêm informações sobre os objetos e classes Java no heap no momento em que o heap dump é coletado.
  • Despejos de linhas de execução
    Um despejo de linhas de execução é um snapshot do estado de todas as linhas de execução de um processo Java em execução. O estado de cada linha de execução é apresentado com o conteúdo da pilha, chamado de rastreamento de pilha.