503 服務無法使用

追蹤工具

如要使用追蹤工具判斷失敗要求的訊息 ID，請按照下列步驟操作：

1. 如果問題仍未解決，請為受影響的 API 啟用追蹤工作階段。
2. 發出 API 呼叫並重現問題 - 503 Service Unavailable，錯誤代碼為 messaging.adaptors.http.flow.ServiceUnavailable.
3. 選取其中一個失敗的要求。
4. 前往 AX 階段，然後在「Phase Details」(階段詳細資料) 區段中向下捲動，找出要求的訊息 ID (X-Apigee.Message-ID)，如下圖所示。

   

NGINX 存取記錄

如要使用 NGINX 存取記錄判斷失敗要求的訊息 ID，請按照下列步驟操作：

您也可以參閱 NGINX 存取記錄，判斷 503 錯誤的訊息 ID。 如果問題過去曾發生，或是問題間歇性出現，且您無法在 UI 中擷取追蹤記錄，這個方法就特別實用。請按照下列步驟，從 NGINX 存取記錄檔判斷這項資訊：

1. 檢查 NGINX 存取記錄：(/opt/apigee/var/log/edge-router/nginx/ <org>~ <env>.<port#>_access_log)
2. 在特定時間內，搜尋特定 API Proxy 是否有任何 503 錯誤 (如果問題發生在過去)，或是否有任何要求仍因 503 錯誤而失敗。
3. 如果出現任何 503 錯誤，並顯示 X-Apigee-fault-code messaging.adaptors.http.flow.ServiceUnavailable，請記下其中一或多個要求的訊息 ID，如下例所示：

   顯示 503 錯誤的範例項目

   

追蹤工具

如要使用「追蹤」工具進行診斷，請按照下列步驟操作：

1. 如果問題仍未解決，請為受影響的 API 啟用追蹤工作階段。
2. 發出 API 呼叫並重現問題 - 503 Service Unavailable，錯誤代碼為 messaging.adaptors.http.flow.ServiceUnavailable.
3. 選取其中一個失敗的要求。
4. 瀏覽追蹤記錄的各個階段，找出發生失敗的位置。
5. 選取發生錯誤的 FlowInfo。您可以在 error.cause 欄位中找到更多資訊，瞭解失敗原因，如下例所示：

   顯示追蹤記錄中 error.cause 的要求範例

   
6. 如果發現 error.cause 顯示「Host not reachable」(主機無法連線)，則錯誤的可能原因如下：
   • 目標伺服器/目標端點設定中指定的主機名稱不正確，或含有不必要的空格或特殊字元。
     
     舉例來說，主機名稱中含有不必要的空格，如下所示：
     

     "demo-target.apigee.net "
                       

   • API Proxy 中使用 AssignMessage 或 JavaScript 政策，以 target.url 變數覆寫的主機名稱不正確，或含有空格或其他不必要的特殊字元。
7. 檢查目標端點設定和/或目標伺服器定義，確認目標伺服器主機名稱是否正確，以及是否含有任何不必要的空格或特殊字元。
8. 如果目標伺服器主機是動態建立，請檢查用於建立該主機的適當政策 (例如 AssignMessage/JavaScript 政策)。檢查目標伺服器主機名稱是否不正確，或含有任何多餘的空格或特殊字元。
9. 判斷目標伺服器主機名稱後，請對主機名稱執行 nslookup/dig 指令，確認是否可以解析。

   舉例來說，在含有不必要空格的主機名稱上執行 nslookup 指令，會傳回下列輸出內容：

   nslookup "demo-target.apigee.net "
   Server:	49.205.75.2
   Address:	49.205.75.2#53
   
   ** server can't find demo-target.apigee.net\032: NXDOMAIN

10. 如果作業系統指令 nslookup 也無法解析主機名稱，則問題原因為目標伺服器使用的主機名稱不正確。

    請參閱「解決方法」。

訊息處理器記錄

如要使用訊息處理器記錄進行診斷，請按照下列步驟操作：

1. 找出失敗要求的訊息 ID。
2. 在訊息處理器記錄中搜尋郵件 ID。(/opt/apigee/var/log/edge-message-processor/logs/system.log)
3. 如果看到下列警告/錯誤訊息，表示訊息處理器無法解析主機名稱。由於訊息會暫緩處理，您可能不會看到所有訊息 ID/要求的這則警告訊息。

   org:myorg env:prod api:TestTargetServer rev:2 messageid:<messageid>  NIOThread@0 WARN S.HTTPCLIENTSERVICE - DNSCache$2.failed() : Failed to resolve hostname www.somehost.com . Reason mocktarget.apigee.net : Name or service not known. This log message will snooze for 2 hours
       

4. 接著會顯示警告訊息，指出訊息處理器已從 DNS 快取中移除地址，因為無法連上目標伺服器主機。

   org:myorg env:prod api:TestTargetServer rev:2 messageid:<messageid> NIOThread@0 WARN  c.a.p.h.d.DNSCachedAddress - DNSCachedAddress.addressNotReachable() : The last address has been removed from Address list null refreshing
       

5. 然後您可能會看到訊息處理器因「主機無法連線」例外狀況而失敗的訊息。有時錯誤訊息會顯示主機名稱：

   org:myorg env:prod api:TestTargetServer rev:2 messageid:<messageid>  NIOThread@0 ERROR HTTP.CLIENT - HTTPClient$Context.onConnectFailure() :  connect to demo-target.apigee.net  failed with exception {}
   java.lang.RuntimeException: Host not reachable
   	at com.apigee.protocol.http.HTTPClient$Context.initConnect(HTTPClient.java:704)
   	at com.apigee.protocol.http.HTTPClient$Context.send(HTTPClient.java:675)
   	at com.apigee.messaging.adaptors.http.flow.data.TargetRequestSender.sendRequest(TargetRequestSender.java:234)
   	…<snipped>
       

6. 有時，主機名稱無法解析或無法連線，因此可能會顯示為「null」，如下所示：

   org:myorg env:prod api:TestTargetServer rev:2 messageid:<messageid>  NIOThread@0 ERROR HTTP.CLIENT - HTTPClient$Context.onConnectFailure() :  connect to null failed with exception {}
   java.lang.RuntimeException: Host not reachable
   	at com.apigee.protocol.http.HTTPClient$Context.initConnect(HTTPClient.java:704)
   	at com.apigee.protocol.http.HTTPClient$Context.send(HTTPClient.java:675)
   	at com.apigee.messaging.adaptors.http.flow.data.TargetRequestSender.sendRequest(TargetRequestSender.java:234)
   	…<snipped>
       

7. Host not reachable 錯誤通常會在下列情況發生：
   • 目標伺服器/目標端點設定中指定的主機名稱不正確，或含有不必要的空格或特殊字元。
     
     舉例來說，下列錯誤訊息中的主機名稱「demo-target.apigee.net 」含有多餘的空格：

     NIOThread@0 ERROR HTTP.CLIENT - HTTPClient$Context.onConnectFailure() :  connect to demo-target.apigee.net  failed with exception
             

   • API Proxy 中使用 AssignMessage 或 JavaScript 政策，以 target.url 變數覆寫的主機名稱不正確，或含有空格或其他不必要的特殊字元。
8. 使用下列其中一種方式，判斷訊息處理器嘗試通訊的目標伺服器主機名稱：
1. 請仔細檢查包含 Host not reachable 的錯誤訊息。
2. 如果錯誤訊息顯示主機名稱，請複製主機名稱，包括任何空格或特殊字元。
3. 如果錯誤訊息顯示主機名稱為 null，如下所示：

   org:myorg env:prod api:TestTargetServer rev:2 messageid:<messageid>  NIOThread@0 ERROR HTTP.CLIENT - HTTPClient$Context.onConnectFailure() :  connect to null failed with exception {}
           

1. 檢查失敗的 API Proxy 中使用的目標伺服器定義，判斷主機名稱。
2. 如果目標伺服器主機是動態建立，請檢查用於建立該主機的適當政策 (例如 AssignMessage/JavaScript 政策)。
9. 判斷目標伺服器主機名稱後，請對主機名稱執行 nslookup/dig 指令，並檢查是否可以解析。

   舉例來說，在含有空格的主機名稱上執行 nslookup 指令

   nslookup "demo-target.apigee.net "
   Server:	49.205.75.2
   Address:	49.205.75.2#53
   
   ** server can't find demo-target.apigee.net\032: NXDOMAIN
         

10. 如果作業系統指令 nslookup 也無法解析主機名稱，則問題原因為目標伺服器使用的名稱不正確。

UI 追蹤記錄

如要使用 UI 追蹤功能判斷發生錯誤的位置，請按照下列步驟操作：

1. 如果問題仍未解決，請為受影響的 API 啟用 UI 追蹤。
2. 如果失敗的 API 要求 UI 追蹤記錄顯示，503 Service Unavailable 錯誤發生在目標要求流程中，或是由後端伺服器傳送，則問題是南向 (也就是訊息處理器和後端伺服器之間)。
3. 如果沒有特定 API 呼叫的追蹤記錄，問題就出在北向，也就是用戶端應用程式和路由器之間。

API 監控

API 監控功能可協助您快速找出問題領域，診斷錯誤、效能和延遲問題及其來源，例如開發人員應用程式、API Proxy、後端目標或 API 平台。

逐步瞭解範例情境，瞭解如何使用 API 監控功能排解 API 的 5xx 問題。 舉例來說，您可能會想設定快訊，在messaging.adaptors.http.flow.ServiceUnavailable故障次數超過特定門檻時收到通知。

NGINX 存取記錄

如要使用 UI 追蹤功能判斷發生錯誤的位置，請按照下列步驟操作：

如果過去曾發生問題，或問題是間歇性的，且您無法擷取追蹤記錄，請執行下列步驟：

1. 檢查 NGINX 存取記錄 (/opt/apigee/var/log/edge-router/nginx/ org-env.port_access_log)。
2. 搜尋特定 API Proxy 是否有任何 503 錯誤。
3. 如果發現特定 API 在特定時間發生 503 錯誤，則問題出在南向連線 (訊息處理器與後端伺服器之間)。
4. 如果不是，問題就出在北向連線 (用戶端應用程式和路由器之間)。