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

إشعار

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

توضح هذه المقالة كيفية استخدام مدخل 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 لمساحة اسم مركز الحدث. حدد مراكز أحداث الكيانات > أو ابحث عن المثيل الخاص بك ضمن الاسم.

   

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

   

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

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

4. حدد إنشاء.

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

1. قم بتسجيل الدخول إلى بوابة 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. بالنسبة للمصدر، حدد Event Hub.

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

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

     

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

     

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

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

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

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

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

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

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

8. حدد إنشاء.

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

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

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

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

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