إضافة مصدر حدث مركز IoT إلى بيئة Azure Time Series Insight

  • مقالة

ملاحظة

لن يتم دعم خدمة Time Series Insights (TSI) بعد مارس 2025. ضع في اعتبارك ترحيل بيئات TSI الحالية إلى حلول بديلة في أقرب وقت ممكن. لمزيد من المعلومات حول الإهمال والترحيل، تفضل بزيارة وثائقنا.

توضح هذه المقالة كيفية استخدام مدخل Microsoft Azure لإضافة مصدر حدث يقرأ البيانات من Azure IoT Hub إلى بيئة Azure Time Series Insights.

ملاحظة

تنطبق الإرشادات الواردة في هذه المقالة على كل من بيئات Azure Time Series Insights Gen 1 وAzure Time Series Insight Gen 2.

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

  • إنشاء بيئة Azure Time Series Insights.
  • إنشاء مركز IoT باستخدام مدخل Microsoft Azure.
  • يجب أن يحتوي مركز IoT على أحداث رسائل نشطة يتم إرسالها.
  • إنشاء مجموعة مستهلكين مخصصة في مركز IoT لبيئة Azure Time Series Insight للاستهلاك منها. يجب أن يكون لكل مصدر حدث Azure Time Series Insight مجموعة مستهلكين مخصصة خاصة به لا تتم مشاركتها مع أي مستهلك آخر. إذا كان العديد من القراء يستهلكون أحداثا من نفس مجموعة المستهلكين، فمن المحتمل أن تظهر جميع القراء حالات فشل. للحصول على التفاصيل، اقرأ دليل مطور Azure IoT Hub.

إضافة مجموعة مستهلكة إلى مركز IoT

تستخدم التطبيقات مجموعات المستهلكين لسحب البيانات من Azure IoT Hub. لقراءة البيانات بشكل موثوق من مركز IoT الخاص بك، قم بتوفير مجموعة مستهلكين مخصصة تستخدمها بيئة Azure Time Series Insight هذه فقط.

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

  1. في مدخل Microsoft Azure، ابحث عن مركز IoT وافتحه.

  2. ضمن الإعدادات، حدد نقاط النهاية المضمنة، ثم حدد نقطة نهاية الأحداث .

    في صفحة Build-in Endpoints، حدد الزر Events

  3. ضمن Consumer groups، أدخل اسمًا فريدًا لمجموعة المستهلكين. استخدم هذا الاسم نفسه في بيئة Azure Time Series Insight عند إنشاء مصدر حدث جديد.

  4. حدد ⁧⁩حفظ⁧⁩.

إضافة مصدر حدث جديد

  1. تسجيل الدخول إلى ⁧⁩مدخل Microsoft Azure⁧⁩.

  2. في القائمة اليمنى، حدد ⁧⁩جميع الموارد⁧⁩. حدد بيئة Azure Time Series Insight.

  3. ضمن الإعدادات، حدد مصادر الأحداث، ثم حدد إضافة.

    حدد مصادر الأحداث، ثم حدد الزر إضافة

  4. في جزء مصدر حدث جديد ، لاسم مصدر الحدث، أدخل اسما فريدا لبيئة Azure Time Series Insight هذه. على سبيل المثال، أدخل event-stream.

  5. بالنسبة إلى Source، حدد IoT Hub.

  6. حدد قيمة لخيار الاستيراد:

    • إذا كان لديك بالفعل مركز IoT في أحد اشتراكاتك، فحدد استخدام IoT Hub من الاشتراكات المتوفرة. هذا الخيار هو أسهل نهج.

      تحديد الخيارات في جزء مصدر حدث جديد

    • يصف الجدول التالي الخصائص المطلوبة من أجل خيار Use IoT Hub from available subscriptions:

      جزء مصدر حدث جديد - خصائص لتعيينها في الخيار استخدام IoT Hub من الاشتراكات المتوفرة

      الخاصية الوصف
      الاشتراك الاشتراك الذي ينتمي إليه مركز IoT المطلوب.
      اسم IoT Hub اسم مركز IoT المحدد.
      اسم نهج مركز IoT حدد نهج الوصول المشترك. يمكنك العثور على نهج الوصول المشترك في علامة التبويب «IoT hub settings». يحتوي كل نهج وصول مشترك على اسم وأذونات قمت بتعيينها ومفاتيح الوصول. يجب أن يكون لدى نهج الوصول المشترك لمصدر الحدث أذونات اتصال الخدمة.
      اسم نهج مركز IoT يتم تعبئة المفتاح بشكل مسبق.

    • إذا كان مركز IoT خارجيا لاشتراكاتك، أو إذا كنت تريد اختيار خيارات متقدمة، فحدد توفير إعدادات IoT Hub يدويا.

      يصف الجدول التالي الخصائص المطلوبة لإعدادات توفير IoT Hub يدويا:

      الخاصية الوصف
      Subscription ID الاشتراك الذي ينتمي إليه مركز IoT المطلوب.
      مجموعة الموارد اسم مجموعة الموارد الذي تم إنشاء مركز IoT بها.
      اسم IoT Hub اسم مركز IoT. عند إنشاء مركز IoT، أدخلت اسمًا لمركز IoT.
      اسم نهج مركز IoT نهج الوصول المشترك. يمكنك إنشاء نهج الوصول المشترك في علامة التبويب «IoT hub settings». يحتوي كل نهج وصول مشترك على اسم وأذونات قمت بتعيينها ومفاتيح الوصول. يجب أن يكون لدى نهج الوصول المشترك لمصدر الحدث أذونات اتصال الخدمة.
      اسم نهج مركز IoT مفتاح الوصول المشترك المستخدم لمصادقة الوصول إلى مساحة اسم ناقل خدمة Azure. أدخل المفتاح الأساسي أو الثانوي هنا.

    • يشترك كلا الخيارين في خيارات التكوين التالية:

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

  7. أضف اسم مجموعة مستهلكين Azure Time Series Insight المخصصة التي أضفتها إلى مركز IoT الخاص بك.

  8. حدد Create.

  9. بعد إنشاء مصدر الحدث، يبدأ Azure Time Series Insight تلقائيا في دفق البيانات إلى بيئتك.

الخطوات التالية