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

ملاحظة

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

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

ملاحظة

تنطبق الخطوات الموضحة في هذه المقالة على كل من بيئات Azure Time Series Insights Gen 1 وAzure Time Series Insights Gen 2.

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

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

إضافة مجموعة مستهلكين إلى مركز الأحداث

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

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

1. في مدخل Microsoft Azure، حدد موقع مثيل مركز الحدث وافتحه من جزء Overview لمساحة اسم مركز الأحداث. حدد Entities > Event Hubs أو ابحث عن المثيل الخاص بك ضمن Name.

   

2. في مثيل مركز الأحداث، حدد Entities > Consumer groups. ثم حدد + مجموعة المستهلكين لإضافة مجموعة مستهلكين جديدة.

   

   وإلا، حدد مجموعة مستهلكين موجودة وانتقل إلى القسم التالي.

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

4. حدد Create.

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

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

2. حدد موقع بيئة Azure Time Series Insights الحالية. في القائمة اليسرى، حدد All resources، ثم حدد بيئة Azure Time Series Insights.

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

   

4. أدخل قيمة لاسم مصدر الحدث الفريد لبيئة Azure Time Series Insights هذه، مثل Contoso-TSI-Gen 1-Event-Hub-ES.

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

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

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

     

   • يصف الجدول التالي الخصائص المطلوبة لخيار استخدام مركز الأحداث من الاشتراكات المتوفرة :

     

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

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

     يصف الجدول التالي الخصائص المطلوبة للخيار توفير إعدادات مركز الأحداث يدويا :

     الخاصية	الوصف
     Subscription ID	الاشتراك الذي ينتمي إليه مثيل مركز الحدث المطلوب ومساحة الاسم.
     مجموعة الموارد	مجموعة الموارد التي ينتمي إليها مثيل مركز الحدث المطلوب ومساحة الاسم.
     مساحة اسم Event Hub	مساحة اسم مركز الحدث التي ينتمي إليها مثيل مركز الحدث المطلوب.
     اسم Event Hub	اسم مثيل مركز الحدث المطلوب.
     قيمة نهج Event Hub	حدد نهج الوصول المشترك المطلوب. يمكنك إنشاء نهج الوصول المشترك في علامة التبويب تكوين مركز الحدث. يحتوي كل نهج وصول مشترك على اسم وأذونات تقوم بتعيينها ومفاتيح الوصول. يجب أن يكون لدى نهج الوصول المشترك لمصدر الحدث أذونات قراءة.
     مفتاح نهج Event Hub	مفتاح الوصول المشترك المستخدم لمصادقة الوصول إلى مساحة اسم ناقل خدمة Microsoft Azure. أدخل المفتاح الأساسي أو الثانوي هنا.

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

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

7. أضف اسم مجموعة مستهلك Azure Time Series Insights المخصص الذي أضفته إلى مركز الأحداث الخاص بك.

8. حدد Create.

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

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

• حدد نهج الوصول إلى البيانات لتأمين البيانات.

• إرسال الأحداث إلى مصدر الحدث.

• الوصول إلى بيئتك في Azure Time Series Insights Explorer.