تجميع السجلات لمسائل أداء CUIC

المقدمة

يصف هذا المستند عملية تكوين سجلات مركز الذكاء الموحد (CUIC) من Cisco وتجميعها عند أستكشاف أخطاء الأداء وإصلاحها. قد يمثل أستكشاف مشكلات الأداء CUIC وإصلاحها تحديا بسبب وجود الكثير من التقنيات والمنتجات والمكونات المعنية. كما أن مشاكل الأداء تظهر نفسها بطرق مختلفة، لذلك من المهم أن تكون لديك صورة واضحة أثناء أستكشاف المشكلات وحلها.

ليس الغرض من هذا وثيقة أن يصف العملية يتحرى في تفصيل عظيم، غير أن يبرز النقاط الرئيسية عندما يجمع ال log يتطلب ب cisco TAC أو cisco الهندسة.

تجميع السجلات لمسائل أداء CUIC

مبادئ توجيهية عامة

يعد جمع جميع السجلات في عملية أخذ واحدة أمرا صعبا ويستهلك الكثير من الوقت. يجب أن يستغرق الإجراء بأكمله من ساعة واحدة إلى 4 ساعات. يعتمد ذلك على مدى نجاح العميل أو الشريك في إعداد البيئة. 

ملاحظة: لا يلزم وقت التوقف عن العمل لهذا النشاط رغم أنه قد يحتاج العميل إلى إرسال بعض طلبات التغيير.

يوصى بشدة بإجراء الاختبارات باستخدام متصفح Firefox على وجه التحديد نظرا لأدوات المطور الأكثر شمولا (F12).

تحتاج إلى معرفة عناوين IP التي يستخدمها عميل CUIC والخادم للاتصال. 

يتم إستخدام عناوين IP هذه لعميل CUIC والخادم في هذه المقالة.

عنوان IP للعميل: 10.111.16.157

عنوان IP للخادم: 10.222.6.29 

تلميح: فيما يتعلق باستكشاف أخطاء أداء CUIC وإصلاحها، يوصى بشدة بإعادة إنتاج المشكلة باستخدام عميل موجود في بيئة UCCE LAN. وهذا سوف يقلل تأثير اتصال الشبكة بين عميل CUIC والخادم.

  

قد تكون هناك محاولات متعددة لجمع السجلات، لذا من المهم الحفاظ على تسمية واضحة للملفات التي تم تجميعها. قم بإنشاء مجلد على سطح مكتب العميل لديك باسم مثل tac<date>_<time>(eg tac27february17_1334) أو tac_<date>_<try> (eg tac27february17_take3). بعد تجميع السجلات، ضعها كلها في هذا المجلد، ثم أرشفها وألصقها بالحالة.

حاول العثور على عقدة في نظام المجموعة تقوم بتنفيذ أفضل أداء من منظور وحدة المعالجة المركزية (CPU) والذاكرة وحالات ioWait ولا تزال تواجه مشكلات في الأداء. قم بإجراء إختبارات مع هذه العقدة بتجنب موازن الأحمال مباشرة (إن وجد).

مجموعة نموذجية من السجلات

1. سجلات مستعرض العميل F12
2. التقاط حزمة HTTP للعميل
3. التقاط حزمة HTTP للخادم
4. خادم CUIC
   • وكالة تقارير مركز الإستخبارات
   • Cisco Informix Database Service
   • سجل PerfMon لمجمع بيانات Cisco RIS
   • Cisco Tomcat
   • عارض الأحداث - سجل التطبيق
   • عارض الأحداث - سجل النظام
   • سجلات التقاط الحزم

تحديد مشكلة

مثال 1. خطأ أو مهلة

أثناء ساعات الذروة، يقوم المستخدمون في جميع العقد الموجودة في نظام المجموعة بالإعلام عن عدة أخطاء في التقارير في الوقت الفعلي.

E1: "استراد معلومات مجموعة البيانات Java.lang.IllegalStateException"

E2: "انتهت مهلة التحديث الأخير (getDataSetMaxReach)، انقر فوق "تحديث" لإعادة التحميل."

E3: انتهت مهلة التحديث الأخير(reportRefreshRetry). الرجاء الانتظار حتى التحديث التلقائي التالي أو انقر فوق 'تحديث'.

وكانت المشكلة قد بدأت في 27 شباط/فبراير صباحا بعد أن تم تطبيق هذه التغييرات النوعية على الشبكة والأمن ومركز البيانات في عطلة نهاية الأسبوع. لقد تحققنا من هذه المبادئ التوجيهية للأحجام لمجموعة CUIC.

تصميم شبكة مرجع حل مركز الذكاء الموحد (SRND) من Cisco، الإصدار 11.0(1)

مثال 2. تأخير كبير

يواجه مستخدمو تقارير CUIC بشكل مستمر التأخيرات من 30 إلى 40 ثانية فقط على عقدة المشترك الأول عند عرض تقارير الوقت الفعلي.

بدأت المشكلة في 26 فبراير بعد ترقية البرامج الثابتة لأجهزة شبكة SAN الخاصة بنا. لقد تحققنا من هذه المبادئ التوجيهية للأحجام لمجموعة CUIC. 

تصميم شبكة مرجع حل مركز الذكاء الموحد (SRND) من Cisco، الإصدار 11.0(1)

الموارد التي يوفرها العميل

فيما يلي ملخص للأدوات/التطبيقات التي يجب على العملاء أو الشركاء إستخدامها عند تجميع السجلات لمعالجة مشكلات أداء CUIC.

• العميل: موجه أوامر Windows (CMD)
• العميل: Wireshark
• العميل: متصفح Firefox
• العميل: خادم أداة المراقبة في الوقت الفعلي (RTMT) أو خادم بروتوكول نقل الملفات الآمن (SFTP)
• سطر أوامر خادم CUIC (CLI)

ملاحظة: في بعض الحالات، قد يكون جمع سجلات CUIC باستخدام RTMT معقدا. لذلك أنت تحتاج أن يجلب ال log من CLI CUIC إلى SFTP نادل.

تحضير التكاثر

1. اسم واجهة العميل وعنوانها

أستخدم CMD لتجميع جميع عناوين IP لعميل CUIC.

اعثر على شبكة قارن وعنوان أن يكون استعملت أن يتصل مع CUIC نادل. تحتاج إلى إستخدامه عند تجميع التقاط حزمة من جانب خادم.

C:\Users\Administrator>route print -4 | findstr 222
       10.222.6.0    255.255.254.0         On-link      10.111.16.157      1

حدد اسم الواجهة الصحيح الذي يلزم تحديده لاحقا في Wireshark باستخدام هذا الأمر. اسم الواجهة وعنوان IP الخاص بها هما مائل.

c:\tmp>ipconfig
Windows IP Configuration

Wireless LAN adapter wifi0:
   IPv4 Address. . . . . . . . . . . : 10.111.16.157

Ethernet adapter Local Area Connection 2:
   IPv4 Address. . . . . . . . . . . : 192.168.123.1

<output omited for brevity>

2. التقاط حزمة HTTP للعميل

تأكد من تثبيت تطبيق Wireshark ومن أنه يعمل بشكل جيد. حدد الواجهة الصحيحة المحددة في الخطوة السابقة، ولكن الآن أوقف التقاط الحزمة. 

تلميح: إذا لم يتم اكتشاف واجهات في Wireshark، فإن الحل الشائع لذلك هو إعادة تثبيت برنامج PCAP المضمن مع Wireshark.

3. سجلات مستعرض العميل F12

3.1 افتح مستعرض Firefox وتحقق من إصداره. يجب أن يكون مدعوما.

اضغط على F12 وانتقل إلى علامة التبويب شبكة (شاشة الشبكة، CTRL+العالي+Q). حدد الكل (أو HTML، JS، XHR، الوسائط، الذاكرة المؤقتة، WS، غير ذلك). 

4. سجلات RTMT الخاصة بالخادم

قم بتسجيل الدخول إلى CUIC باستخدام RTMT وحدد هذه الخدمات على جميع العقد

• وكالة تقارير مركز الإستخبارات
• Cisco Informix Database Service
• سجل PerfMon لمجمع بيانات Cisco RIS
• Cisco Tomcat
• عارض الأحداث - سجل التطبيق
• عارض الأحداث - سجل النظام
• سجلات التقاط الحزم

حدد النطاق المطلق أو النطاق النسبي ووفر اسم ذي معنى للمجلد الذي يحتوي على هذه السجلات.

5. التقاط حزمة HTTP للخادم

من أجل تبسيط عملية أستكشاف الأخطاء وإصلاحها، يلزم أن تكون هناك طريقة بسيطة لتعقب استعلام واحد من عميل إلى خادم. يتم إستخدام النقل المشفر ل HTTPS بشكل افتراضي والذي لا يكشف عن هذه التفاصيل. ولهذا السبب يجب تمكين HTTP بشكل مؤقت لوقت إصدار النسخ.

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

admin:set cuic properties http-enabled on
Value has been successfully set

admin:show cuic properties http-enabled
http_enabled 
============ 
on 

ملاحظة: لا تحتاج إلى إعادة تشغيل خدمة Cisco Tomcat. التأثير الوحيد هو اتصال غير مشفر بين عميل CUIC والخادم.

  

بدء التقاط حزمة باستخدام Wireshark على عميل CUIC.

بدء التقاط حزمة باستخدام هذا الأمر على عقدة خادم CUIC. تأكد من تحديد عنوان IP الصحيح للعميل.

admin:utils network capture file packetcapture count 100000 size all host ip 10.111.16.157
Executing command with options:
 size=ALL count=100000 interface=eth0
 src=dest= port= 
 ip=10.111.16.157  

6- تسجيل الجلسات

يوصى بشدة بتضمين تسجيل فيديو بشاشة لعملية النسخ جنبا إلى جنب مع السجلات لإظهار تجربة مستخدم CUIC خاصة عند التعامل مع حالات انتهاء مهلة عرض التقرير وحالات التأخير.

يمكن إستخدام أي برنامج لتسجيل الشاشة. كما توفر ميزة تسجيل Cisco Webex هذه الميزة.

إعادة إنتاج المشكلة

حاول إعادة إنتاج المشكلة بأقل قدر من الخطوات التي تم تنفيذها. حاول تجنب القيام بمهام غير ضرورية أثناء عملية النسخ. هذا سوف يسرع كثيرا السجل تحليل يركب ب cisco TAC.

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

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

أثناء إختبار النسخ انقر فوق ساعة Windows وافتح إعدادات تاريخ ووقت التغيير... في الجزء الأيمن السفلي. يجب مراقبة الوقت بدقة حتى الثواني.

تسجيل كافة الإجراءات التي تم إتخاذها. ومن المفيد ان تكون هنالك بعض الفجوات الزمنية بين الاجراءات. يمكنك إستخدام هذا المثال.

14:16:30 - عنوان CUIC مطبوع في متصفح Firefox

14:17:42 - اضغط على مفتاح Enter بعد كتابة بيانات الاعتماد

14:20:20 - قام النظام بتحميل صفحة الويب Main.htmx

14:21:02 - بدأت قائمة المستخدمين التي تم النقر عليها و CUIC بتحميلها

14:28:15 - تم تحميل قائمة المستخدم بنجاح (مع تأخير 7 م 10)

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

تجميع السجلات بعد النسخ

1. تجميع التقاط حزمة HTTP للعميل

إيقاف التقاط الحزمة على العميل (Wireshark).

أوقف التقاط الحزمة على عقدة CUIC بالضغط على CTRL+C.

في Wireshark احفظ التقاط حزمة العميل وانقلها إلى مجلد TAC.

2. تجميع سجلات مستعرض العميل F12

انقر بزر الماوس الأيمن فوق أي طلب واضغط على حفظ الكل باسم HAR. ثم حدد مكان مجلد TAC وانقر حفظ.

يمكن تحليل هذا النوع من الملفات باستخدام أداة G Suite HAR Analyzer.

يوضح هذا المثال أن سبب تأخيرات التقرير هو انخفاض عرض نطاق الشبكة بين عميل CUIC والخادم.

3. تجميع سجلات RTMT الخاصة بالخادم

تأكد من إيقاف التقاط حزمة خادم CUIC مسبقا. إن لا بعد ذلك اضغط Ctrl+C في جلسة CLI.

انتقل إلى CUIC RTMT الذي تم إعداده مسبقا واضغط End. 

ملاحظة: في حالة إستخدام RTMT، تأكد من قبول كافة مطالبات الشهادات غير الموثوق بها.

إذا كانت عملية تجميع سجل RTMT بطيئة، فهناك خيار لتنزيل ملفات السجل إلى خادم SFTP.

أستخدم هذه الأوامر لتجميع السجلات الضرورية إلى خادم SFTP.

file get activelog /cuic/logs/cuic/* reltime hours 1

file get activelog /cuic/logs/cuicsrvr/* reltime hours 1

file get activelog /cm/log/informix/* reltime hours 1

file get activelog /cm/log/ris/csv/PerfMon* reltime hours 1

file get activelog /syslog/CiscoSyslog* reltime days 1

file get activelog /syslog/AlternateSyslog* reltime days 1

file get activelog /syslog/messages* reltime days 1

file get activelog /cuic/logs/cuic/* reltime hours 1

file get activelog /cuic/logs/cuic/* reltime hours 1

file get activelog /tomcat/logs/localhost_access*.txt reltime hours 1

file get activelog /platform/cli/*.cap reltime hours 1

  

بجانب السجلات، يتم توفير مخرجات واجهة سطر الأوامر CUIC هذه المأخوذة من عقدة الاختبار.

show status
show tech network hosts
utils ntp status
utils service list
utils dbreplication runtimestate
file list activelog /core/
file dump install system-history.log
show process using-most cpu
show process using-most memory
run sql SELECT COUNT(*) FROM cuic_data:cuicuser
show perf query counter ReportingEngineInfo ReportsUsersLoggedin

4. تسجيل جلسة الالتقاط

قم بإيقاف تسجيل الشاشة وإضافته إلى مجلد TAC.

إرجاع التغييرات

تعطيل اتصال HTTP على عقدة CUIC.

admin:set cuic properties http-enabled off
Value has been successfully set

admin:show cuic properties http-enabled
http_enabled 
============ 
off