Azure Time Series Insights Gen2 مصادر الأحداث
ملاحظة
لن يتم دعم خدمة Insights السلاسل الزمنية (TSI) بعد مارس 2025. فكر في ترحيل بيئات TSI الحالية إلى حلول بديلة في أقرب وقت ممكن. لمزيد من المعلومات حول الإهمال والترحيل، يرجى زيارة وثائقنا.
يمكن أن تحتوي بيئة Azure Time Series Insights Gen2 على ما يصل إلى مصدرين لأحداث الدفق. يتم دعم نوعين من موارد Azure كمدخلات:
يجب إرسال الأحداث بتنسيق JSON المشفر من UTF-8.
إنشاء مصادر الأحداث أو تحريرها
مصدر الحدث هو الرابط بين الموزع وبيئة Azure Time Series Insights Gen2، ويتم إنشاء مورد منفصل من النوع Time Series Insights event source في مجموعة الموارد الخاصة بك. يمكن أن يعيش مركز إنترنت الأشياء أو مورد (موارد) مركز الأحداث في نفس اشتراك Azure مثل Azure Time Series Insights بيئة Gen2 أو اشتراك مختلف. ومع ذلك، فمن أفضل الممارسات إيواء بيئة Insights Azure Time Series ومحور إنترنت الأشياء أو مركز الأحداث داخل منطقة Azure نفسها.
يمكنك استخدام مدخل Azure وقوالب Azure CLIوAzure Resource Managerوواجهة برمجة تطبيقات REST لإنشاء مصادر أحداث بيئتك أو تحريرها أو إزالتها.
تحذير
لا تقيد الوصول العام إلى الإنترنت إلى موزع أو مصدر حدث تستخدمه السلسلة الزمنية Insights وإلا سيتم قطع الاتصال الضروري.
خيارات البدء
عند إنشاء مصدر حدث، يمكنك تحديد البيانات الموجودة مسبقا التي يجب جمعها. هذا الإعداد اختياري. الخيارات الآتية متاحة:
| الاسم | الوصف | مثال على قالب Azure Resource Manager |
|---|---|---|
| أقرب ما يكون متوفر | استيعاب جميع البيانات الموجودة مسبقا المخزنة داخل إنترنت الأشياء أو مركز الأحداث | "ingressStartAt": {"type": "EarliestAvailable"} |
| EventSourceCreationTime | ابدأ في استيعاب البيانات التي تصل بعد إنشاء مصدر الحدث. سيتم تجاهل أي بيانات موجودة مسبقا تم بثها قبل إنشاء مصدر الحدث. هذا هو الإعداد الافتراضي في مدخل Azure | "ingressStartAt": {"type": "EventSourceCreationTime"} |
| CustomEnqueuedTime | ستستوعب بيئتك البيانات من الوقت المخصص في قائمة الانتظار (UTC) إلى الأمام. سيتم استيعاب وتخزين جميع الأحداث التي تم وضعها في قائمة انتظار إنترنت الأشياء أو مركز الأحداث في وقت الانتظار المخصص أو بعده. سيتم تجاهل جميع الأحداث التي وصلت قبل وقت الانتظار المخصص. لاحظ أن "الوقت المدرج" يشير إلى الوقت (بالتوقيت العالمي المنسق) الذي وصل فيه الحدث إلى إنترنت الأشياء أو مركز الأحداث. يختلف هذا عن خاصية الطابع الزمني المخصص الموجودة داخل نص الحدث. | "ingressStartAt": {"type": "CustomEnqueuedTime", "time": "2021-03-01T17:00:00.20Z"} |
هام
- إذا قمت بتحديد EarliestAvailable وكان لديك الكثير من البيانات الموجودة مسبقا، فقد تواجه زمن انتقال أولي مرتفع أثناء معالجة بيئة Azure Time Series Insights Gen2 لجميع بياناتك.
- يجب أن يهدأ هذا الكمون المرتفع في النهاية مع فهرسة البيانات. أرسل تذكرة دعم من خلال مدخل Azure إذا واجهت زمن انتقال مرتفع مستمر.
- أقرب ما يكون متوفر
- EventSourceCreationTime
- CustomEnqueuedTime
أفضل ممارسات البث المباشر
قم دائما بإنشاء مجموعة مستهلكين فريدة لبيئة Azure Time Series Insights Gen2 لاستهلاك البيانات من مصدر الحدث. يمكن أن تؤدي إعادة استخدام مجموعات المستهلكين إلى قطع اتصال عشوائي وقد تؤدي إلى فقدان البيانات.
قم بتكوين Azure Time Series Insights بيئة Gen2 ومحور إنترنت الأشياء و/أو مراكز الأحداث في نفس منطقة Azure. على الرغم من أنه من الممكن تكوين مصدر حدث في منطقة منفصلة، إلا أن هذا السيناريو غير مدعوم ولا يمكننا ضمان التوافر العالي.
لا تتجاوز حد معدل الإنتاجية في بيئتك أو حد كل قسم.
قم بتكوين تنبيه تأخر ليتم إعلامك إذا كانت بيئتك تواجه مشكلات في معالجة البيانات. راجع أحمال عمل الإنتاج أدناه للاطلاع على ظروف التنبيه المقترحة.
استخدم استيعاب البث للبيانات الحديثة في الوقت الفعلي تقريبا فقط، ولا يتم دعم تدفق البيانات التاريخية.
افهم كيفية الهروب من الخصائص وتسطيح بيانات JSON وتخزينها.
اتبع مبدأ أقل امتياز عند توفير سلاسل اتصال مصدر الحدث. بالنسبة إلى مراكز الأحداث، قم بتكوين نهج وصول مشترك باستخدام مطالبة الإرسال فقط، وبالنسبة إلى IoT Hub، استخدم إذن اتصال الخدمة فقط.
تنبيه
إذا قمت بحذف مركز إنترنت الأشياء أو مركز الأحداث وإعادة إنشاء مورد جديد بنفس الاسم، فستحتاج إلى إنشاء مصدر أحداث جديد وإرفاق مركز إنترنت الأشياء أو مركز الأحداث الجديد. لن يتم استيعاب البيانات حتى تكمل هذه الخطوة.
أحمال عمل المنتجات
بالإضافة إلى أفضل الممارسات المذكورة أعلاه، نوصي بتنفيذ ما يلي لأحمال العمل الهامة للأعمال.
قم بزيادة وقت الاحتفاظ ببيانات IoT Hub أو Event Hub إلى سبعة أيام كحد أقصى.
إنشاء تنبيهات البيئة في مدخل Azure. تتيح لك التنبيهات المستندة إلى مقاييس النظام الأساسي التحقق من صحة سلوك خط الأنابيب من طرف إلى طرف. التعليمات الخاصة بإنشاء التنبيهات وإدارتها موجودة هنا. شروط التنبيه المقترحة:
- IngressReceivedMessagesTimeLag أكبر من 5 دقائق
- IngressReceivedBytes هو 0
حافظ على توازن حمل الابتلاع بين أقسام IoT Hub أو Event Hub.
استيعاب البيانات التاريخية
استخدام خط أنابيب الدفق لاستيراد البيانات السابقة غير مدعوم حاليا في Azure Time Series Insights Gen2. إذا كنت بحاجة إلى استيراد البيانات السابقة إلى بيئتك، فاتبع الإرشادات أدناه:
- لا تبث البيانات الحية والتاريخية بالتوازي. سيؤدي إدخال بيانات خارج الترتيب إلى تدهور أداء الاستعلام.
- استوعب البيانات التاريخية بطريقة مرتبة زمنيا للحصول على أفضل أداء.
- ابق ضمن حدود معدل إنتاجية الابتلاع أدناه.
- قم بتعطيل Warm Store إذا كانت البيانات أقدم من فترة الاحتفاظ ب Warm Store.
الطابع الزمني لمصدر الحدث
عند تكوين مصدر حدث، سيطلب منك تقديم خاصية معرف الطابع الزمني. يتم استخدام خاصية الطابع الزمني لتعقب الأحداث بمرور الوقت، وهذا هو الوقت الذي سيتم استخدامه كطابع $ts زمني في واجهات برمجة تطبيقات الاستعلام ولتخطيط السلاسل الزمنية في Azure Insights Explorer. إذا لم يتم توفير خاصية في وقت الإنشاء، أو إذا كانت خاصية الطابع الزمني مفقودة من حدث، استخدام الوقت المكتوب في قائمة انتظار مركز إنترنت الأشياء أو مراكز الأحداث كإعداد افتراضي. يتم تخزين قيم خصائص الطابع الزمني في UTC.
بشكل عام ، سيختار المستخدمون تخصيص خاصية الطابع الزمني واستخدام الوقت الذي أنشأ فيه المستشعر أو العلامة القراءة بدلا من استخدام الوقت الافتراضي للوحة الوصل في قائمة الانتظار. هذا ضروري بشكل خاص عندما تعاني الأجهزة من فقدان الاتصال المتقطع ويتم إعادة توجيه مجموعة من الرسائل المتأخرة إلى Azure Time Series Insights Gen2.
إذا كان الطابع الزمني المخصص ضمن كائن JSON متداخل أو صفيف، فستحتاج إلى توفير اسم الخاصية الصحيح بعد اصطلاحات التسمية الخاصة بالتسوية والهروب. على سبيل المثال، يجب إدخال الطابع الزمني لمصدر الحدث لحمولة JSON الموضحة هنا ك "values.time".
إزاحة المنطقة الزمنية
يجب إرسال الطوابع الزمنية بتنسيق ISO 8601 وسيتم تخزينها بالتوقيت العالمي المنسق. إذا تم توفير إزاحة منطقة زمنية، تطبيق الإزاحة ثم يتم تخزين الوقت وإرجاعه بتنسيق UTC. إذا تم تنسيق الإزاحة بشكل غير صحيح، تجاهلها. في الحالات التي قد لا يكون فيها الحل الخاص بك يحتوي على سياق الإزاحة الأصلية، يمكنك إرسال بيانات الإزاحة في خاصية حدث منفصلة إضافية لضمان الحفاظ عليها وأن التطبيق الخاص بك يمكن الرجوع إليه في استجابة استعلام.
يجب تنسيق إزاحة المنطقة الزمنية كواحد مما يلي:
±HHMMZ
±HH: MM
±HH: MMZ
الخطوات التالية
اقرأ قواعد JSON للتسطيح والهروب لفهم كيفية تخزين الأحداث.
فهم قيود الإنتاجية في بيئتك