Referência da mensagem de erro

Você está visualizando 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 com o Google Analytics

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

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

Ocorreu um timeout nos relatórios do Analytics

ou:

O relatório expirou

Você não vai notar nenhuma mensagem de erro, a menos que o espaço em disco esteja completamente preenchido no Postgres Server. O servidor Postgres está ficando sem espaço em disco
Nenhum erro foi observado. A variável personalizada não está visível para os relatórios personalizados do Google Analytics
No traffic in the selected date range Os dados não aparecem nos painéis de análise
O tópico explica como realizar uma tarefa comum. Como adicionar e excluir componentes do Google Analytics em grupos de análise
Could not get data for path As dimensões personalizadas não aparecem quando vários grupos de anúncios 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 do Edge, problemas com o repositório 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 resolver erros de implantação.
Mensagem ou descrição de erro Manual
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 Datastore
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

Esses tópicos ajudam a resolver problemas que você pode encontrar ao usar o portal para desenvolvedores. Antes de tentar corrigir problemas do portal para desenvolvedores, entenda como ele funciona, conforme explicado em Visão geral da solução de problemas do portal para desenvolvedores.
Mensagem ou descrição de erro Manual
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. OU 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 vão ajudar a resolver problemas comuns de monetização.

Mensagem ou descrição de erro Manual
<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 vai notar problemas conforme explicado na seção Sintoma em Problemas de configuração da monetização. Problemas de configuração da monetização

Problemas com o 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, talvez você encontre erros de configuração do NGINX. O tópico a seguir vai ajudar você a resolver esses problemas.

Mensagem ou descrição de erro Manual
Nenhuma mensagem de erro vai aparecer. No entanto, talvez você não consiga executar os proxies da API devido aos arquivos de configuração inválidos. Arquivos de configuração incorretos
429 Too Many Requests: Tuning Nginx Router connection limits 429 Há muitas solicitações

Problemas do OpenLDAP

Os tópicos a seguir vão ajudar você a resolver e corrigir problemas comuns do OpenLDAP.

Mensagem ou descrição de erro Manual
Unknown username and password combination. SMTP 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 do 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 resolver e corrigir problemas comuns de execução.

Mensagem ou descrição de erro Manual
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 Gateway inválido
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 indisponível
HTTP/1.1 503 Service Unavailable OU Received fatal alert: handshake_failure Falhas de handshake de SSL
HTTP/1.1 503 Service Unavailable OU
{
 "fault": {
    "faultstring":"The Service is temporarily unavailable",
    "detail":{
        "errorcode":"messaging.adaptors.http.flow.ServiceUnavailable"
    }
 }
}
Falhas de handshake SSL: certificado de cliente inválido
HTTP/1.1 504 Gateway Timeout OU
{
   "fault": {
      "faultstring": "Gateway Timeout",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.GatewayTimeout"
       }
    }
}


Tempo limite de 504 do gateway

Problemas do Zookeeper

Os tópicos a seguir vão ajudar a resolver e corrigir problemas comuns do Zookeeper.
Mensagem ou descrição de erro Manual
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
Erros de perda de conexão do Zookeeper
Os problemas relacionados a dados, comumente chamados de problemas de fiação, podem se manifestar de várias formas. 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 foi possível iniciar o Zookeeper

Ferramentas e registros de diagnóstico

Estes tópicos descrevem ferramentas e registros que podem ser usados para diagnosticar determinados tipos de problemas que você pode encontrar ao usar o Apigee Edge.

  • Utilitário de sniffer de pacotes TCP/IP (tcpdump)
    A ferramenta tcpdump é uma ferramenta de sniffer de pacotes de linha de comando que permite capturar ou filtrar pacotes TCP/IP recebidos ou transferidos por uma rede.
  • Despertos heap
    Os despejo de heap são um snapshot da memória de um processo Java. Eles contêm as informações sobre os objetos e classes Java no heap no momento em que o despejo de heap é coletado.
  • D espejos de linhas de execução
    Um despejo de linhas de execução é um resumo 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, conhecido como rastreamento de pilha.