المحتويات

المقدمة

نظرة عامة

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

كيف يشتغلون

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

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

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

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

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

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

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

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

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

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

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

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

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

المقدمة

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

نظرة عامة

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

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

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

كيف يشتغلون

- تسجل ميزة التتبع تفاصيل الأحداث الداخلية التي تحدث داخل الهيكل. وبشكل دوري، يتم إنشاء ملفات التتبع التي تحتوي على إخراج التتبع الكامل لوحدة نمطية وتحديثها، ويتم الاحتفاظ بهذه الملفات في دليل 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 | ت ع م>.

يعرض الأمر 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