أستكشاف أخطاء المكعب وإصلاحها من خلال محلل حلول التعاون

المقدمة

يصف هذا المستند أدوات محلل السجل واختبار ملف تعريف SIP لمكعب أستكشاف الأخطاء وإصلاحها باستخدام مدخل محلل حلول التعاون.

المتطلبات

توصي Cisco بأن تكون لديك معرفة بالمواضيع التالية:

• حلول مؤسسات عناصر الحدود الموحدة (CUBE) من Cisco.
• بروتوكول بدء جلسة عمل (SIP).
• مجموعة سجل المكعب (تصحيح الأخطاء).

الشروع في البدء

يعد Collaboration Solutions Analyzer (محلل حلول التعاون (CSA) مجموعة من الأدوات المصممة لدعم حل التعاون لديك طوال دورة حياته. وتساعد على تحديد المشكلات وتوفير خطط عمل تصحيحية عند الحاجة، مما يساعد في كل مرحلة من حل التعاون.

انتقل إلى محلل حلول التعاون في https://cway.cisco.com/csa-new/#/home

ملاحظة: إستخدام متصفح Chrome يضمن أن الأداة تعمل بالشكل الأمثل.

الإعتبارات

تم تصميم الأدوات لجهاز المكعب الذي يعالج مكالمات SIP إلى SIP. لا تدعم الأدوات أي بروتوكول صوت آخر.

يستخدم محلل السجل سجلات CUBE (استنادا إلى تصحيح رسائل SIP) للتحليل.

إذا كنت بحاجة إلى مساعدة مع بروتوكول صوت آخر، فيرجى إستخدام مساعد دعم Cisco لعمليات تفعيل TAC على https://supportassistant.cisco.com

وصف النظام الأساسي

يوفر نظام CSA الأساسي أدوات المكعب التالية:

• محلل السجل - قم بتحميل السجلات من CUBE وأجهزة التعاون الأخرى لاكتشاف المشكلات واستكشاف أخطائها وإصلاحها وحلها تلقائيا.
• مختبر ملف تعريف SIP - التحقق من تكوين ملف تعريف SIP.

الصفحة الرئيسية ل CSA

محلل السجل

تتيح أداة محلل السجل للمسؤولين إمكانية فحص إرسال إشارات المكالمات التي يتم معالجتها بواسطة جهاز CUBE. وهو يقدم تحليلا شاملا لملفات السجلات، بما في ذلك:

• معلومات جهة الاتصال
• مخطط السلم
• إرسال الإشارات

ملاحظة: يجب تجميع تصحيح أخطاء المكعب (تصحيح أخطاء رسائل CCSIP) من مكالمة تمت معالجتها بواسطة CUBE وتخزينها أولا في ملف نصي. يجب تضمين تصحيح أخطاء SIP فقط وعدم تضمين أي مخرجات أخرى، مثل أوامر show، في هذا الملف النصي.

تحميل ملفات سجل المكعب

انتقل إلى محلل حلول التعاون في https://cway.cisco.com/csa-new/#/home

ثم حدد الأداة بالنقر فوق تحميل الملفات في قسم محلل السجل.

صفحة محلل السجل الرئيسية

يعرض النظام الأساسي شاشة الأداة حيث يمكن تحديد الملف أو سحبه.

تحميل محلل السجل

لإكمال عملية تحميل الملف لكي تقوم الأداة بالتحليل، انقر على زر تحميل.

ملف تحميل محلل السجل

بعد تحميل الملف إلى الأداة، حدد الملف (الملفات) الذي تريد تحليله عن طريق تحديد المربع المتوافق، ثم انقر على الزر تشغيل التحليل.

• يقوم النظام بتعيين نوع المنتج إلى المكعب.
• يمكن تحليل أكثر من ملف في نفس جلسة العمل.

نوع منتج محلل السجل

تحلل الأداة كل إستدعاءات الإشارات الملتقطة في الملف النصي وتعرض ملخصا لأرجل الاستدعاءات المحددة. يمكنك عندئذ تطبيق عوامل تصفية:

• البحث - تصفية جلسات المكالمات حسب بيانات معينة، مثل الأرقام المطلوبة.
• بحث حسب سبب قطع الاتصال - تصفية جلسات الاتصال استنادا إلى سبب قطع الاتصال.

عامل تصفية إستدعاء محلل السجل 

لمتابعة التحليل التفصيلي، حدد سطر جلسة الاتصال الذي تريد التركيز عليه، وتعرض الأداة التحليل الكامل الذي يعرض معلومات نقطة الاتصال والرسم التخطيطي وSignaling.

معلومات عن ساق المكالمة

تعرض المرحلة الأولى معلومات ساق الاتصال، والتي تعرض نظرة عامة على المكالمة:

• نوع ساق اتصال SIP
• من - تم الحصول عليها من رأس SIP لرسالة الدعوة.
• To - تم الحصول عليها من الرأس TO SIP لرسالة الدعوة.
• مصدر الإشارات - عنوان IP ومنفذ الجهاز المصدر. تم الحصول عليه من رأس VIA SIP لرسالة الدعوة.
• وجهة إرسال الإشارات - عنوان IP ومنفذ جهاز الوجهة. تم الحصول عليه من رأس URI SIP لرسالة الدعوة.
• معرف المكالمة - تم الحصول عليه من رأس SIP Call-ID لرسالة الدعوة.
• الاتصال برجل الاتصال - الطابع الزمني لجلسة الاتصال.

معلومات نقطة اتصال محلل السجل

في هذا القسم، يمكن تمكين علامات السلم لإبراز الرسائل في الرسم التخطيطي للسلم. يحتوي التطبيق على حقلين:

• المعرف - أدخل المعلمة المحددة التي ترغب في إبرازها.
• الوصف - أضف وصفا للمعلمة.

انقر فوق الزر إضافة لإكمال العملية.

علامات سلم محلل السجل 

مخطط السلم

وفي المرحلة الثانية، يعرض رسم تخطيطي للسلم يصف بصريا رسائل SIP المتبادلة خلال المكالمة. يتم ترميز الرسائل بالألوان لتسهيل التعرف عليها:

• اللون الأزرق - رسائل دعوة SIP.
• لون أخضر - رسائل SIP 200 OK و ACK.
• اللون الأحمر - رسائل SIP Bye.

لتنزيل نسخة من الرسم التخطيطي، انقر فوق الزر تنزيل سلم. يتم تنزيل الرسم التخطيطي وحفظه على هيئة ملف صورة PNG. الرجاء ملاحظة أن هذا الخيار متوفر فقط عند إستخدام مستعرض Google Chrome.

رسم تخطيطي لدرج محلل السجل

تسمح هذه الأداة للمسؤول بفتح رسائل SIP وعرض محتواها. انقر فوق رسالة لفتحها.

رسالة رسم تخطيطي لمسلم محلل السجل

يمكن أن يضيف المسؤول علامات سلم لتصور رسائل SIP مع علامة نقطة مميزة في قسم معلومات ساق الاتصال. يمكن إستخدام أي معلمة مضمنة في رسالة SIP للعلامة.

في هذا المثال، يتم إستخدام عنوان IP لمعلمة المعرف ويتم إضافة وصف. يتم تمييز رسائل SIP التي تحتوي على عنوان IP بعلامة نقطة لتمييزهم عن الرسائل الأخرى.

علامات سلم محلل السجل 1

علامات سلم محلل السجل 2

وعامل تصفية آخر يمكن إستخدامه لتمييز رسائل SIP عن الرسائل الأخرى هو برنامج ترميز صوتي.

علامات سلم محلل السجل 3

علامات سلم محلل السجل 4

إرسال الإشارات

المرحلة الأخيرة هي إرسال الإشارات، والتي تعرض رسائل SIP لكل من قوائم المكعب (الواردة والصادرة). وهو يحتوي على عناوين IP للمصدر والوجهة. انقر لعرض الرسالة.

إرسال إشارات محلل السجل

رسالة إرسال إشارات محلل السجل

التشخيص

يتم تشغيل جميع البيانات التي يتم تحليلها من السجلات مقابل توقيعات التشخيص التي تحدد العيوب المعروفة أو المشكلات الشائعة أو التكوينات الخاطئة وتوفر خطة عمل تصحيحية.

بمجرد تحديد مكالمة تم التقاطها في السجلات لعرض تحليل ملخص المكالمة، يعرض نظام CSA الأساسي قسم التشخيصات، الذي يحتوي على هذه المعلومات:

• المشاكل التي تم العثور عليها
• معلومات مفقودة
• مشكلة محتملة

يمكن تنشيط زر التبديل لتصفية العيوب وعرضها فقط.

الصفحة الرئيسية لتشخيص محلل السجل

نظرة عامة على تشخيصات محلل السجل

التقاط حزمة المكعب

التقاط الحزمة هو مخزن مؤقت للملفات تم إنشاؤه لجمع نسخة من الحزم الفعلية في واجهة شبكة CUBE أو أي جهاز شبكة صوتية. يمكن فتح هذا الملف وتحليله بواسطة برنامج محلل الشبكة، مثل Wireshark.

تم تحسين أداة محلل السجل باستخدام محلل التقاط الحزمة الذي يمكنه معالجة امتدادات تنسيق PCAP أو PCAPNG، مما يوفر ملخصا لإحصائيات الجلسة والشبكة التي تم تجميعها من المكالمات.

يجب تحميل ملف التقاط الحزمة إلى أداة محلل السجل بنفس طريقة تحميل ملف سجل CUBE. يحدد النظام نوع المنتج على أنه PCAP.

ملف التقاط حزمة محلل السجل

بمجرد تنشيط زر تشغيل تحليل، فإن أداة محلل السجل تحلل المعلومات وتوفر ملخصا للجلسات الملتقطة في عمودين:

• تدفقات RTP
• تدفقات TCP/UDP

ملاحظة: إذا كان التقاط الحزمة يتضمن تدفقات SRTP، فإنه يظهر في العمود "تدفقات RTP" ويتم إجراء تحليل للشبكة. لم يتم فك ترميز الجزء الصوتي لتدفق SRTP.

حدد جلسة من عمود تدفقات RTP وتعرض الأداة حالات تدفق RTP لذلك الاتصال. إذا كان الدفق يتأثر بظروف الشبكة، فيجب وضع علامة على معلمة فقدان الحزمة بنقاط حمراء.

تحليل PCAP لمحلل السجل

يمكن تنزيل إحصائيات تدفق RTP بتنسيق ملف نصي يحتوي على ملخص فقدان الحزمة. انقر فوق زر ملخص فقدان الحزمة لتنزيل الملف.

تدفق PCAP RTP لمحلل السجل

بالنسبة لدفقات TCP/UDP، يعرض النظام ملخص الجلسات الملتقطة.

دفقات PCAP TCP لمحلل السجل

مختبر ملف تعريف SIP (SPT)

يتم إستخدام ملفات تعريف بروتوكول بدء جلسة عمل (SIP) لتعديل رسائل SIP الواردة أو الصادرة لضمان التوافق بين الأجهزة المختلفة. تتيح لك أداة "إختبار ملف تعريف SIP" التحقق من صحة التكوين الخاص بك قبل نشره في بيئة مباشرة.

تتكون أداة ملف تعريف SIP من 3 أقسام:

• قواعد ملف تعريف SIP - نافذة لإدراج قواعد ملف تعريف SIP التي سيتم إختبارها.
• رسالة SIP لتطبيق القواعد - نافذة للصق رسالة SIP حيث يجب تطبيق القواعد.
• رسالة SIP المطلوب النسخ منها - (إختياري) الإطار للصق رسالة SIP في حالة إختبار تكوين قائمة نسخ. يقوم تكوين قائمة النسخ بنسخ محتوى رأس الوارد الذي تم إستقباله بواسطة جهاز إلى رأس الصادر.

تحتوي الأداة على زرين لإدارة الاختبارات:

• الزر الأخضر - لتشغيل إختبار.
• Red Button - لإعادة ضبط ومسح الإعدادات.

بعد تحديد الزر الأخضر لتشغيل الاختبار، تعرض الأداة تلك الخيارات:

• الزر الأحمر - إختبار جديد
• الزر الأزرق - إظهار الإدخالات

تمييز نتائج رسالة SIP الأصلية/المعدلة:

• اللون الأزرق - يتم تمييز رؤوس SIP المعدلة أو نص بروتوكول طبقة الأمان (SDP) باللون الأزرق في كل من منطقتي الرسالة.
• اللون الأخضر - يتم تمييز رؤوس SIP المضافة أو نص بروتوكول طبقة الأمان (SDP) باللون الأخضر في نتيجة رسالة SIP المعدلة فقط.
• Red Color - يتم تمييز رؤوس SIP التي تمت إزالتها أو نص بروتوكول طبقة الأمان (SDP) باللون الأحمر في نتيجة رسالة SIP الأصلية فقط.

الصفحة الرئيسية لملف تعريف SIP

مثال ملف تعريف SIP الذي تم تصميمه مسبقا

توفر الأداة أمثلة مصممة مسبقا لتبسيط الاختبار. في أعلى كل نافذة، يوجد مربع تطبيق لتحديد هذه الأمثلة.

فيما يلي كيفية إستخدام تكوين معرف مسبقا:

1. انقر فوق تحميل مجموعة قواعد تم إنشاؤها مسبقا وحدد إضافة: رأس SIP.
2. انقر فوق تحميل نموذج رسالة SIP وحدد دعوة (بدون SDP).
3. حدد زر تشغيل إختبار الأخضر لتنفيذ الاختبار.

ملف تعريف SIP تم تصميمه مسبقا

تعرض الأداة شاشة جديدة مع نتائج الاختبار:

رسالة SIP المعدلة

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

مثال إضافة مسبق لملف تعريف SIP

هذا مثال على تعديل/إضافة/إزالة الإبراز:

قواعد ملف تعريف 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 وإضافة مثال إزالة

لعرض النتيجة، انقر على تشغيل الاختبار.

رسالة 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 إضافة إزالة مثال 2

ملف تعريف SIP ل Copylist

لنسخ محتوى من رأس قادم يستلمه جهاز إلى رأس صادر (قائمة نسخ SIP)، يمكن إستخدام مدخلات الأداة التالية:

• مخطط التدفق: رسالة SIP الواردة — > CUBE — > رسالة SIP المعدلة

• رسالة SIP للنسخ منها - رسالة SIP للنسخ منها.
• رسالة SIP لاختبار القواعد عليها - رسالة SIP لتطبيق القواعد.

لتمكين رسالة SIP للنسخ من المقطع، يجب تمكين الخيار show peer copy input. يمكنك النقر فوق إخفاء إدخال نسخة النظير لإخفاء هذا القسم.

الصفحة الرئيسية لقائمة نسخ ملف تعريف SIP

هذا مثال على قواعد 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

تابع بالنقر على زر تشغيل إختبار لتشغيل الأداة.

نسخ السجل

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

مثال 2 SIP Profile Copylist

الإبلاغ عن مشكلة

في أعلى النظام الأساسي CSA، يسمح لك قسم الإبلاغ عن مشكلة بمشاركة أي مشكلة يتم الكشف عنها في الأدوات.

بالإضافة إلى ذلك، يمكن أن يوفر المسؤول ملاحظات أو تعليقات أو اقتراحات من خلال إرسال بريد إلكتروني إلى المكان الذي يقوم فيه فريق تطوير CSA بمعالجة المعلومات.

الصفحة الرئيسية لمشكلات التقرير

مشكلة في التقرير

تم تمكين ثلاث أيقونات للسماح للمستخدم بتوفير الملاحظات (أيقونة ميغا فون)، ومراجعة وثائق المستخدم (أيقونة علامة إستفهام) وفتح إعدادات المستخدم (أيقونة عجلة الترميز).

أيقونات

معلومات الدعم ذات الصلة

تكوين مجموعة تصحيح الأخطاء للبوابات TDM و CUBE

دليل تكوين عناصر الحدود الموحدة من Cisco من خلال Cisco IOS XE 17.5

الفصل: ملفات تعريف SIP

إستخدام توصيفات SIP في حالات الاستخدام الشائع ل CUBE Enterprise