مصنف المعلمات

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

عند استخدام المصنفات، يمكنك التحكم في كيفية تقديم عناصر تحكم المعلمات للمستهلكين. يمكن أن تكون مربع نص مقابل قائمة منسدلة، مفردة مقابل متعددة التحديد، وقيم من النص أو JSON أو KQL أو Azure Resource Graph.

تتضمن أنواع المعلمات المدعومة:

• الوقت - يسمح لك بتحديد من النطاقات الزمنية المسبقة المملوءة أو تحديد نطاق مخصص
• قائمة منسدلةتسمح لك بالاختيار من بين قيمة أو مجموعة من القيم
• مجموعة الخيارات: تسمح لك بتحديد قيمة واحدة من مجموعة معروفة
• النص: يسمح لك بإدخال نص عشوائي
• المعايير: يسمح لك بتحديد مجموعة من المعايير استنادا إلى المعلمات المحددة مسبقا، والتي سيتم تقييمها لتوفير قيمة ديناميكية
• المورد - يسمح لك بتحديد المورد أو أكثر من موارد Azure
• اشتراك - يسمح لك بتحديد واحد أو أكثر من موارد اشتراك Azure
• متعدد القيم: يسمح لك بتعيين قيمة نصية عشوائية واحدة أو أكثر
• نوع المورد - يسمح لك بتحديد قيمة واحدة أو أكثر من قيم نوع مورد Azure
• الموقع - يسمح لك بتحديد قيمة واحدة أو أكثر من قيم مواقع Azure

الرجوع إلى معلمة

يمكنكم الرجوع إلى قيم المعلمة في أجزاء أخرى من المصنفات إما باستخدام الروابط أو باستخدام توسيع القيمة.

الرجوع إلى معلمة مع روابط

يوضح المثال كيفية الإشارة إلى معلمة نطاق زمني ذات روابط:

1. حدد إضافة استعلام لإضافة عنصر تحكم استعلام، ثم حدد مورد Application Insights.

2. افتح القائمة المنسدلة النطاق الزمني وحدد الخيار النطاق الزمني من قسم المعلمات في الأسفل:

   • يؤدي هذا الرأي إلى ربط معلمة النطاق الزمني بالنطاق الزمني للمخطط.
   • النطاق الزمني لاستعلام العينة هو الآن آخر 24 ساعة.

3. شغّل الاستعلام لرؤية النتائج.

   

الإشارة إلى معلمة باستخدام KQL

يوضح المثال كيفية الإشارة إلى معلمة نطاق زمني باستخدام KQL:

1. حدد إضافة استعلام لإضافة عنصر تحكم استعلام، ثم حدد مورد Application Insights.

2. خلال KQL، أدخل عامل تصفية نطاق الوقت باستخدام المعلمة | where timestamp {TimeRange}:

   • يتم توسيع هذه المعلمة في وقت تقييم الاستعلام إلى| where timestamp > ago(1d).
   • هذا الخيار هو قيمة النطاق الزمني للمعلمة.

3. شغّل الاستعلام لرؤية النتائج.

   

الإشارة إلى معلمة مع نص

يوضح المثال كيفية الإشارة إلى معلمة نطاق زمني مع نص:

1. أضف «عنصر تحكم النص» إلى المصنف.
2. في Markdown، أدخل The chosen time range is {TimeRange:label}.
3. حدد تم التحرير.
4. يظهر عنصر تحكم النص النطاق الزمني المختار هو آخر 24 ساعة.

خيارات تنسيق المعلمات

يحتوي كل نوع معلمة على خيارات التنسيق الخاصة به. استخدم القسم الإصدارات الأولية في تحرير المعلمة لمشاهدة خيارات توسيع التنسيق لمعلمتك.

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

تشمل أنواع المعلمات الأخرى:

• منتقي الموارد: يتم تنسيق معرفات الموارد.
• منتقي الاشتراك: يتم تنسيق قيم الاشتراك.

تحويل toml إلى json

بناء الجملة: {param:tomltojson}

القيمة الأصلية:

name = "Sam Green"

[address]
state = "New York"
country = "USA"

القيمة المنسقة:

{
  "name": "Sam Green",
  "address": {
    "state": "New York",
    "country": "USA"
  }
}

إلغاء JSON

بناء الجملة: {param:escapejson}

القيمة الأصلية:

{
	"name": "Sam Green",
	"address": {
		"state": "New York",
		"country": "USA"
  }
}

القيمة المنسقة:

{\r\n\t\"name\": \"Sam Green\",\r\n\t\"address\": {\r\n\t\t\"state\": \"New York\",\r\n\t\t\"country\": \"USA\"\r\n  }\r\n}

ترميز النص إلى base64

بناء الجملة: {param:base64}

القيمة الأصلية:

Sample text to test base64 encoding

القيمة المنسقة:

U2FtcGxlIHRleHQgdG8gdGVzdCBiYXNlNjQgZW5jb2Rpbmc=

تنسيق المعلمات باستخدام JSONPath

بالنسبة لمعلمات السلسلة التي هي محتوى JSON، يمكنك استخدام JSONPath في سلسلة تنسيق المعلمة.

على سبيل المثال، قد يكون لديك معلمة سلسلة تسمى selection كانت نتيجة استعلام أو تحديد في مرئيات لها القيمة التالية:

{ "series":"Failures", "x": 5, "y": 10 }

باستخدام JSONPath، يمكنك الحصول على قيم فردية من هذا العنصر:

نمط المعلمة

تتوفر الأنماط التالية للمعلمات.

الحبوب

نمط الأقراص هو النمط الافتراضي. تبدو المعلمات مثل النص وتتطلب من المستخدم تحديدها مرة واحدة للانتقال إلى وضع التحرير.

قياسي

في النمط القياسي، تكون عناصر التحكم مرئية دائماً، مع تسمية أعلى عنصر التحكم.

نموذج أفقي

في النمط الأفقي للنموذج، تكون عناصر التحكم مرئية دائما، مع التسمية على الجانب الأيسر من عنصر التحكم.

نموذج عمودي

في النمط العمودي للنموذج، تكون عناصر التحكم مرئية دائما، مع التسمية أعلى عنصر التحكم. على عكس النمط القياسي، هناك تسمية أو عنصر تحكم واحد فقط في صف واحد.

معلمات عمومية

الآن بعد أن تعلمت كيفية عمل المعلمات، والقيود حول القدرة فقط على استخدام معلمة "انتقال البيانات من الخادم" للمكان الذي تم تعيينها فيه، فقد حان الوقت للتعرف على المعلمات العمومية، التي تغير هذه القواعد.

مع معلمة عمومية، يجب أن تظل المعلمة معلنة قبل أن يمكن استخدامها. ولكن أي خطوة تعين قيمة لتلك المعلمة ستؤثر على جميع مثيلات هذه المعلمة في المصنف.

الاستخدامات الشائعة للمعلمات العمومية:

1. مزامنة النطاقات الزمنية بين العديد من المخططات:

   • بدون معلمة عمومية، سيتم تصدير أي فرشاة نطاق زمني في مخطط بعد ذلك المخطط فقط. لذلك، سيؤدي تحديد نطاق زمني في المخطط الثالث إلى تحديث المخطط الرابع فقط.
   • باستخدام معلمة عمومية، يمكنك إنشاء معلمة timerange عمومية، ومنحها قيمة افتراضية، واستخدام جميع المخططات الأخرى ذلك كنطاق زمني محدد وإخراج فرشاة الوقت. بالإضافة إلى ذلك، قم بتعيين إعداد تصدير المعلمة فقط عند تعيين نطاق. يحدث أي تغيير في النطاق الزمني في أي مخطط معلمة timerange العمومية في أعلى المصنف. يمكن استخدام هذه الوظيفة لجعل المصنف يعمل كلوحة معلومات.

2. السماح بتغيير علامة التبويب المحددة في خطوة ارتباطات عبر الارتباطات أو الأزرار:

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

إنشاء معلمة عمومية

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

ستكون المعلمة متاحة وستعمل كما تفعل المعلمات العادية.

تحديث قيمة معلمة عمومية موجودة

بالنسبة لمثال المخطط، الطريقة الأكثر شيوعا لتحديث معلمة عمومية هي باستخدام تفريش الوقت.

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

كلما تم تحديد نطاق زمني في هذا المخطط، فإنه يقوم أيضا بتحديث معلمة timerange أعلى هذا الاستعلام، وخطوة الاستعلام نفسها، لأنها تعتمد أيضا على timerange.

1. قبل الفرشاة:

   • يظهر النطاق الزمني على أنه آخر ساعة.
   • يعرض المخطط الساعة الأخيرة من البيانات.

   

2. أثناء الفرشاة:

   • لا يزال النطاق الزمني هو الساعة الأخيرة، ويتم رسم المخططات التفصيلية للتفريش.
   • لم تتغير أي معلمات. بعد ترك الفرشاة، يتم تحديث النطاق الزمني.

   

3. بعد الفرشاة:

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

   

   إشعار

   إذا لم تستخدم معلمة عمومية، فستتغير قيمة معلمة timerange فقط أسفل خطوة الاستعلام هذه. لن يتم تحديث الأشياء الموجودة أعلى هذه الخطوة أو هذا العنصر نفسه.