Riferimento per i messaggi di errore

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X. info

Questa pagina contiene link a guide pratiche per la risoluzione dei problemi relativi a errori e altri problemi che potresti riscontrare durante l'utilizzo di Apigee Edge. Ogni guida pratica per la risoluzione dei problemi spiega come diagnosticare e risolvere ogni tipo di problema.

Problemi di Analytics

Questi argomenti spiegano come risolvere i casi in cui i dati di analisi non vengono visualizzati nelle dashboard di Analytics o nei report personalizzati.

Messaggio o descrizione dell'errore Guida pratica
The report timed out: Try again with a smaller date range or a larger aggregation interval.

Timeout dei report di Analytics

Oppure:

Report timed out
Potresti non visualizzare alcun messaggio di errore a meno che lo spazio su disco non sia completamente pieno sul server Postgres. Il server Postgres sta esaurendo lo spazio su disco
Non vengono rilevati errori. Variabile personalizzata non visibile ai report personalizzati di Analytics
No traffic in the selected date range I dati non vengono visualizzati nelle dashboard di Analytics
L'argomento spiega come eseguire un'attività richiesta di frequente. Aggiungere ed eliminare componenti di analisi nei gruppi di analisi
Could not get data for path Le dimensioni personalizzate non vengono visualizzate quando sono stati configurati più gruppi di analisi

Errori di deployment

Il deployment dei proxy API potrebbe non riuscire per vari motivi, ad esempio problemi di connettività di rete tra i server Edge, problemi con il datastore Cassandra, eccezioni ZooKeeper ed errori nel bundle del proxy API. Questa sezione fornisce informazioni e indicazioni su alcune procedure specifiche che possono essere seguite per la risoluzione dei problemi relativi agli errori di deployment.
Messaggio o descrizione dell'errore Guida pratica
Error: Call timed out; either server is down or server is not reachable Errore di timeout
Unexpected error Error while fetching children for path Errore durante il recupero dei figli per il percorso
Error while accessing datastore;Please retry later Errore durante l'accesso al datastore
Configuration failed, associated contexts = [] Configurazione non riuscita
Unexpected error occurred while processing the updates, associated contexts = [] Errore durante l'elaborazione degli aggiornamenti

Errori del Portale per gli sviluppatori

Questi argomenti ti aiutano a risolvere i problemi che potresti riscontrare durante l'utilizzo del portale per sviluppatori. Prima di tentare di risolvere i problemi del portale per sviluppatori, assicurati di avere una conoscenza di base del funzionamento del portale per sviluppatori, come spiegato in Panoramica della risoluzione dei problemi del portale per sviluppatori.
Messaggio o descrizione dell'errore Guida pratica
An internal error has occurred. Please retry your request. Errore interno del Portale per gli sviluppatori
The website encountered an unexpected error. Please try again later. OR There was an error trying to create the App. Please try again later. Problemi di comunicazione del Portale per gli sviluppatori

Problemi di monetizzazione

I seguenti argomenti ti aiuteranno a risolvere i problemi comuni di monetizzazione.

Messaggio o descrizione dell'errore Guida pratica 
<error>
   <messages>
        <message>Exceeded developer limit configuration -</message>
        <message>Is Developer Suspended - true</message>
   </messages>
</error>
Sviluppatore sospeso
Potresti non visualizzare alcun messaggio di errore, ma vedrai i problemi come spiegato nella sezione Sintomi in Problemi di configurazione della monetizzazione. Problemi di configurazione della monetizzazione

Problemi del router Edge

Il router Edge viene implementato con NGINX. Durante il processo di upgrade di Edge o quando modifichi la configurazione del router, potresti visualizzare errori di configurazione di NGINX. Il seguente argomento ti aiuterà a risolvere questi problemi.

Messaggio o descrizione dell'errore Guida pratica
Non visualizzerai alcun messaggio di errore. Tuttavia, potresti non essere in grado di eseguire i proxy API a causa dei file di configurazione errati. File di configurazione errati
429 Too Many Requests: Tuning Nginx Router connection limits 429 Too Many Requests

Problemi di OpenLDAP

I seguenti argomenti ti aiuteranno a risolvere i problemi comuni di OpenLDAP.

Messaggio o descrizione dell'errore Guida pratica
Unknown username and password combination. SMTP è disattivato e gli utenti devono reimpostare la password
Non vengono visualizzati errori, l'interfaccia utente di Edge non mostra semplicemente l'elenco degli utenti che avrebbero dovuto essere replicati su tutti i server OpenLDAP. LDAP non esegue la replica.
SLAPD Dead But Pid File Exists Impossibile avviare OpenLDAP
Unknown username and password combination. Corruzione dei dati di OpenLDAP

Errori di runtime

I seguenti argomenti ti aiuteranno a risolvere i problemi comuni di runtime.

Messaggio o descrizione dell'errore Guida pratica
HTTP/1.1 500 Internal Server Error 
{
   "fault":{
      "detail":{
         "errorcode":"steps.servicecallout.ExecutionFailed"
      },
      "faultstring":"Execution of ServiceCallout callWCSAuthServiceCallout failed.
        Reason: ResponseCode 400 is treated as error"
   }
}
500 Internal Server Error
HTTP/1.1 502 Bad Gateway 
{
   "fault": {
      "faultstring": "Unexpected EOF at target",
      "detail": {
           "errorcode": "messaging.adaptors.http.UnexpectedEOFAtTarget"
       }
    }
}
502 Bad Gateway
HTTP/1.1 503 Service Unavailable OR HTTP/1.1 503 Service Unavailable: Back-end server is at capacity OR 
{
   "fault": {
      "faultstring": "The Service is temporarily unavailable",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.ServiceUnavailable"
       }
    }
}
503 Service Unavailable
HTTP/1.1 503 Service Unavailable OR Received fatal alert: handshake_failure Errori di handshake SSL
HTTP/1.1 503 Service Unavailable 
{
 "fault": {
    "faultstring":"The Service is temporarily unavailable",
    "detail":{
        "errorcode":"messaging.adaptors.http.flow.ServiceUnavailable"
    }
 }
}
Errori di handshake SSL - Certificato client non valido
HTTP/1.1 504 Gateway Timeout 
{
   "fault": {
      "faultstring": "Gateway Timeout",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.GatewayTimeout"
       }
    }
}
504 Gateway Timeout

Problemi di Zookeeper

I seguenti argomenti ti aiuteranno a risolvere i problemi comuni di Zookeeper.
Messaggio o descrizione dell'errore Guida pratica
org: env: main ERROR ZOOKEEPER - ZooKeeperServiceImpl.exists() : Could not detect existence of path: /regions/dc-1/pods/analytics/servers/abc123/reachable , reason: KeeperErrorCode = ConnectionLoss

OR

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

OR

L'interfaccia utente di Edge potrebbe visualizzare questo errore:

Error Fetching Deployments Error while checking path existence for path: path 		Zookeeper Errori di perdita di connessione
I problemi relativi ai dati, comunemente definiti problemi di cablaggio, possono manifestarsi in uno dei diversi modi. Per maggiori dettagli, vedi Problemi relativi ai dati di Zookeeper. Problemi relativi ai dati di Zookeeper
+ apigee-service apigee-zookeeper status apigee-service: apigee-zookeeper: Not running (DEAD) apigee-all: Error: status failed on [apigee-zookeeper] Impossibile avviare Zookeeper

Strumenti di diagnostica e log

Questi argomenti descrivono gli strumenti e i log che puoi utilizzare per diagnosticare alcuni tipi di problemi che potresti riscontrare durante l'utilizzo di Apigee Edge.

  • Utilità di analisi dei pacchetti TCP/IP (tcpdump)
    Lo strumento tcpdump è uno strumento di analisi dei pacchetti da riga di comando che consente di acquisire o filtrare i pacchetti TCP/IP ricevuti o trasferiti su una rete.
  • Dump dell'heap
    I dump dell'heap sono un'istantanea della memoria di un processo Java. Contengono le informazioni su gli oggetti e sulle classi Java nell'heap al momento della raccolta del dump dell'heap.
  • Dump dei thread
    Un dump dei thread è un'istantanea dello stato di tutti i thread di un processo Java in esecuzione. Lo stato di ogni thread viene presentato con i contenuti del relativo stack, denominato stack trace.