503 服務無法使用

追蹤工具

如何使用追蹤工具找出要求失敗的訊息 ID：

1. 如果問題仍未解決，請為受影響的 API 啟用追蹤工作階段。
2. 發出 API 呼叫並重現問題 - 503 Service 無法使用 (錯誤代碼：messaging.adaptors.http.flow.ServiceUnavailable.)
3. 請選取其中一個失敗的要求。
4. 前往「AX 階段」，然後在「階段詳細資料」部分中向下捲動，找出要求的郵件 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. 如果 X-Apigee-fault-code message.adaptors.http.flow.ServiceUnavailable 有任何 503 錯誤， 記下一或多個這類要求的郵件 ID，如以下範例所示：

   顯示 503 錯誤的範例項目

   

追蹤工具

如何使用追蹤工具診斷：

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

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

   
6. 如果 error.cause 顯示「無法連線至主機」，表示發生錯誤的可能原因如下：
   • 目標伺服器/目標端點設定中指定的主機名稱不正確，或是含有不需要的空格或特殊字元。
     
     例如，主機名稱包含多餘空間，如下所示：
     

     "demo-target.apigee.net "
                       

   • API Proxy 中由 target.url 變數覆寫的主機名稱 (使用 AssignMessage 或 JavaScript 政策不正確，或是含有空格或任何其他不需要的特殊字元。
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. 如果看到下列警告/錯誤訊息，表示「訊息處理者」無法解析主機名稱。該郵件會延後，因此您可能不會看到 警告訊息。

   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 policy)。
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 錯誤 發生在目標要求流程期間發生，或是由後端伺服器傳送時，問題是 southbound (在訊息處理器與後端之間) 伺服器)。
3. 如果您沒有取得特定 API 呼叫的追蹤記錄，則表示問題發生 northbound：用戶端應用程式與路由器之間。

API 監控

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

逐步完成範例情境，示範如何使用 API Monitoring 排解 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 錯誤，則 southbound 連線 (訊息處理器與 用戶端存取資源)。
4. 如果不是，則問題發生在北行連線 (介於 用戶端應用程式和路由器)。