Riferimento per i messaggi di errore

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. info

Questa pagina contiene link ai playbook per la risoluzione dei problemi relativi a errori e altri problemi che potresti riscontrare quando utilizzi Apigee Edge. Ogni playbook per la risoluzione dei problemi spiega come diagnosticare e risolvere ciascun tipo di problema.

Problemi di Analytics

Questi argomenti spiegano come risolvere i problemi relativi alla mancata visualizzazione dei dati di analisi nelle dashboard di Analytics o nei report personalizzati.

Messaggio o descrizione di errore Playbook
The report timed out: Try again with a smaller date range or a larger aggregation interval.

I report di Analytics hanno superato il tempo di attesa

Oppure:

Il report ha superato il tempo di attesa
Potresti non visualizzare alcun messaggio di errore, a meno che lo spazio su disco non sia completamente occupato sul server Postgres. Spazio su disco esaurito sul server Postgres
Non sono stati rilevati errori. Variabile personalizzata non visibile ai report personalizzati di Analytics
No traffic in the selected date range Dati non visualizzati nelle dashboard di analisi
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 ax

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 di deployment.
Messaggio o descrizione di errore Playbook
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 di accesso al datastore
Configuration failed, associated contexts = [] Configurazione non riuscita
Unexpected error occurred while processing the updates, associated contexts = [] Aggiornamenti relativi all'elaborazione degli errori

Errori del Portale per gli sviluppatori

Questi argomenti forniscono assistenza per i problemi che potresti riscontrare durante l'utilizzo del portale per gli sviluppatori. Prima di tentare di risolvere i problemi del portale per gli sviluppatori, assicurati di avere una conoscenza di base del funzionamento del portale, come spiegato nella Panoramica della risoluzione dei problemi del portale per gli sviluppatori.
Messaggio o descrizione di errore Playbook
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. OPPURE There was an error trying to create the App. Please try again later. Problemi di comunicazione del Portale per gli sviluppatori

Problemi di monetizzazione

Gli argomenti riportati di seguito ti aiuteranno a risolvere i problemi comuni relativi alla monetizzazione.

Messaggio o descrizione di errore Playbook 
<error>
   <messages>
        <message>Exceeded developer limit configuration -</message>
        <message>Is Developer Suspended - true</message>
   </messages>
</error>
Account sviluppatore sospeso
Potresti non visualizzare alcun messaggio di errore, ma noterai i problemi descritti nella sezione Sintomo in Problemi di configurazione della monetizzazione. Problemi di configurazione della monetizzazione

Problemi con il router edge

Il router edge è implementato con NGINX. Durante la procedura di upgrade di Edge o quando modifichi la configurazione del router, potresti visualizzare errori di configurazione di NGINX. L'argomento seguente ti aiuterà a risolvere questi problemi.

Messaggio o descrizione di errore Playbook
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 relativi a OpenLDAP

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

Messaggio o descrizione di errore Playbook
Unknown username and password combination. SMTP è disabilitato 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 si 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 di runtime più comuni.

Messaggio o descrizione di errore Playbook
HTTP/1.1 500 Internal Server Error OPPURE 
{
   "fault":{
      "detail":{
         "errorcode":"steps.servicecallout.ExecutionFailed"
      },
      "faultstring":"Execution of ServiceCallout callWCSAuthServiceCallout failed.
        Reason: ResponseCode 400 is treated as error"
   }
}
500 Errore interno del server
HTTP/1.1 502 Bad Gateway OPPURE 
{
   "fault": {
      "faultstring": "Unexpected EOF at target",
      "detail": {
           "errorcode": "messaging.adaptors.http.UnexpectedEOFAtTarget"
       }
    }
}
502 Gateway non valido
HTTP/1.1 503 Service Unavailable OPPURE HTTP/1.1 503 Service Unavailable: Back-end server is at capacity OPPURE 
{
   "fault": {
      "faultstring": "The Service is temporarily unavailable",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.ServiceUnavailable"
       }
    }
}
503 Servizio non disponibile
HTTP/1.1 503 Service Unavailable OPPURE Received fatal alert: handshake_failure Errori di handshake SSL
HTTP/1.1 503 Service Unavailable OPPURE 
{
 "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 OPPURE 
{
   "fault": {
      "faultstring": "Gateway Timeout",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.GatewayTimeout"
       }
    }
}
Timeout del gateway (504)

Problemi di Zookeeper

I seguenti argomenti ti aiuteranno a risolvere i problemi comuni di Zookeeper.
Messaggio o descrizione di errore 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

OPPURE

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

OPPURE

L'interfaccia utente di Edge potrebbe mostrare questo errore:

Error Fetching Deployments Error while checking path existence for path: path 		Errori di perdita di connessione di Zookeeper
I problemi relativi ai dati, comunemente indicati come problemi di cablaggio, possono manifestarsi come uno di diversi problemi. Per maggiori dettagli, consulta 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 determinati tipi di problemi che potresti riscontrare durante l'utilizzo di Apigee Edge.

  • Utilità di analisi pacchetto TCP/IP (tcpdump)
    Lo strumento tcpdump è uno strumento di analisi pacchetto a 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 uno snapshot della memoria di un processo Java. Contengono le informazioni sugli oggetti e sulle classi Java nell'heap al momento del recupero del dump dell'heap.
  • Dump dei thread
    Un dump del thread è uno snapshot dello stato di tutti i thread di un processo Java in esecuzione. Lo stato di ciascun thread viene presentato con i contenuti del relativo stack, noto come traccia dello stack.