503 Servizio non disponibile - Server di backend

Strumento di traccia

1. Attiva la sessione di traccia, ed effettua la chiamata API per riprodurre il problema: 503 Service Unavailable.
2. Seleziona una delle richieste non riuscite ed esamina la traccia.
3. Esamina le varie fasi della traccia e individua il punto in cui si è verificato l'errore.
4. Se riscontri che l'errore 503 viene restituito come risposta dal server di destinazione, la causa dell'errore 503 è il server di destinazione.

   Ecco uno screenshot di esempio della traccia che mostra la risposta 503 Service Unavailable ricevuta dal server di destinazione:

   
5. Fai clic sulla fase Risposta ricevuta dal server di destinazione ed esamina le sezioni Intestazioni della risposta e Contenuto della risposta per verificare se contengono informazioni utili:
   • Le intestazioni della risposta potrebbero contenere l'intestazione Server, che indica da dove è stata inviata la risposta di errore.
   • Il contenuto della risposta potrebbe contenere ulteriori informazioni sul motivo per cui il server di destinazione ha inviato il codice di risposta 503.
   
6. Verifica che l'errore 503 provenga dal server di destinazione controllando i valori di X-Apigee-fault-source e X-Apigee-fault-code nella fase AX (Dati di analisi registrati) della traccia utilizzando i passaggi riportati di seguito:
   1. Fai clic sulla fase AX (Dati di analisi registrati) come mostrato nello screenshot di seguito:
   2. Scorri verso il basso i dettagli della fase fino alla sezione Intestazioni della risposta e determina i valori di X-Apigee-fault-code e X-Apigee-fault-source come mostrato di seguito:
   3. Se i valori di X-Apigee-fault-source e X-Apigee-fault-code corrispondono ai valori mostrati nella tabella di seguito, puoi confermare che l'errore 503 proviene dal server di destinazione:

      Intestazioni della risposta	Valore
      X-Apigee-fault-source	destinazione
      X-Apigee-fault-code	messaging.adaptors.http.flow.ErrorResponseCode

7. Verifica se utilizzi l'incatenamento dei proxy, ovvero se il server di destinazione/endpoint di destinazione richiama un altro proxy in Apigee. Per determinarlo:
   1. Torna alla fase Richiesta inviata al server di destinazione e fai clic sul pulsante Mostra curl e determina l'alias host del server di destinazione.
   2. Se l'alias host del server di destinazione rimanda a un alias host virtuale, si tratta di un incatenamento dei proxy. In questo caso, devi ripetere tutti i passaggi precedenti per il proxy concatenato finché non determini la causa effettiva dell'errore 503 Service Unavailable. In questi casi, l'errore 503 Service Unavailable può verificarsi anche in altri proxy concatenati in altre fasi, che possono essere diagnosticati utilizzando questa guida.
   3. Se l'alias host del server di destinazione rimanda al server di backend, vai alla sezione Risoluzione.

Log degli accessi NGINX

Puoi anche fare riferimento ai log degli accessi NGINX per determinare se il codice di stato 503 è stato inviato dal server di backend. Questa operazione è particolarmente utile se il problema si è verificato in passato o se è intermittente e non riesci ad acquisire la traccia nell'interfaccia utente. Segui questi passaggi per determinare queste informazioni dai log degli accessi NGINX:

1. Controlla i log degli accessi NGINX.

   /opt/apigee/var/log/edge-router/nginx/<org>~<env>.<port#>_access_log

2. Cerca eventuali errori 503 per il proxy API specifico durante un periodo di tempo specifico (se il problema si è verificato in passato) o per eventuali richieste che non vanno a buon fine con l'errore 503.
3. Se sono presenti errori 503, controlla se l'errore proviene dal server di backend. Se i valori di X-Apigee-fault-source e X-Apigee-fault-code corrispondono ai valori mostrati nella tabella di seguito, l'errore 503 proviene dal server di backend:

   Intestazioni della risposta	Valore
   X-Apigee-fault-source	destinazione
   X-Apigee-fault-code	messaging.adaptors.http.flow.ErrorResponseCode

   Ecco una voce di esempio che mostra l'errore 503 causato dal server di destinazione:

   
4. Esamina il proxy API specifico e assicurati di utilizzare l'incatenamento dei proxy ovvero se il server di destinazione/endpoint di destinazione non richiama un altro proxy in Apigee. Se utilizzi l'incatenamento dei proxy, devi ripetere tutti i passaggi precedenti per il proxy concatenato finché non determini la causa effettiva dell'errore 503 Service Unavailable. In questi casi, l'errore 503 Service Unavailable può verificarsi anche in altri proxy concatenati in altre fasi, che possono essere diagnosticati utilizzando questa guida.
5. Se confermi di non utilizzare l'incatenamento dei proxy e l'errore 503 proviene dal tuo server di backend, vai alla sezione Risoluzione.

Chiamata al server di backend

Puoi effettuare una chiamata diretta al server di backend e verificare di ricevere la stessa 503 Service Unavailable risposta ricevuta quando la richiesta è stata effettuata tramite Apigee Edge.

1. Assicurati di avere tutte le intestazioni, i parametri di query e le credenziali necessarie che devono essere passate al server di backend come parte della richiesta.
2. Se il servizio di backend è accessibile pubblicamente, puoi utilizzare il comando curl, Postman o qualsiasi altro client REST e richiamare direttamente l'API del server di backend.
3. Se il server di backend è accessibile solo dai processori di messaggi, puoi utilizzare il comando curl, Postman o qualsiasi altro client REST e richiamare direttamente l'API del server di backend dal processore di messaggi.
4. Verifica che il servizio di backend restituisca effettivamente l'errore 503 Service Unavailable.