透過合作解決方案分析器排除CUBE故障

下載選項

  • PDF     (3.4 MB)
    在多種裝置上使用 Adobe Reader 檢視
已更新: 2024 年 8 月 24 日
文件 ID:222316

無偏見用語

本產品的文件集力求使用無偏見用語。針對本文件集的目的，無偏見係定義為未根據年齡、身心障礙、性別、種族身分、民族身分、性別傾向、社會經濟地位及交織性表示歧視的用語。由於本產品軟體使用者介面中硬式編碼的語言、根據 RFP 文件使用的語言，或引用第三方產品的語言，因此本文件中可能會出現例外狀況。深入瞭解思科如何使用包容性用語。

關於此翻譯

思科已使用電腦和人工技術翻譯本文件，讓全世界的使用者能夠以自己的語言理解支援內容。請注意，即使是最佳機器翻譯，也不如專業譯者翻譯的內容準確。Cisco Systems, Inc. 對這些翻譯的準確度概不負責，並建議一律查看原始英文文件（提供連結）。

    簡介

    本文檔介紹使用合作解決方案分析器門戶對CUBE進行故障排除的日誌分析器和SIP配置檔案測試器工具。

    需求

    思科建議您瞭解以下主題：

    • Cisco Unified Border Element (CUBE) Enterprise。
    • 作業階段啟始通訊協定(SIP)。
    • CUBE日誌收集（調試）。

    快速入門

    Collaboration Solutions Analyzer (CSA)是一套工具，用於在合作解決方案的整個生命週期中為其提供支援。它可以幫助確定問題並在需要時提供糾正行動計畫，幫助合作解決方案的每個階段。

    導航到合作解決方案分析器，網址為https://cway.cisco.com/csa-new/#/home

    附註：使用Chrome瀏覽器可確保工具以最佳方式運作。

    考量

    這些工具專為處理SIP到SIP呼叫的CUBE裝置設計。工具不支援任何其他語音協定。

    日誌分析器使用CUBE日誌（基於SIP消息調試）進行分析。

    如果您需要其他語音協定的幫助，請利用https://supportassistant.cisco.com上的Cisco Support Assistant進行TAC預訂

    平台描述

    CSA平台提供以下CUBE工具：

    • 日誌分析器 -從CUBE和其他合作裝置上傳日誌，以自動檢測、故障排除和解決問題。
    • SIP配置檔案測試器 -驗證SIP配置檔案配置。

    CSA HomeCSA首頁


    日誌分析器

    管理員可以透過日誌分析器工具檢查CUBE裝置所處理的呼叫信令。它提供對日誌檔案的全面分析，包括：

    • 呼叫段資訊
    • 梯形圖
    • 訊號

    注意：必須先收集已由CUBE處理的呼叫的CUBE調試(調試ccsip消息)並將其儲存在文本檔案中。此文本檔案中只能包含SIP調試以及其他輸出（例如show命令）。

    上傳CUBE記錄檔

    導航到合作解決方案分析器，網址為https://cway.cisco.com/csa-new/#/home

    然後，透過按一下Log Analyzer部分中的Upload files選擇工具。

    Log Analyzer Home日誌分析器首頁

    平台會顯示工具熒幕，您可以在其中選取或拖曳檔案。

    Log Analyzer Upload記錄分析器上傳

    要完成上傳檔案以供工具分析的過程，請按一下Upload按鈕。

    Log Analyzer Upload File日誌分析器上傳檔案

    將檔案上載到工具後，選中相應的框以選擇要分析的檔案，然後按一下Run Analysis按鈕。

    • 系統將產品型別設定為CUBE。
    • 可在同一作業階段中分析多個檔案。

    Log Analyzer Product Type日誌分析器產品型別

    該工具分析在文本檔案中捕獲的所有信令呼叫，並顯示所辨識的呼叫段的摘要。然後您可以套用兩個篩選條件：

    • 搜尋- 按特定資料（如被叫號碼）過濾呼叫會話。
    • 按「斷開原因」搜尋- 根據呼叫斷開原因過濾呼叫會話。

    Log Analyzer Call Filter日誌分析器呼叫篩選器 

    要繼續詳細分析，請選擇您要關注的呼叫會話線路，工具將顯示完整分析，其中顯示呼叫段資訊、階梯圖和信令。

    呼叫段資訊

    第一階段顯示呼叫分支資訊，其中顯示呼叫的概述：

    • SIP呼叫段型別
    • 發件人 -從INVITE消息的SIP報頭獲取。
    • To -從INVITE消息的TO SIP報頭獲取。
    • 信令源 -源裝置的IP地址和埠。從INVITE消息的VIA SIP報頭獲取。
    • 信令目標 -目標裝置的IP地址和埠。從INVITE消息的URI SIP報頭獲取。
    • 呼叫ID -從INVITE消息的SIP呼叫ID報頭獲取。
    • 呼叫段連線- 呼叫會話時間戳。

    Log Analyzer Call Leg Info日誌分析器呼叫段資訊

    在此部分中，可以啟用Ladder標籤以突出顯示Ladder Diagram中的消息。應用程式有2個欄位：

    • ID -輸入您要反白的特定引數。
    • Description -增加引數的說明。

    按一下Add按鈕完成此過程。

    Log Analyzer Ladder Tags日誌分析器階梯標籤 

    梯形圖

    在第二階段，顯示梯形圖，直觀地描繪在呼叫期間交換的SIP消息。這些消息採用顏色編碼以便於辨識：

    • 藍色- SIP INVITE消息。
    • 綠色- SIP 200 OK和ACK消息。
    • 紅色- SIP BYE消息。

    要下載圖副本，請按一下Download Ladder按鈕。系統即會下載該圖，並將其另存為PNG影象檔案。請注意，此選項僅在使用Google Chrome瀏覽器時可用。

    Log Analyzer Ladder Diagram日誌分析器梯形圖

    此工具允許管理員打開SIP消息並檢視其內容。按一下訊息以開啟它。

    Log Analyzer Ladder Diagram Message日誌分析器梯形圖消息

    管理員可以在呼叫分支資訊部分增加階梯標籤以直觀顯示帶有獨特點標籤的SIP消息。SIP消息中包含的任何引數都可用於標籤。

    在本例中，ID引數使用IP地址並增加說明。包含IP地址的SIP消息以點標籤突出顯示，以便與其他消息區分開來。

    Log Analyzer Ladder Tags 1日誌分析器階梯標籤1

    Log Analyzer Ladder Tags 2日誌分析器階梯標籤2

    另一個可用來區分SIP消息和其他消息的過濾器是語音編解碼器。

    Log Analyzer Ladder Tags 3日誌分析器階梯標籤3

    Log Analyzer Ladder Tags 4日誌分析器階梯標籤4

    訊號

    最後階段是信令，它顯示CUBE段（傳入和傳出）的SIP消息。它包含源和目標IP地址。按一下以檢視訊息。

    Log Analyzer Signaling日誌分析器訊號

    Log Analyzer Signaling Message日誌分析器信令消息


    診斷

    從日誌分析的所有資料都以診斷特徵碼運行，這些特徵碼可辨識已知缺陷、常見問題或配置錯誤，並提供糾正行動計畫。

    選擇在日誌中捕獲的呼叫顯示呼叫摘要分析後，CSA平台將顯示診斷部分，其中包含以下資訊：

    • 發現的問題
    • 缺少資訊
    • 潛在問題

    可啟動切換按鈕以僅過濾和顯示缺陷。

    Log Analyzer Diagnostics Home日誌分析器診斷首頁

    Log Analyzer Diagnostics overviewLog Analyzer Diagnostics概述

    CUBE封包擷取

    資料包捕獲是一個檔案緩衝區，建立它的目的是在CUBE網路介面或任何語音網路裝置收集實際資料包的副本。網路分析器軟體(例如Wireshark)可以打開和分析此檔案。

    日誌分析器工具已透過資料包捕獲分析器進行了增強，該資料包捕獲分析器可以處理pcap或pcpng檔案格式副檔名，從而提供從呼叫處收集的會話和網路統計資訊的摘要。

    必須以與CUBE日誌檔案相同的方式將資料包捕獲檔案上傳到日誌分析器工具。系統將產品型別確定為PCAP。

    Log Analzyer Packet Capture File日誌分析器資料包捕獲檔案

    啟用運行分析按鈕後，日誌分析器工具將分析資訊並在兩列中提供捕獲的會話的摘要：

    • RTP流
    • TCP/UDP資料流

    注意：如果資料包捕獲包括SRTP流，則它會顯示在「RTP流」列中，並執行網路分析。 SRTP流的音訊部分未解碼。

    從「RTP流」列中選擇一個會話，工具將顯示該連線的RTP流統計資訊。如果流受到網路條件的影響，丟包引數應標有紅點。

    Log Analyzer PCAP analysis日誌分析器PCAP分析

    RTP Flow Statistics可以用包含資料包丟失摘要的文本檔案格式下載。按一下Packet Loss Summary按鈕以下載檔案。

    Log Analyzer PCAP RTP Stream日誌分析器PCAP RTP流

    對於TCP/UDP流，系統顯示捕獲的會話的摘要。

    Log Analyzer PCAP TCP UDP Streams日誌分析器PCAP TCP UDP資料流


    SIP配置檔案測試器(SPT)

    會話初始協定(SIP)配置檔案用於修改傳入或傳出SIP消息，以確保不同裝置之間的相容性。「SIP配置檔案測試器」工具允許您在即時環境中部署之前驗證配置。

    SIP配置檔案工具包含3個部分：

    • SIP配置檔案規則 -用於插入要測試的SIP配置檔案規則的窗口。
    • 要應用規則的SIP消息 -用於將要應用規則的SIP消息貼上到的窗口。
    • 要複製的SIP消息- （可選）在測試複製清單配置的情況下貼上SIP消息的窗口。複製清單配置將裝置接收的入站報頭的內容複製到出站報頭。

    此工具包含2個按鈕來管理測試：

    • 綠色按鈕- 運行測試。
    • 紅色按鈕- 用於重置和清除設定。

    選擇綠色按鈕運行測試後，工具將顯示以下選項：

    • 紅色按鈕- 新測試
    • 藍色按鈕- 顯示輸入

    突出顯示「原始/修改的SIP消息」結果：

    • 藍色 -修改的SIP報頭或SDP正文在兩個消息區域中以藍色突出顯示。
    • 綠色 -增加的SIP報頭或SDP正文僅在修改的SIP消息結果中突出顯示為綠色。
    • 紅色 -刪除的SIP報頭或SDP正文僅在原始SIP消息結果中突出顯示為紅色。

    SIP PROFILE HomeSIP設定檔首頁

    預構建的SIP配置檔案示例

    該工具提供預構建的示例來簡化測試。每個視窗的頂端都有一個應用程式方塊，可用來選取這些範例。

    以下是如何使用預先定義的組態：

    1. 點選載入預構建規則集並選擇增加：SIP報頭。
    2. 點選載入示例SIP消息並選擇邀請（無SDP）。
    3. 選擇綠色的Run Test按鈕以執行測試。

    SIP PROFILE Prebuilt預先建立的SIP設定檔

    工具會顯示一個包含測試結果的新熒幕：

    修改的SIP消息

    ADDED (GREEN) - Diversion: <sip:8675309@cisco.com

    SIP PROFILE Prebuilt Add ExampleSIP配置檔案預構建增加示例

    以下是修改/新增/移除反白的範例：

    SIP配置檔案規則

    rule 100 request ANY sip-header Diversion Add "Diversion: <sip:8675309@cisco.com>"
    rule 200 request ANY sip-header P-Asserted-Identity modify "sip:4444444444@" "sip:5555555555@"
    rule 300 request ANY sip-header P-Preferred-Identity remove

    要測試規則的Sip消息

    INVITE sip:8675309@192.168.11.10:5060 SIP/2.0
    Via: SIP/2.0/TCP 192.168.10.10:5060;branch=z9hG4bK16242110
    Via: SIP/2.0/UDP 192.168.10.9:5060;branch=z9hG4bK00002579
    From: "CallerID_Name" <sip:123456789@192.168.10.10>;tag=4EDF0DD8-CA0
    To: <sip:8675309@192.168.11.10>
    Call-ID: D7E43511-335111EF-8578BA40-6B7EBADB@192.168.10.10
    Session-ID: 2d390a8000105000a000247e1266c26d;remote=3b954a1e00105000a0006c416a369498
    Cisco-Guid: 3622027175-0860951023-2238888512-1803467483
    Cseq: 101 INVITE
    Allow: INVITE, OPTIONS, BYE, CANCEL, ACK, PRACK, UPDATE, REFER, SUBSCRIBE, NOTIFY, INFO, REGISTER
    Allow-Events: telephone-event,kpml,dialog
    Supported: 100rel,timer,resource-priority,replaces
    Supported: sdp-anat
    Require: timer
    Subject: SIP Profile Test
    Session: Media
    User-Agent: Cisco-SIPGateway/IOS-17.14.1a
    Date: Thu, 27 Jun 2024 00:20:07 GMT
    Timestamp: 1719447607
    Expires: 180
    Min-SE: 1800
    Session-Expires: 1800;refresher=uac
    Max-Forwards: 69
    Contact: <sip:1111111111@192.168.10.10:5060;transport=tcp>
    Diversion: <sip:2222222222@192.168.10.10>;privacy=off;reason=unconditional;counter=1;screen=no
    Remote-Party-ID: "CallerID_Name" <sip:3333333333@192.168.10.10>;party=calling;screen=no;privacy=off
    P-Asserted-Identity: "CallerID_Name" <sip:4444444444@192.168.10.10>
    P-Preferred-Identity: "CallerID_Name" <sip:5555555555@192.168.10.10>
    CustomHeader: "CallerID_Name" <sip:7777777777@192.168.10.10>
    Accept: application/sdp
    Content-Disposition: session;handling=required
    Content-Length: 0

    SIP PROFILE Modify Add Remove ExampleSIP配置檔案修改增加刪除示例

    要檢視結果，請按一下Run Test。

    原始SIP消息

    MODIFIED (BLUE) - P-Asserted-Identity: "CallerID_Name" 
    
     
     4444444444@192.168.10.10> 
     
     
        REMOVED (RED) - P-Preferred-Identity: "CallerID_Name" <sip:5555555555@192.168.10.10>

    修改的SIP消息

    MODIFIED (BLUE) - P-Asserted-Identity: "CallerID_Name" <sip:5555555555@192.168.10.10>
    ADDED (GREEN) - Diversion: <sip:8675309@cisco.com>

    SIP PROFILE Modify Add Remove Example 2SIP配置檔案修改增加刪除示例2

    複製清單SIP設定檔

    要將裝置接收的傳入報頭中的內容複製到傳出報頭（SIP複製清單），可以使用以下工具輸入：

    • 流程圖：傳入SIP消息— > CUBE — >修改的SIP消息
    • 複製來源的對等SIP消息-複製來源的SIP消息。
    • 要測試規則的SIP消息-要應用規則的SIP消息。

    要啟用Peer SIP Message To Copy From部分，必須啟用Show Peer Copy Input選項。您可以按一下Hide Peer Copy Input隱藏此部分。

    SIP PROFILE Copylist HomeSIP配置檔案副本清單首頁

    以下是SIP規則、傳入和修改的SIP消息的示例：

    SIP配置檔案規則。

    request INVITE peer-header sip To copy “sip:(.*)@” u01
    request INVITE sip-header SIP-Req-URI modify “sip:(.*)@” sip:\u01@

    要應用規則的SIP消息。

    Sent:
    INVITE sip:235678@10.16.0.5:5060 SIP/2.0
    Via: SIP/2.0/UDP 192.0.2.0:5060;branch=z9hG4bKA7155C
    From: "Cisco" <sip:1234@10.16.0.3>;tag=B125CE72-1184
    To: <sip:5678@10.16.0.5>
    Call-ID: 783557DF-193811EF-A4C1B962-D5D3EC18@192.0.2.0
    Supported: 100rel,timer,resource-priority,replaces,sdp-anat
    Min-SE:  1800
    Allow: INVITE, OPTIONS, BYE, CANCEL, ACK, PRACK, UPDATE, REFER, SUBSCRIBE, NOTIFY, INFO, REGISTER
    CSeq: 101 INVITE
    Timestamp: 1716577979
    Contact: <sip:1234@192.0.2.0:5060>
    Expires: 180
    Allow-Events: telephone-event
    Max-Forwards: 68
    P-Asserted-Identity: "Cisco" <sip:9876@192.0.2.0>
    Session-ID: 1629a67700105000a000d9a7fe;remote=00000000000000000000000000000000
    Session-Expires:  1800
    Content-Type: application/sdp
    Content-Disposition: session;handling=required
    Content-Length: 243

    v=0
    o=CiscoSystemsSIP-GW-UserAgent 3601 9082 IN IP4 192.0.2.0
    s=SIP Call
    c=IN IP4 192.0.2.0
    t=0 0
    m=audio 8402 RTP/AVP 0 101
    c=IN IP4 192.0.2.0
    a=rtpmap:0 PCMU/8000
    a=rtpmap:101 telephone-event/8000
    a=fmtp:101 0-16

    要複製的SIP消息。

    Received:
    INVITE sip:235678@10.15.0.2:5060 SIP/2.0
    Via: SIP/2.0/UDP 10.14.0.1:5060;branch=z9hG4bK16927e56b400c78
    From: "Cisco" <sip:1234@10.14.0.1>;tag=156812752~757956d9-2b62-4ab0-b5c2-6b19710635db-53693198
    To: <sip:5678@10.15.0.2>
    Call-ID: a0f63500-1f013804-1344e15-16000e0a@10.14.0.1
    Supported: 100rel,timer,resource-priority,replaces
    Min-SE:  1800
    User-Agent: Cisco-CUCM12.5
    Allow: INVITE, OPTIONS, INFO, BYE, CANCEL, ACK, PRACK, UPDATE, REFER, SUBSCRIBE, NOTIFY
    CSeq: 101 INVITE
    Expires: 180
    Allow-Events: presence, kpml
    Supported: X-cisco-srtp-fallback,X-cisco-original-called
    Call-Info: <sip:10.14.0.1:5060>;method="NOTIFY;Event=telephone-event;Duration=500"
    Call-Info: <urn:x-cisco-remotecc:callinfo>;x-cisco-video-traffic-class=DESKTOP
    Session-ID: 1629a67700105000885a92d9a7fe;remote=00000000000000000000000000000000
    Cisco-Guid: 2700489984-0000065536-0000126777-1234102346
    Session-Expires:  1800
    P-Asserted-Identity: "Cisco" <sip:1234@10.14.0.1>
    Remote-Party-ID: "Cisco" <sip:1234@10.14.0.1>;party=calling;screen=yes;privacy=off
    Contact: <sip:1234@10.14.0.1:5060>;+u.sip!devicename.ccm.cisco.com="SEP885A92D9A7FE"
    Max-Forwards: 69
    Content-Length: 0

    SIP PROFILE Copylist ExampleSIP配置檔案副本列表示例

    按一下Run Test按鈕以啟動工具，從而繼續操作。

    複製暫存器

    Register: u01
    Value: 5678

    原始SIP消息

    MODIFIED (BLUE) - INVITE sip:235678@10.16.0.5:5060 SIP/2.0

    修改的SIP消息

    MODIFIED (BLUE) - INVITE sip:5678@10.16.0.5:5060 SIP/2.0

    SIP PROFILE Copylist Example 2SIP配置檔案副本列表示例2

    報告問題

    在CSA平台頂部，Report A Problem部分允許您共用工具中檢測到的任何問題。

    此外，管理員還可以透過傳送電子郵件至CSA開發團隊處理資訊的位置，提供反饋、意見或建議。

    Report Problem Home報告問題首頁

    Report Issue報告問題

    已啟用三個圖示，可讓使用者提供意見反應（擴音器圖示）、檢閱使用者檔案（問號圖示）以及開啟使用者設定（齒輪圖示）。

    Icons圖示

    支援相關資訊

    配置CUBE和TDM網關的調試集合

    Cisco IOS XE 17.5版思科統一邊界要素配置指南

    章節：SIP配置檔案

    在CUBE企業常見使用案例上使用SIP配置檔案

    修訂記錄

    修訂 發佈日期 意見
    1.0
    26-Aug-2024
    初始版本
    TAC Authored

    由思科工程師貢獻

    • 路易士·馬丁尼茲·博特洛
      問題上報工程師

    這份文件是否有所幫助？

    Feedback意見

    讓思科協助您