إرسال الأحداث إلى سلسلة زمنية Azure Insights بيئة Gen1 باستخدام مركز أحداث

  • مقالة
  • قراءة خلال 3 دقائق

ملاحظة

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

تنبيه

هذه مقالة Gen1.

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

تكوين مركز أحداث

  1. لمعرفة كيفية إنشاء مركز أحداث، اقرأ وثائق مراكز الأحداث.

  2. في مربع البحث، ابحث عن مراكز الأحداث. في القائمة التي تم إرجاعها، حدد مراكز الأحداث.

  3. حدد مركز الحدث.

  4. عند إنشاء مركز أحداث، فأنت تنشئ مساحة اسم لمركز الأحداث. إذا لم تكن قد أنشأت بعد مركزا للأحداث داخل مساحة الاسم، فقم بإنشاء مركز أحداث في القائمة، ضمن الكيانات.

    List of event hubs

  5. بعد إنشاء مركز أحداث، حدده في قائمة محاور الأحداث.

  6. من القائمة، ضمن كيانات، حدد مراكز الأحداث.

  7. حدد اسم مركز الأحداث لتكوينه.

  8. ضمن نظرة عامة، حدد مجموعات المستهلكين، ثم حدد مجموعة المستهلكين.

    Create a consumer group

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

    هام

    تأكد من عدم استخدام مجموعة المستهلكين هذه بواسطة أي خدمة أخرى، مثل وظيفة Azure Stream Analytics أو بيئة أخرى Insights من السلسلة الزمنية من Azure. إذا تم استخدام مجموعة المستهلكين من قبل الخدمات الأخرى ، فإن عمليات القراءة تتأثر سلبا لكل من هذه البيئة والخدمات الأخرى. إذا كنت تستخدم $Default كمجموعة مستهلكين، فقد يعيد القراء الآخرون استخدام مجموعة المستهلكين.

  10. من القائمة، ضمن الإعدادات، حدد نهج الوصول المشترك، ثم حدد إضافة.

    Select Shared access policies, and then select the Add button

  11. في جزء إضافة نهج وصول مشترك جديد ، قم بإنشاء وصول مشترك باسم MySendPolicy. يمكنك استخدام نهج الوصول المشترك هذا لإرسال الأحداث في أمثلة C # لاحقا في هذه المقالة.

    In the Policy name box, enter MySendPolicy

  12. ضمن مطالبة، حدد خانة الاختيار إرسال .

إضافة مثيل Insights Azure Time Series

في Azure Time Series Insights Gen2، يمكنك إضافة بيانات سياقية إلى القياس عن بعد الوارد باستخدام نموذج السلسلة الزمنية (TSM). في TSM، يشار إلى علاماتك أو إشاراتك على أنها مثيلات، ويمكنك تخزين البيانات السياقية في حقول المثيلات. يتم ضم البيانات في وقت الاستعلام باستخدام معرف السلسلة الزمنية. معرف السلسلة الزمنية لمشروع طواحين الهواء النموذجية الذي نستخدمه لاحقا في هذه المقالة هو id. لمعرفة المزيد حول تخزين البيانات في حقول المثيل، اقرأ نظرة عامة على نموذج السلسلة الزمنية .

إنشاء مصدر أحداث Azure Time Series Insights

  1. إذا لم تكن قد أنشأت مصدر حدث، فأكمل الخطوات لإنشاء مصدر حدث.

  2. تعيين قيمة ل timeSeriesId. لمعرفة المزيد حول معرف السلسلة الزمنية، اقرأ نماذج السلاسل الزمنية.

دفع الأحداث إلى عينة طواحين الهواء

  1. في شريط البحث، ابحث عن مراكز الأحداث. في القائمة التي تم إرجاعها، حدد مراكز الأحداث.

  2. حدد مثيل مركز الأحداث.

  3. انتقل إلى سياسات> الوصول المشتركMySendPolicy. انسخ قيمة مفتاح الاتصال الأساسي للسلسلة.

    Copy the value for the primary key connection string

  4. انتقل إلى https://tsiclientsample.azurewebsites.net/windFarmGen.html. يقوم عنوان URL بإنشاء وتشغيل أجهزة طواحين الهواء المحاكاة.

  5. في المربع سلسلة اتصال مركز الحدث على صفحة ويب، الصق سلسلة الاتصال التي نسختها في حقل إدخال طاحونة الهواء.

    Paste the primary key connection string in the Event Hub Connection String box

  6. حدد انقر للبدء.

    تلميح

    يقوم محاكي طاحونة الهواء أيضا بإنشاء JSON يمكنك استخدامه كحمولة مع Azure Time Series Insights واجهات برمجة تطبيقات GA Query.

    ملاحظة

    سيستمر جهاز المحاكاة في إرسال البيانات حتى يتم إغلاق علامة تبويب المتصفح.

  7. ارجع إلى مركز الأحداث في مدخل Azure. في صفحة نظرة عامة ، يتم عرض الأحداث الجديدة التي يتلقاها مركز الأحداث.

    An event hub Overview page that shows metrics for the event hub

أشكال JSON المدعومة

المثال الأول

  • الإدخال: كائن JSON بسيط.

    {
    "id":"device1",
    "timestamp":"2016-01-08T01:08:00Z"
}

  • الإخراج: حدث واحد.

    المعرف طابع زمني
    device1 2016-01-08T01:08:00Z

المثال الثاني

  • الإدخال: صفيف JSON مع كائنين JSON. يتم تحويل كل كائن JSON إلى حدث.

    [
    {
        "id":"device1",
        "timestamp":"2016-01-08T01:08:00Z"
    },
    {
        "id":"device2",
        "timestamp":"2016-01-17T01:17:00Z"
    }
]

  • الإخراج: حدثان.

    المعرف طابع زمني
    device1 2016-01-08T01:08:00Z
    device2 2016-01-08T01:17:00Z

المثال الثالث

  • الإدخال: كائن JSON مع صفيف JSON متداخل يحتوي على كائنين JSON.

    {
    "location":"WestUs",
    "events":[
        {
            "id":"device1",
            "timestamp":"2016-01-08T01:08:00Z"
        },
        {
            "id":"device2",
            "timestamp":"2016-01-17T01:17:00Z"
        }
    ]
}

  • الإخراج: حدثان. يتم نسخ موقع مكان الإقامة إلى كل حدث.

    الموقع events.id events.timestamp
    ويستوس device1 2016-01-08T01:08:00Z
    ويستوس device2 2016-01-08T01:17:00Z

المثال الرابع

  • الإدخال: كائن JSON مع صفيف JSON متداخل يحتوي على كائنين JSON. يوضح هذا الإدخال أنه يمكن تمثيل الخصائص العمومية بواسطة كائن JSON المعقد.

    {
    "location":"WestUs",
    "manufacturer":{
        "name":"manufacturer1",
        "location":"EastUs"
    },
    "events":[
        {
            "id":"device1",
            "timestamp":"2016-01-08T01:08:00Z",
            "data":{
                "type":"pressure",
                "units":"psi",
                "value":108.09
            }
        },
        {
            "id":"device2",
            "timestamp":"2016-01-17T01:17:00Z",
            "data":{
                "type":"vibration",
                "units":"abs G",
                "value":217.09
            }
        }
    ]
}

  • الإخراج: حدثان.

    الموقع manufacturer.name الشركة المصنعة.الموقع events.id events.timestamp events.data.type events.data.units events.data.value
    ويستوس الشركة المصنعة1 إيست أوس device1 2016-01-08T01:08:00Z الضغط المبادره 108.09
    ويستوس الشركة المصنعة1 إيست أوس device2 2016-01-08T01:17:00Z اهتزاز القيمة المطلقة G 217.09

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