解決 Voice Gateway 中的一般問題
提示:您可以使用 Voice Gateway 系統訊息資訊,以協助解決錯誤和警告訊息。每一則訊息都包含問題的說明,以及所能採取之任何動作的詳細資料。
- 通話失敗:通話可能失敗的原因有很多,包括其中一項 Watson 服務配置錯誤、IP 遞送問題、防火牆問題等等。
- 首先,請檢查並確定 SIP Orchestrator 和 Media Relay 儲存器都在執行,且 Watson 服務配置適當。
- 接著,查看 SIP Orchestrator 日誌,看看起始通話的 SIP INVITE 訊息是否正在呼叫到儲存器。若是,請遵循追蹤中的通話流程到達錯誤的發生點,這正是將 SIP 錯誤回應傳回給發話端之處。
- 如果 SIP INVITE 還沒有呼叫到 Voice Gateway(亦即,沒有出現在日誌中),則您的防火牆可能封鎖了 SIP 埠 (5060),或是 SIP 幹線可能未適當配置成遞送至 SIP Orchestrator 儲存器的正確 IP 位址。
- 我能聽到 Watson,但是 Watson 卻聽不到我:此問題幾乎都是防火牆問題,或是您正在使用的 SIP 幹線或 SIP 用戶端出問題。由於音訊媒體可能流經很大的埠範圍,有可能您的防火牆沒有配置成經由所配置的埠串流來接收媒體。請檢查 Media Relay 的配置,以瞭解媒體埠的範圍,並確定您的防火牆已配置成容納該埠範圍。如果您嘗試使用 SIP 用戶端來與閘道連接,也請檢查是否發生埠衝突。
- 從發話端發問到 Watson 服務答覆延遲很久:此問題很有可能是其中一項 Watson 服務所造成的延遲。您可以查看審核日誌,判斷是哪一項服務行為異常。
- 通話轉接失敗:Voice Gateway 支援通話轉接,但是它們需要一個瞭解 SIP REFER 訊息的實體留在通話路徑中,並利用 Watson 在通話的整個生命週期中為該通話設定錨點,例如,階段作業邊界控制器 (SBC)。如果您想支援通話轉接,就需要使用支援 SIP REFER 訊息的 SIP 幹線供應商(例如 Twilio),或提供您自己可處理 SIP REFER 訊息的通話錨點。
- 我收到 CWSMR0050E 或 CWSMR0048E 錯誤,指出因
非預期的伺服器回應 (401)錯誤導致連線關閉:因不接受認證,Voice Gateway 可能無法聯絡指定的 Watson 服務。請驗證 Watson 服務的認證已配置正確。如需如何找到 Watson 服務認證的相關資訊,請參閱 Watson 說明文件中的 Watson 服務的服務認證。 - 我在通話中遇到多次 vgwPostResponseTimeout 或高度延遲:啟用 RTCP 網路報告有助於指出逾時或延遲的原因是 VoIP 問題或語音辨識問題。如果已啟用 RTCP 網路報告,則會列印警告;例如:
CWSMR0035W: 入埠 RTP 音訊串流封包流失率為百分之九,超出封包流失臨界值上限(百分之五)。
-
CWSMR0048E 錯誤訊息指出,因憑證鏈中的自簽憑證發生錯誤,Watson Speech to Text 服務已關閉:問題可能是基礎架構中的防火牆有問題。防火牆可能攔截要求,並將它放在自己的憑證中。由於部署不信任該憑證,因而發生自簽憑證錯誤。
如果要檢查是否發生此情況,請完成下列步驟:
-
從 IBM Voice Gateway 執行所在的 VM,發出 curl 指令給 Watson 服務。請使用下列範例指令:
curl --insecure -v https://<Watson Speech-To-Text endpoint hostname>/speech-to-text 2>&1將指令中的
https://<Watson Speech-To-Text endpoint hostname>文字,替換成您 Watson Speech to Text 實例的 URL,例如https://stream.watsonplatform.net/speech-to-text/apiURL。 -
在輸出中搜尋具有
Server Certificate的區段。如果輸出中的文字不符合下列文字,表示防火牆攔截了連線:* Server certificate: * subject: C=US; ST=New York; L=Armonk; O=INTERNATIONAL BUSINESS MACHINES CORPORATION; CN=*.watsonplatform.net * start date: Jan 9 00:00:00 2018 GMT * expire date: Mar 9 12:00:00 2020 GMT * issuer: C=US; O=DigiCert Inc; OU=www.digicert.com; CN=GeoTrust RSA CA 2018 * SSL certificate verify ok.
您也許可以採取下列其中一種作法來解決問題:
- 聯絡您的防火牆管理者,將該主機名稱列入白名單,好讓防火牆不會攔截該憑證。
- 將 Voice Gateway 配置成信任防火牆所交換的憑證。如需相關資訊,請參閱配置 SSL 和 TLS 加密。
-