تكوين بيانات القياس عن بعد المستندة إلى النموذج على أجهزة Cisco IOS-XE باستخدام مجموعة Yang

المقدمة

يصف هذا المستند كيفية تكوين بيانات القياس عن بعد المستندة إلى النموذج على أجهزة Cisco IOS®-XE باستخدام مجموعة YANG لإجراء عينة من مكالمات الإجراء عن بعد لقياس بعد (RPCs).

المتطلبات الأساسية

المتطلبات

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

• ان معرفة يانڠ ضرورية لفهم البيانات المطلوبة عند إستعمال القياس عن بعد.
• معرفة عمليات NETconf، مثل get و get-config و edit-config.

المكونات المستخدمة

تستند المعلومات الواردة في هذا المستند إلى إصدارات البرامج والمكونات المادية التالية:

• CSR1000V مع Cisco IOS XE 17.3.3
• Cisco Yang Suite، الإصدار 2.8

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

المنتجات ذات الصلة

كما يمكن إستخدام هذا المستند مع إصدارات البرامج والأجهزة التالية: أجهزة Cisco IOS XE، بما في ذلك محولات Cisco Catalyst 9000 Switches وموجهات Cisco ASR 1000 و ISR 4000 و CSR 1000.

معلومات أساسية

مجموعة يانغ يجب تركيبها. لمزيد من المعلومات حول تثبيت مجموعة يانغ، قم بزيارة الوثائق أو مستودع Github.

يجب تكوين NETCONF-YANG وتشغيله على الجهاز، حتى في حالة عدم إستخدام NETconf. لمزيد من المعلومات حول تكوين NETCONF، تفضل بزيارة الوثائق.

يجب أن يكون هناك ملف تعريف للجهاز ومستودع يانغ ومجموعة نمطية يانغ مرتبطة بالجهاز موضع الاهتمام في Yang Suite. للحصول على مزيد من المعلومات حول كيفية إنشاء ملف تعريف جهاز، يقوم مستودع يانغ ومجموعة نمطية يانغ بزيارة وثائق مجموعة يانغ تحت إدارة ملفات تعريف الجهاز.

معلومات حول القياس عن بعد المستند إلى النماذج

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

يمكن للتطبيقات الاشتراك في عناصر بيانات معينة تحتاجها باستخدام نماذج بيانات YANG القائمة على المعايير عبر بروتوكولات واجهة إدارة الشبكات (gNMI) أو RESTCONF أو gRPC. يمكن أيضا إنشاء الاشتراكات باستخدام سطر الأوامر (CLI).

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

أدوار تتبع الاستخدام

في الأنظمة التي تستخدم القياس عن بعد، يتم تضمين أدوار مختلفة. في هذا المستند، يتم وصف أدوار القياس عن بعد هذه:

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

نظرة عامة على الاشتراك

الاشتراكات هي عناصر تقوم بإنشاء اقترانات بين أدوار القياس عن بعد، وتعريف البيانات التي يتم إرسالها فيما بينها.

يتم إستخدام نوعين من الاشتراكات في بيانات تتبع الاستخدام على أنظمة Cisco IOS XE: اشتراكات ديناميكية مكونة.

يتم إنشاء الاشتراكات الديناميكية بواسطة العملاء (المشترك) الذين يتصلون بالناشر، ويتم اعتبارهم طلب هاتفي. تتسبب الاشتراكات التي تم تكوينها في قيام الناشر ببدء الاتصالات بالمتلقي، ونتيجة لذلك، يتم اعتبارها اتصال هاتفي.

معرفات الاشتراك

يتم تحديد الاشتراكات بقيمة عدد صحيح موجبة 32 بت. يتم تعيين معرفات الاشتراكات التي تم تكوينها بواسطة وحدة التحكم، ويتم تعيين الاشتراكات الديناميكية بواسطة الناشر.

مواصفات مصدر البيانات

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

يدعم IOS XE من Cisco تيارين: أصلي من يانغ-push ويانغ-notif.

عادة، تتم تصفية مجموعة الأحداث من الدفق. يتم إستخدام أنواع تصفية مختلفة لأنواع دفق مختلفة.

يستخدم هذا المستند تقنية Yang-Push كنوع الدفق كما يستخدم عوامل تصفية XPath.

التكوين

تكوين اشتراك ديناميكي دوري باستخدام Yang Suite

يتم إنشاء الاشتراكات الديناميكية بواسطة المشتركين الذين يتصلون بالناشر ويستدعون لإنشاء الاشتراك باستخدام آلية ضمن هذا الاتصال، عادة، RPC. يقتصر عمر الاشتراك على مدة الاتصال بين المشترك والناشر، ويتم إرسال بيانات بيانات تتبع الاستخدام إلى ذلك المشترك فقط. لا تستمر هذه الاشتراكات في حالة إعادة تمهيد الناشر أو المشترك. يمكنك إنشاء اشتراكات ديناميكية باستخدام RPC داخل النطاق <إنشاء الاشتراك>. يتم إرسال RPC <establishment-subscription>من مشترك تتبع بيانات IETF إلى جهاز الشبكة. تكون حقول الدفق و xpath-filter والفترات في RPC إلزامية.

عند إرسال RPC، يحتوي رد RPC من ناشر على رسالة تحتوي على عنصر يحتوي على سلسلة نتائج.

يعرض هذا الجدول الاستجابة وسبب الاستجابة في رسالة <rpc-reply>:

يمكنك إرسال RPC من مجموعة Yang لتكوين اشتراك دوري.

خطوات الحصول على عامل تصفية XPath

للحصول على عامل تصفية XPath، يمكنك الاستفادة من Yang Suite بمجرد تحديد البيانات التي تحتاج إلى تدفقها. في هذا المثال، تعد معلومات إحصائيات الذاكرة هي البيانات التي سيتم تدفقها.

الخطوة 1. في "مجموعة يانغ" تحت البروتوكولات > NETCONF، حدد مجموعة YANG المرتبطة بالجهاز المستخدم. في هذا المثال تسمى مجموعة يانغ CSR1000V.

الخطوة 2. تحميل وحدة يانغ التي تحتوي على البيانات ذات الأهمية. في هذا مثال هو cisco-IOS-XE-memory-oper.

الخطوة 3. في شجرة YANG ابحث عن العقدة التي تريد الحصول على عامل تصفية XPath لها، في هذا المثال هو إحصائيات الذاكرة، انقر بزر الماوس الأيمن فوقها وحدد "خصائص".

الخطوة 4. في النافذة المنبثقة التي تظهر هناك خصائصين يعرفان معا مرشح XPath. تلك القيم هي XPath وبادئة.

خطوات إنشاء اشتراك ديناميكي NETCONF دوري

لإنشاء اشتراك ديناميكي NETCONF دوري، تحتاج إلى إستخدام الوحدة النمطية IETF-event-notification YANG.

الخطوة 1. في "مجموعة يانغ" تحت البروتوكولات > NETCONF، حدد مجموعة YANG المرتبطة بالجهاز المستخدم. في هذا المثال تسمى مجموعة يانغ CSR1000V.

الخطوة 2. تحميل الوحدة النمطية IETF-event-notifications Yang.

الخطوة 3. يجب أن تكون عملية NETCONF عبارة عن RPC آخر.

الخطوة 4. في القائمة المنسدلة "الجهاز"، حدد الجهاز محل الاهتمام، ثم انقر فوق "فتح نافذة الجهاز" في نافذة جديدة أو في علامة تبويب جديدة.

الخطوة 5. في الإطار المنفصل الذي يفتح، طقطقت يبدأ جلسة in order to خلقت نشط NETconf جلسة مع الأداة. هذا مثال على نافذة جلسة NETconf تم تأسيسها.

الخطوة 6. العودة إلى الإطار السابق. في العقد الموجودة تحت شجرة IETF-event-notification، قم بتوسيع عقدة تأسيس-الاشتراك واختر الإدخال.

الخطوة 7. تحتاج إلى تحديد قيم الدفق وعامل التصفية والتحديث.

تيار البيانات: يانغ-دفع.

عامل التصفية: xpath-filter

يجب أن يحتوي عامل تصفية XPath على هذا التنسيق:

/prefix:xpath

في هذا المثال، باستخدام المعلمات التي تم الحصول عليها في Steps للحصول على قسم عامل تصفية XPath.

/memory-ios-xe-oper:إحصائيات الذاكرة/ إحصائيات الذاكرة

تلميح: انتبه إلى موضع "/" في عامل تصفية XPath

الخطوة 8. التحديث-trigger قيمة بالسنتثوان (1/100 من الثانية). ينتج عن الفترة 1000 الحصول على التحديثات كل 10 ثوان.

الخطوة 9. بمجرد توفير قيم الدفق وعامل التصفية وقيم التحديث-المشغل، انقر فوق "إنشاء RPC" وسيظهر RPC مثل الذي يظهر في هذه الصورة.

الخطوة 10. يمكنك الآن النقر فوق تشغيل RPC وإنشاء اشتراك اتصال NETCONF دوري.

الخطوة 11. تظهر رسائل RPC الآن في النافذة التي تم إنشاء جلسة عمل NETconf فيها.

هذه الصورة هي مثال على RPC الذي تم إرساله و RPC-reply الذي تم تلقيه مع رسالة "موافق"، وهذا يعني نجاح الاشتراك.

هذه الصورة هي مثال لبيانات إحصائيات الذاكرة التي يتم استقبالها كل 10 ثوان.

تكوين اشتراك ديناميكي مستمر مع Yang Suite

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

هذا مثال على RPC لإنشاء اشتراك عند التغيير لبيانات جيران CDP.

تكوين اشتراك دوري تم تكوينه من خلال Yang Suite

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

يتم تكوين اشتراكات الطلب الهاتفي التي تم تكوينها على الجهاز باستخدام أي من هذه الأساليب:

• إستخدام واجهة سطر الأوامر (CLIs) الخاصة بالتكوين لتغيير تكوين الجهاز من خلال وحدة التحكم/vty.
• إستخدام NETconf/RESTCONF لتكوين الاشتراك المطلوب.

لا يغطي هذا المستند كيفية تكوين اشتراك طلب هاتفي باستخدام CLI، وبدلا من ذلك، فإنه يعرض كيفية إرسال رسالة NCONF RPC من مجموعة Yang Suite لتكوين اشتراك طلب هاتفي.

بالنسبة للاشتراكات التي تم تكوينها، يتوفر بروتوكول gRPC ولا يمكن إستخدامه إلا مع تدفق Yang-push. يتم دعم ترميز مخازن بروتوكول Google (kvGPB) ذات القيمة الأساسية فقط باستخدام بروتوكول نقل gRPC.

يمكنك إستخدام Yang Suite كجهاز إستقبال لاختبار نموذج اشتراكات الطلب الهاتفي.

لإنشاء اشتراك يتم تكوينه بشكل دوري، تحتاج إلى إستخدام الوحدة النمطية Cisco-IOS-XE-MDT-CFG YANG.

الخطوة 1. في مجموعة Yang، وتحت البروتوكولات > تتبع بيانات أجهزة الكمبيوتر المحمولة (gRPC)، أدخل عنوان IP ومنفذ IP، ثم انقر فوق بدء إستقبال بيانات القياس عن بعد لمجموعة Yang Suite لبدء الاستماع عند عنوان IP والمنفذ المشار إليهما.

ملاحظة: إذا لم يكن خيار تتبع بيانات الاعتماد ل gRPC متوفرا، يمكن تثبيت المكون الإضافي من خلال صفحة الإدارة > إدارة المكونات الإضافية في مجموعة YANG

الخطوة 2. تحت بروتوكولات > NETconf، حدد مجموعة YANG المرتبطة بالجهاز المستخدم. في هذا المثال تسمى مجموعة يانغ CSR1000V.

الخطوة 3. تحميل الوحدة النمطية Cisco IOS-XE-MDT-CFG Yang.

الخطوة 4. يجب أن تكون عملية NETCONF edit-config.

الخطوة 5. أختر الجهاز موضع الاهتمام.

الخطوة 6. تحت شجرة Cisco-IOS-XE-MDT-CFG يلزم تعريف هذه القيم في عقدة MDT-Subscription: معرف الاشتراك والدفق والترميز والفترة و xpath-filter. وكذلك، المعلومات حول المستقبل: عنوان بروتوكول الإنترنت، المنفذ والبروتوكول.

الخطوة 7. يتم إستخدام هذه القيم لهذا المثال:

معرف الاشتراك: 100

الدفق: يانغ-دفع

الترميز: ترميز-kvgpb

الفترة: 1000

مرشح xpath: /memory-ios-xe-oper:memory-statistics/memory-statistics

يجب تعريف المعلومات المتعلقة بالمستقبل

العنوان: <عنوان IP>

المنفذ: <port>

البروتوكول: grpc-tcp

الخطوة 8. انقر فوق الزر "إنشاء RPC".

الخطوة 9. انقر على تشغيل RPC.

الخطوة 10. في حالة نجاح هذه العملية، يتم الآن تلقي المعلومات ضمن بروتوكولات > تتبع بيانات الاعتماد على بروتوكول gRPC.

تكوين اشتراك تم تكوينه عند التغيير باستخدام Yang Suite

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

هذه الصورة هي مثال على RPC لاشتراك تم تكوينه عند التغيير.

التحقق من الصحة

استخدم هذا القسم لتأكيد عمل التكوين بشكل صحيح.

عرض معلومات حول اشتراكات تتبع الاستخدام على برنامج Cisco IOS XE مع اشتراك show telemetry IETF all.

Device# show telemetry ietf subscription all
 Telemetry subscription brief

  ID               Type        State       Filter type
  --------------------------------------------------------
  100              Configured  Valid       xpath
  2147483651       Dynamic     Valid       xpath

سرد تفاصيل حول الاشتراك مع تفاصيل <subscriptionID> show telemetryIETF.

Device#show telemetry ietf 100 detail
 Telemetry subscription detail:

  Subscription ID: 2147483651
  Type: Dynamic
  State: Valid
  Stream: yang-push
  Filter:
    Filter type: xpath
    XPath: /memory-ios-xe-oper:memory-statistics/memory-statistic
  Update policy:
    Update Trigger: periodic
    Period: 10000
  Encoding: encode-xml
  Source VRF:
  Source Address:
  Notes:

  Receivers:
    Address                                    Port     Protocol         Protocol Profile
    -----------------------------------------------------------------------------------------
   10.88.246.10                                 57344    netconf

تحقق من حالة الاتصال بجهاز الاستقبال باستخدام اتصال show telemetry الداخلي.

Device# show telemetry internal connection
Telemetry connection

Peer Address    Port  VRF Source Address  Transport  State         Profile
--------------- ----- --- --------------- ---------- ------------- -------------
10.88.246.10   57344   0 10.88.246.2    grpc-tcp   Active

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

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

السيناريو 1. إذا كانت حالة اشتراك بيانات تتبع الاستخدام صحيحة ولا تتلقى التدفقات في المستقبل.

تحقق من حالة الاتصال بالمستلم.

Device#show telemetry internal connection
Telemetry connection

Peer Address    Port  VRF Source Address  Transport  State         Profile
--------------- ----- --- --------------- ---------- ------------- -------------
10.88.246.10    57350   0 10.88.247.86    grpc-tcp   Connecting

إذا كانت الدولة تقوم بالاتصال، فتأكد من الاتصال الصحيح بين الناشر والمتلقي.

Device# ping 
     
      
     

تأكد من أن المنفذ قيد الاستخدام مفتوح.

Device# telnet 
     
      
      
        Trying 10.88.246.10, 57350 ... % Connection refused by remote host 
       
     

في هذا المثال، المنفذ غير مفتوح/يمكن الوصول إليه. تحقق من عدم وجود جدار حماية يمكنه حظر المنفذ وضمان أن المنفذ المحدد هو المنفذ الصحيح.

في الأجهزة التي تستخدم VRFs، أنت تحتاج أن يعين المصدر VRF/عنوان المصدر في ال RPC للاشتراكات المكونة. يبدي هذا صورة RPC حيث المصدر VRF عينت.

السيناريو 2. إذا كانت حالة اشتراك بيانات تتبع الاستخدام غير صحيحة.

Device# show telemetry ietf subscription all
  Telemetry subscription brief

  ID               Type        State       Filter type
  --------------------------------------------------------
  200              Configured  Invalid     xpath

تحقق من تفاصيل الاشتراك.

Device# show telemetry ietf subscription 200 detail
Telemetry subscription detail:

  Subscription ID: 200
  Type: Configured
  State: Invalid
  Stream: yang-push
  Filter:
    Filter type: xpath
    XPath: /memory-ios-xe-oper:/memory-statistics/memory-statistic
  Update policy:
    Update Trigger: periodic
    Period: 1000
  Encoding: encode-kvgpb
  Source VRF:
  Source Address:
  Notes: XPath parse error 'Invalid expression: offset(21)' 58.

  Receivers:
    Address                                    Port     Protocol         Protocol Profile
    -----------------------------------------------------------------------------------------
    10.88.247.89                               57344    grpc-tcp

لاحظ بناء جملة عامل تصفية XPath، يحتوي على "/" إضافي بعد ":"، يكون عامل تصفية XPath الصحيح:

/memory-ios-xe-oper:إحصائيات الذاكرة/ إحصائيات الذاكرة

قد يؤدي أي خطأ في بناء الجملة مثل الأحرف المفقودة أو الأحرف الإضافية في عامل تصفية XPath إلى اشتراك غير صالح.

إذا كنت بحاجة إلى دعم لأداة مجموعة Yang، فاتصل بمرسل الدعم أو بمنتدى الدعم.

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

• دليل تكوين قابلية البرمجة والقياس عن بعد المستند إلى نموذج، Cisco IOS XE Amsterdam، الإصدار 17.3.x
• الدعم التقني والمستندات - Cisco Systems