تجميع سجلات التتبع وإدارتها باستخدام تحسين التسجيل الموحد

المقدمة

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

نظرة عامة

الاغراض العملية:

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

كيف يشتغلون

• تسجل ميزة التتبع تفاصيل الأحداث الداخلية التي تحدث داخل الهيكل. وبشكل دوري، يتم إنشاء ملفات التتبع التي تحتوي على إخراج التتبع الكامل لوحدة نمطية وتحديثها، ويتم الاحتفاظ بهذه الملفات في دليل tracelog.
• يمكنك تحرير مساحة على نظام الملفات. يمكن حذف ملفات التتبع من هذا الدليل دون التأثير على أداء الجهاز.
• يمكنك نقل سجلات التتبع إلى مواقع بديلة. يمكنك إستخدام FTP و TFTP وما إلى ذلك، لنسخ الملفات لتحليلها أو تحميلها إلى حالة مفتوحة باستخدام مركز المساعدة التقنية (TAC).
• لا يمكنك تعطيل سجلات التتبع ولكن يمكنك تغيير مستوى التتبع لتحديد مقدار المعلومات التي تريد تجميعها لكل وحدة نمطية.

مستويات التتبع

تملي مستويات التتبع حجم المعلومات التي تم الاحتفاظ بها في المخزن المؤقت للتتبع أو الملف. تكون جميع مستويات التتبع المتاحة التالية وتشرح أنواع الرسائل التي يتم تسجيلها في كل مستوى.

حالة الطوارئ—> النظام غير مستقر/غير قابل للاستخدام.

خطأ—> حدث يؤدي إلى فقدان بسيط للوظائف دون حل تلقائي، مما يمثل مشكلة غير متوقعة لا يمكن أن تؤثر على العمليات على الفور ولكن يمكن أن تكون لها عواقب في المستقبل.

تحذير—> مشكلة يمكن حلها تلقائيا، أو حالة يمكن أن تؤدي إلى فقدان الوظيفة إذا لم يتم التحقيق فيها ومعالجتها بسرعة.

إشعار—> مجموعة مستوى السجل القياسي للوحدات النمطية. يلتقط هذا المستوى الأحداث الهامة التي تحدث داخل النظام.

معلومات—> رسائل إعلامية فقط. يوفر معلومات إضافية حول الأحداث المهمة المتعلقة بالنظام أو مميزاته.

يوفر debug—> سجلات تصحيح الأخطاء.
يوفر verbose—> المستوى الثاني لسجلات تصحيح الأخطاء.
الضوضاء—> تم تسجيل الحد الأقصى للرسائل الممكنة.

عرض مستويات التتبع الحالية

يمكنك رؤية مستوى التتبع لأي وحدة نمطية وتغييره باستخدام الأمر show platform software trace level.

يعرض هذا الأمر مستوى التتبع لعمليات إدارة إعادة التوجيه على RP النشط.

Router#show platform software trace level forwarding-manager rp active

هذا هو المخرج:

Module Name                     Trace Level      
-----------------------------------------------
acl                             Notice           
active-identity                 Notice           
alg                             Notice           
appnav-controller               Notice           
aps                             Notice           
bcrpgc                          Informational    
bfd                             Notice           
bier                            Notice           

تعديل مستوى التتبع

يمكنك تعديل مستوى تتبع لوحدة نمطية معينة أو جميع الوحدات النمطية في عملية ما. للقيام بذلك، يمكنك إستخدام الأمر set platform software trace.

يعمل هذا الأمر set platform software trace chassis-manager f0 cman_fp warning على تغيير مستوى التتبع cman_fp في مدير الهيكل الخاص ب ESP في الفتحة 0 إلى مستوى التحذير.

يمكنك التحقق من التغيير باستخدام هذا الأمر show platform software trace level chassis-manager f0

هذا هو المخرج:

Module Name                     Trace Level      
-----------------------------------------------
bcrpgc                          Informational    
bipc                            Notice           
bsignal                         Notice           
btrace                          Notice           
btrace_ra                       Notice           
cdllib                          Notice           
chasfs                          Notice           
cman_fp                         Warning  

خيارات التتبع الجديدة

بدءا من 16،8، تقدم Cisco تحسين التسجيل الموحد. الهدف هو إنشاء تجربة تسجيل سلسة للمستخدم بين تسجيل الدخول إلى IOS وأنظمة تسجيل العمليات الأخرى. يمكن دمج السجلات من كلا النظامين وعرضها بالترتيب الزمني، مما يسهل عليك أستكشاف أخطاء النظام وإصلاحها. 

عرض عمليات التتبع لعملية مختلفة 

يمكن إستخدام الأمر show logging process لعرض محتوى عمليات التتبع التي تم إنشاؤها بواسطة العمليات المحددة. يمكن تضمين السجلات من دليل التخزين المؤقت و tracelogs في الإخراج.

هناك أيضا دعم لاسم العملية الجزئية اسم العملية مقبول ككلمةمن قبل المحلل.

ملاحظة: يجب أن يتطابق اسم العملية (جزئيا أو كليا) مع اسم tracelog، وإلا، يمكن أن يحدث عدم تطابق ينتج عنه عدم عرض أي آثار.

يمكن أن يجمع الأمر show logging process بين سجلات fman-rp وfman-fp.

Router#show logging process fman 
Displaying logs from the last 0 days, 0 hours, 10 minutes, 0 seconds
executing cmd on chassis local ...
Unified Decoder Library Init .. DONE
Found 1 UTF Streams

2024/05/22 19:01:01.347466887 {fman_rp_R0-0}{255}: [source] [11941]: (ERR): ipc(mqipc/iosd/iosd-fman):Unable to open config channel to source
2024/05/22 19:00:50.246774567 {fman_fp_image_F0-0}{255}: [btrace] [13616]: (note): Btrace started for process fman_fp_image_pman ID 13616 with 512 modules
2024/05/22 19:00:50.246777079 {fman_fp_image_F0-0}{255}: [btrace] [13616]: (note): File size max used for rotation of tracelogs: 8192

تنفيذ دعم عمليات متعددة

يتيح لك أمر واجهة سطر الأوامر (CLI) "show logging process" الآن تحديد أسماء عمليات متعددة مفصولة بفواصل باستخدام الكلمة الأساسية "process". تقوم عملية التتبع المدمجة بعرض السجلات من العمليات المحددة فقط، مثل عمليات SMAN وIOS.

Router#show logging process sman,ios
executing cmd on chassis 1 ...
Collecting files on current[1] chassis.

خيارات نافذة الوقت

يمكن أن تحتوي جميع المسارات على أختام زمنية في منطقة زمنية محلية إذا تم تكوين أي منها. إذا لم تكن هناك مساحة، يتم إستخدام الطوابع الزمنية في "التوقيت العالمي المنسق" (UTC) ولكن يمكنك تبديل المنطقة الزمنية للسجلات بين المحلي وUTC باستخدام الأمر set logging timezone <local | UTC>.

يعرض الأمر show logging CLI فقط آخر 10 دقائق من السجلات من الوقت الحالي بشكل افتراضي.

يمكن إستخدام الكلمة الأساسية start last لتوسيع الإطار الزمني حسب الاحتياجات الفردية.

Router#show logging process btman start last ?
  <0-4294967295>  interval (default seconds)
  boot            system boot time
  clear           display all logs since last "clear logging"
  marker          selects latest matching marker from list to start displaying
                  logs from

ملاحظة: إذا أخترت قيمة عددية من الأمر السابق، يمكنك تعيين الأيام، الساعات، الدقائق أو الثواني كخيار تالي.

تمت إضافة خيارات الكلمة الأساسية end last ليتم إستخدامها بالاقتران مع start last لتحديد نهاية الإطار الزمني. عندما يتم إستخدام خياري نهاية وبدء الأخير، فإنه يتم تجميع السجلات الموجودة داخل النافذة فقط. بدون خيار النهاية الأخيرة، قم بتسجيل الإعدادات الافتراضية للمجموعة إلى الوقت الحالي كوقت الانتهاء.

هذا مثال على إعداد نافذة بين الساعتين الأخيرتين والساعة الأخيرة:

Router#show logging process btman start last 2 hours end last 1 hours
Displaying logs from the last 0 days, 2 hours, 0 minutes, 0 seconds
End time set to show logs before last 0 days, 1 hours, 0 minutes, 0 seconds
executing cmd on chassis 1 ...
Collecting files on current[1] chassis.

إظهار السجلات تحت مستوى سجل محدد

يمكنك عرض السجلات لمستوى معين فقط:

Router#show logging process wncd level ?
  debug    Debug messages
  error    Error messages
  info     Informational messages
  notice   Notice messages
  verbose  Verbose debug messages
  warning  Warning messages

هذا مثال على عنصر السجلات تحت إشعار مستوى الخطأ:

Router#show logging process btman level notice 
Logging display requested on 2024/07/24 06:20:23 (UTC) for Hostname: [Router], Model: [ASR1002-HX          ], Version: [17.12.03a], SN: [JAD22460SN9], MD_SN: [FXS2223Q74M]

Displaying logs from the last 0 days, 0 hours, 10 minutes, 0 seconds
executing cmd on chassis local ...
Unified Decoder Library Init .. DONE
Found 1 UTF Streams

2024/07/24 06:10:59.533374335 {btman_R0-0}{255}: [utm_main] [5809]: (note): Inserted UTF(2) HT(old):droputil_R0-0[13] lnode /tmp/rp/trace/droputil_R0-0.6823_63.20240724061059.bin PID:6823
2024/07/24 06:10:59.695395289 {btman_R0-0}{255}: [utm_wq] [5809:15578]: (note): Inline sync, enqueue BTF message flags:0x1, PID:15578 BTF:/tmp/rp/trace/droputil_R0-0.6823_62.20240724060959.bin

إظهار السجلات من الطابع الزمني

يمكنك عرض السجلات من ختم وقت محدد في UTC مثل هذا "2017/02/10 14:41:50.849425" هذا مثال:

Router#show logging process wncd start timestamp "2024/07/24 05:36:45.849425"
Logging display requested on 2024/07/24 06:39:15 (UTC) for Hostname: [Router], Model: [ASR1002-HX          ], Version: [17.12.03a], SN: [JAD22460SN9], MD_SN: [FXS2223Q74M]

executing cmd on chassis local ...
Unified Decoder Library Init .. DONE
Found 1 UTF Streams

Filter policy: Done with UTM processing

إظهار السجلات بين إثنين من الطابع الزمني

يمكنك عرض tracelogs بين نافذة الوقت بإضافة ختم وقت البدء وطابع وقت الانتهاء. هذا مثال مع 1 ساعة من نافذة الصيانة:

Router#show logging process wncd start timestamp "2024/07/24 05:36:45.849425" end timestamp "2024/07/24 06:36:45.849425"
Logging display requested on 2024/07/24 06:39:15 (UTC) for Hostname: [Router], Model: [ASR1002-HX          ], Version: [17.12.03a], SN: [JAD22460SN9], MD_SN: [FXS2223Q74M]

executing cmd on chassis local ...
Unified Decoder Library Init .. DONE
Found 1 UTF Streams

Filter policy: Done with UTM processing

إجراء التسجيل المباشر

يمكنك مراقبة السجلات التي تم إنشاؤها في الوقت الحقيقي لعملية أو ملف تعريف. يتم عرض السجلات عند إنشائها.

Router#monitor logging process cman ?
  <0-25>    instance number
  filter    specify filter for logs
  internal  select all logs. (Without the internal keyword only customer
            curated logs are displayed)
  level     select logs above specific level
  metadata  CLI to display metadata for every log message
  module    select logs for specific modules
        

تلميح:  للهروب أو الخروج، يصدر وضع التسجيل المباشر CTRL-C.

إستخدام ملفات تعريف السجل السابقة التعريف

يوفر التسجيل المباشر ملفات تعريف مدمجة يمكن تطبيقها بسهولة. يؤدي ذلك إلى الاستغناء عن التعرف على ملفات سجل العمليات الأساسية التي تشكل الميزة. تتضمن التوصيفات المدعومة كل، ملف، لاسلكي، sdwan، netconf-yang، restconf، install، تشخيصات الأجهزة.

يمكن إستخدام ملف التعريف مع show logging أو الأمر monitor logging .

ملاحظة: يعرض خيار show logging profile فقط السجلات من المخزن المؤقت ولا يتضمن سجلات من دليل tracelogs.

SCP_Test#show logging profile ?
  all                   all processes
  file                  show logs for specific profile file
  hardware-diagnostics  hardware diagnostics specific processes
  install               Install specific processes
  netconf-yang          netconf-yang specific processes
  restconf              restconf specific processes
  sdwan                 SDWAN specific processes
  wireless              Wireless specific processes

Router#monitor logging profile ?
  all                   all processes
  file                  show logs for specific profile file
  hardware-diagnostics  hardware diagnostics specific processes
  install               Install specific processes
  netconf-yang          netconf-yang specific processes
  restconf              restconf specific processes
  sdwan                 SDWAN specific processes
  wireless              Wireless specific processes

في 17.12+ يتم تضمين الحالات بشكل افتراضي في نهاية "show logging <process/profile/file> ...". توضح الإحصائيات عدد رسائل التتبع التي تم فك ترميزها في كل مستوى من مستويات الخطورة التي تمت إضافتها إلى حالات أداة فك الترميز الحالية. عدد المستويات خاص بالأثار المجسدة فقط.

2024/07/24 04:26:41.710239127 {btman_R0-0}{255}: [utm_wq] [5806:15568]: (note): Inline sync, enqueue BTF message flags:0x1, PID:15568 BTF:/tmp/rp/trace/IOSRP_R0-0.3437_2.20240724042222.bin
2024/07/24 04:26:41.759114843 {btman_R0-0}{255}: [utm_wq] [5806]: (note): utm delete /tmp/rp/trace/IOSRP_R0-0.3437_2.20240724042222.bin
===========================================================
======= Unified Trace Decoder Information/Statistics ======
===========================================================
----------------- Decoder Input Information ---------------
===========================================================
 Num of Unique Streams .. 1
 Total UTF To Process ... 1
 Total UTM To Process ... 89177
 UTM Process Filter ..... btman
 MRST Filter Rules ...... 1
===========================================================
----------------- Decoder Output Information --------------
===========================================================
 First UTM TimeStamp ............... 2024/07/24 02:51:45.623542304
 Last UTM TimeStamp ................ 2024/07/24 04:26:48.710794233
 UTM [Skipped / Rendered / Total] .. 89047 / 130 / 89177
 UTM [ENCODED] ..................... 130
 UTM [PLAIN TEXT] .................. 0
 UTM [DYN LIB] ..................... 0
 UTM [MODULE ID] ................... 0
 UTM [TDL TAN] ..................... 0
 UTM [APP CONTEXT] ................. 0
 UTM [MARKER] ...................... 0
 UTM [PCAP] ........................ 0
 UTM [LUID NOT FOUND] .............. 0
 UTM Level [EMERGENCY / ALERT / CRITICAL / ERROR] .. 0 / 0 / 0 / 0
 UTM Level [WARNING / NOTICE / INFO / DEBUG] ....... 0 / 130 / 0 / 0
 UTM Level [VERBOSE / NOISE / INVALID] ............. 0 / 0 / 0
===========================================================

إرسال مخرجات السجل إلى ملف

يمكنك إستخدام الكلمة الأساسية to-file لإنشاء ملف باستخدام مخرجات الأمر show logging. يوضح هذا المثال كيفية إرسال سجلات التتبع الخاصة بمسار العملية إلى ملف باسم btman_log.txt في نظام الملفات bootflash:

Router#show logging process btman to-file bootflash:btman_log.txt
Logging display requested on 2024/07/25 03:49:41 (UTC) for Hostname: [Router], Model: [ASR1006-X           ], Version: [17.09.05a], SN: [FXS221200GH], MD_SN: [FXS2221Q0EL]

Displaying logs from the last 0 days, 0 hours, 10 minutes, 0 seconds
executing cmd on chassis local ...
Files being merged in the background, please check [/bootflash/btman_log.txt] output file
Unified Decoder Library Init .. DONE

unified trace decoder estimates: [1] number of files, [139913] number of messages
         that may be processed. Use CTRL+SHIFT+6 to break.
Found 1 UTF Streams
         2024-07-25 03:49:41.694987 - unified trace decoder estimate: processed 5%
         2024-07-25 03:49:41.701433 - unified trace decoder estimate: processed 10%
         2024-07-25 03:49:41.707803 - unified trace decoder estimate: processed 15%
         2024-07-25 03:49:41.714185 - unified trace decoder estimate: processed 20%
         2024-07-25 03:49:41.720592 - unified trace decoder estimate: processed 25%
         2024-07-25 03:49:41.726951 - unified trace decoder estimate: processed 30%
         2024-07-25 03:49:41.733306 - unified trace decoder estimate: processed 35%
         2024-07-25 03:49:41.739734 - unified trace decoder estimate: processed 40%
         2024-07-25 03:49:41.746114 - unified trace decoder estimate: processed 45%
         2024-07-25 03:49:41.752462 - unified trace decoder estimate: processed 50%
         2024-07-25 03:49:41.758864 - unified trace decoder estimate: processed 55%
         2024-07-25 03:49:41.765225 - unified trace decoder estimate: processed 60%
         2024-07-25 03:49:41.771582 - unified trace decoder estimate: processed 65%
         2024-07-25 03:49:41.777968 - unified trace decoder estimate: processed 70%
         2024-07-25 03:49:41.784330 - unified trace decoder estimate: processed 75%
         2024-07-25 03:49:41.790693 - unified trace decoder estimate: processed 80%
         2024-07-25 03:49:41.797099 - unified trace decoder estimate: processed 85%
         2024-07-25 03:49:41.803462 - unified trace decoder estimate: processed 90%
         2024-07-25 03:49:41.811411 - unified trace decoder estimate: processed 95%
         2024-07-25 03:49:41.822322 - unified trace decoder estimate: processed 100%
         2024-07-25 03:49:41.822335 - unified trace decoder : processing complete Result:[Success]

يمكنك التحقق من إنشاء هذا الملف باستخدام الأمر dir bootflash وتصفية اسم الملف مثل:

Router#dir bootflash: | include btman_log.txt
17      -rw-            26939  Jul 25 2024 03:49:41 +00:00  btman_log.txt