مشاركة طرق العرض المخصصة مع عناوين URL ذات المعلمات - Azure Time Series Insights

مقالة
05/02/2022
قراءة خلال 3 دقائق

ملاحظة

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

لمشاركة طريقة عرض مخصصة في Azure Time Series Insights Explorer، يمكنك برمجيا إنشاء عنوان URL معلمات لطريقة العرض المخصصة.

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

تلميح

شاهد العرض التوضيحي المجاني ل Azure Time Series Insights.
اقرأ وثائق Azure Time Series Insights Explorer المرفقة.

معرف البيئة

تحدد المعلمة environmentId=<guid> معرف البيئة الهدف. إنه أحد مكونات FQDN للوصول إلى البيانات، ويمكنك العثور عليه في الزاوية العلوية اليسرى من نظرة عامة على البيئة في مدخل Azure. إنه كل ما يسبق env.timeseries.azure.com.

مثال على معلمة معرف البيئة هو ?environmentId=10000000-0000-0000-0000-100000000108.

الوقت

يمكنك تحديد قيم زمنية مطلقة أو نسبية باستخدام عنوان URL ذي معلمات.

قيم الوقت المطلقة

بالنسبة للقيم الزمنية المطلقة، استخدم المعلمات from=<integer> و to=<integer> .

from=<integer> هي قيمة في جافا سكريبت بالمللي ثانية من وقت البدء لنطاق البحث.
to=<integer>هي قيمة في جافا سكريبت بالمللي ثانية من وقت الانتهاء لنطاق البحث.

تلميح

لترجمة التواريخ بسهولة إلى جافا سكريبت بالمللي ثانية، جرب محول الطابع الزمني Epoch & Unix.

قيم الوقت النسبية

للحصول على قيمة زمنية نسبية، استخدم relativeMillis=<value>، حيث تكون القيمة في جافا سكريبت بالمللي ثانية من أحدث طابع زمني تم استلامه من واجهة برمجة التطبيقات.

على سبيل المثال، &relativeMillis=3600000 يعرض أحدث 60 دقيقة من البيانات.

تتوافق القيم المقبولة مع قائمة الوقت السريع Azure Time Series Insights Explorer، وتشمل:

1800000 (آخر 30 دقيقة)
3600000 (آخر 60 دقيقة)
10800000 (آخر 3 ساعات)
21600000 (آخر 6 ساعات)
43200000 (آخر 12 ساعة)
86400000 (آخر 24 ساعة)
604800000 (آخر 7 أيام)
2592000000 (آخر 30 ساعة)

المعلمات الاختيارية

تحدد المعلمة timeSeriesDefinitions=<collection of term objects> مصطلحات المسند التي ستظهر في طريقة عرض Azure Time Series Insights:

المعلمة	عنصر عنوان URL	الوصف
الاسم	`\<string>`	اسم المصطلح.
سبليت باي	`\<string>`	اسم العمود المراد تقسيمه حسب.
اسم التدبير	`\<string>`	اسم عمود القياس.
المسند	`\<string>`	العبارة حيث للتصفية من جانب الخادم.
useSum	`true`	معلمة اختيارية تحدد استخدام المجموع للقياس.

ملاحظة

إذا Events كان مقياس useSum المحدد، يتم تحديد العدد افتراضيا. إذا Events لم يتم تحديده، يتم تحديد المتوسط افتراضيا. |

multiChartStack=<true/false> يتيح زوج القيمة الرئيسية التراص في المخطط.
multiChartSameScale=<true/false> يتيح زوج القيمة الرئيسية نفس مقياس المحور Y عبر المصطلحات ضمن معلمة اختيارية.
timeBucketUnit=<Unit>&timeBucketSize=<integer> يمكنك من ضبط شريط تمرير الفاصل الزمني لتوفير عرض أكثر دقة أو سلاسة وتجميعا للمخطط.
تمكنك المعلمة timezoneOffset=<integer> من تعيين المنطقة الزمنية للمخطط ليتم عرضه كإزاحة إلى UTC.

الزوج (الزوجات)	الوصف
`multiChartStack=false`	`true` يتم تمكينه افتراضيا ، لذا قم بالمرور `false` إلى المكدس.
`multiChartStack=false&multiChartSameScale=true`	يجب تمكين التراص لاستخدام نفس مقياس المحور Y عبر المصطلحات. يتم ذلك `false` افتراضيا ، لذا فإن المرور `true` يمكن هذه الوظيفة.
`timeBucketUnit=<Unit>&timeBucketSize=<integer>`	الوحدات = `days`, , , , `minuteshoursseconds`, `milliseconds`. قم دائما برسملة الوحدة. حدد عدد الوحدات عن طريق تمرير العدد الصحيح المطلوب ل timeBucketSize.
`timezoneOffset=-<integer>`	يكون العدد الصحيح دائما بالمللي ثانية.

ملاحظة

يمكن تنعيم قيم timeBucketUnit لمدة تصل إلى 7 أيام. قيم timezoneOffset ليست UTC ولا بالتوقيت المحلي.

أمثلة

لإضافة تعريفات السلاسل الزمنية إلى بيئة Insights السلسلة الزمنية Azure كمعلمة URL، قم بإلحاق:

&timeSeriesDefinitions=[{"name":"F1PressureId","splitBy":"Id","measureName":"Pressure","predicate":"'Factory1'"},{"name":"F2TempStation","splitBy":"Station","measureName":"Temperature","predicate":"'Factory2'"},
{"name":"F3VibrationPL","splitBy":"ProductionLine","measureName":"Vibration","predicate":"'Factory3'"}]

استخدم أمثلة تعريفات السلاسل الزمنية من أجل:

معرف البيئة
آخر 60 دقيقة من البيانات
المصطلحات (F1PressureID و F2TempStation و F3VibrationPL) التي تضم المعلمات الاختيارية

يمكنك إنشاء عنوان URL ذي المعلمات التالية لطريقة عرض:

https://insights.timeseries.azure.com/classic/samples?environmentId=10000000-0000-0000-0000-100000000108&relativeMillis=3600000&timeSeriesDefinitions=[{"name":"F1PressureId","splitBy":"Id","measureName":"Pressure","predicate":"'Factory1'"},{"name":"F2TempStation","splitBy":"Station","measureName":"Temperature","predicate":"'Factory2'"},{"name":"F3VibrationPL","splitBy":"ProductionLine","measureName":"Vibration","predicate":"'Factory3'"}]