تشخيص بيئة Azure Time Series Insights Gen2 واستكشاف أخطائها وإصلاحها

ملاحظة

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

تلخص هذه المقالة العديد من المشكلات الشائعة التي قد تواجهها عند العمل مع بيئة Azure Time Series Insights Gen2. توضح المقالة أيضا الأسباب والحلول المحتملة لكل مشكلة.

المشكلة: لا يمكنني العثور على بيئتي في مستكشف Gen2

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

Verify data access policies.

المشكلة: لا تظهر أي بيانات في مستكشف Gen2

هناك العديد من الأسباب الشائعة لعدم ظهور بياناتك في Azure Time Series Insights Gen2 Explorer.

  • قد لا يتلقى مصدر الحدث بيانات.

    تحقق من أن مصدر الحدث، وهو مركز أحداث أو مركز إنترنت الأشياء، يتلقى بيانات من علاماتك أو مثيلاتها. للتحقق، انتقل إلى صفحة نظرة عامة على المورد في مدخل Azure.

    Review dashboard metrics overview.

  • بيانات مصدر الحدث ليست بتنسيق JSON.

    تدعم Insights السلاسل الزمنية بيانات JSON فقط. بالنسبة لعينات JSON، اقرأ أشكال JSON المدعومة.

  • يفتقد مفتاح مصدر الحدث إلى إذن مطلوب.

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

      Verify IoT hub permissions.

      • يعمل كل من نهج iothubownerوالخدمة لأن لديهم إذن اتصال الخدمة .
    • بالنسبة إلى مركز الأحداث، تحتاج إلى توفير المفتاح الذي يحتوي على إذن استماع .

      Review event hub permissions.

      • يعمل كل من نهجي " قراءة" و" إدارة " لأن لديهما إذن "استماع ".
  • لا تقتصر مجموعة المستهلكين التي تقدمها على Insights السلاسل الزمنية.

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

  • خاصية معرف السلسلة الزمنية المحددة في وقت التوفير غير صحيحة أو مفقودة أو فارغة.

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

المشكلة: تظهر بعض البيانات، ولكن بعضها مفقود

قد تقوم بإرسال البيانات بدون معرف السلسلة الزمنية.

  • قد تحدث هذه المشكلة عند إرسال أحداث بدون الحقل معرف السلسلة الزمنية في الحمولة. لمزيد من المعلومات، اقرأ أشكال JSON المعتمدة.

  • قد تحدث هذه المشكلة بسبب اختناق البيئة الخاصة بك.

    ملاحظة

    في الوقت الحالي، تدعم Insights السلسلة الزمنية معدل ابتلاع أقصى يبلغ 1 ميجابت في الثانية.

المشكلة: كانت البيانات تظهر، ولكن الآن توقف الابتلاع

  • ربما تم تجديد مفتاح مصدر الحدث الخاص بك وتحتاج بيئة Gen2 إلى مفتاح مصدر الحدث الجديد.

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

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

Screenshot shows T S I resource with Event Sources menu item called out.

حدد مصدر (مصادر) الأحداث التي توقف الابتلاع منها، ثم الصق المفتاح الجديد وانقر فوق حفظ.

Screenshot shows T S I resource with I o T hub policy key entered.

المشكلة: لا يعمل اسم الخاصية الطابع الزمني لمصدر الحدث الخاص بي

تأكد من توافق الاسم والقيمة مع القواعد التالية:

  • اسم الخاصية الطابع الزمني حساس لحالة الأحرف.
  • تحتوي قيمة خاصية الطابع الزمني التي تأتي من مصدر الحدث كسلسلة JSON على التنسيق yyyy-MM-ddTHH:mm:ss.FFFFFFFK. مثال على هذه السلسلة هو "2008-04-12T12:53Z".

أسهل طريقة لضمان التقاط اسم خاصية الطابع الزمني الخاص بك والعمل بشكل صحيح هي استخدام السلاسل الزمنية Insights Gen2 Explorer. ضمن السلاسل الزمنية Insights Gen2 Explorer، استخدم المخطط لتحديد فترة زمنية بعد تقديم اسم خاصية الطابع الزمني. انقر بزر الماوس الأيمن فوق التحديد، وحدد خيار استكشاف الأحداث . رأس العمود الأول هو اسم خاصية الطابع الزمني. يجب أن يكون ($ts) بجانب الكلمة Timestamp، بدلا من:

  • (abc)، مما يشير إلى أن Insights السلاسل الزمنية يقرأ قيم البيانات كسلاسل.
  • يقرأ رمز التقويم، الذي يشير إلى أن Insights السلسلة الزمنية قيمة البيانات كتاريخ.
  • #، مما يشير إلى أن Insights السلاسل الزمنية يقرأ قيم البيانات كعدد صحيح.

إذا لم يتم تحديد خاصية الطابع الزمني بشكل صريح، استخدام مركز إنترنت الأشياء للحدث أو مركز الحدث Enqueued Time كطابع زمني افتراضي.

المشكلة: لا يمكنني عرض البيانات من متجري الدافئ في Explorer

  • ربما تكون قد وفرت متجرك الدافئ مؤخرا ، ولا تزال البيانات تتدفق.
  • ربما تكون قد حذفت متجرك الدافئ ، وفي هذه الحالة كنت ستفقد البيانات.

المشكلة: لا يمكنني عرض نموذج السلاسل الزمنية أو تحريره

  • ربما تقوم بالوصول إلى سلسلة زمنية Insights بيئة S1 أو S2.

    يتم دعم نماذج السلاسل الزمنية فقط في بيئات الدفع أولا بأول. لمزيد من المعلومات حول كيفية الوصول إلى بيئة S1 أو S2 من السلسلة الزمنية Insights Gen2 Explorer، اقرأ تصور البيانات في المستكشف.

    No events in environment.

  • قد لا يكون لديك أذونات لعرض النموذج وتحريره.

    يحتاج المستخدمون إلى الوصول على مستوى المساهمين لتحرير نموذج السلاسل الزمنية وعرضه. للتحقق من مستويات الوصول الحالية ومنح حق وصول إضافي، انتقل إلى قسم نهج الوصول إلى البيانات في مورد Insights السلاسل الزمنية في مدخل Azure.

المشكلة: جميع مثيلاتي في مستكشف Gen2 تفتقر إلى أحد الوالدين

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

Unparented instances will display a warning.

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