Grafana / الأساسي: المصادر والحقول والتفسير / الدرس 6
المتغيرات واللوحات المتكررة والروابط المحددة النطاق
صمم متغيرات اللوحة كمدخلات استعلام بتنسيق خاص بالإضافة وافتراضات واضحة وتكرار محدود ونطاق تنقل آمن.
في هذه الصفحة
أهداف الدرس
- ميّز أنواع المتغيرات وطريقة إدراج قيمها.
- راجع تعدد القيم وخيار All.
- احفظ سياق الوقت والمجموعة الآمن في الروابط.
يغير المتغير مجموعة الاستعلام
يمكن أن يحمل متغير ثابتاً أو خياراً مخصصاً أو قيمة مشتقة من استعلام أو نوع مدخل آخر مدعوماً. تعتمد المرشحات المباشرة ومتغيرات مصدر البيانات على دعم التكامل وإعداده. قد تغير القيمة المختارة مجموعة كل لوحة تعتمد عليها؛ لذلك وثق الافتراضات وسلوك التحديث والاعتماديات والنطاق المسموح. يظل المتغير المخفي مدخلاً، وليس حداً للتفويض. وقد تكون الخيارات المشتقة قديمة أو فارغة أيضاً. اختبر خياراً ناقصاً وتسمية أُعيدت، بدلاً من افتراض أن اللوحة تفتح دائماً بالاختيار الذي حفظه المؤلف وبالبيانات الوصفية الحالية للمخزن.
يتبع إدراج القيم لغة الاستعلام المختارة
يدرج Grafana قيم المتغيرات وفق المصدر والتنسيق. قد يحتاج متغير مسار متعدد تنسيق regex لمطابق نمطي في Prometheus، بينما يحتاج SQL أو غيره عقداً مختلفاً. يستخدم التعبير تنسيقاً صريحاً ولم يُنفذ. ليس التنسيق ضمان معاملات SQL أو عزل مستأجر أو تفويض. تجنب raw ما لم تفهم العواقب وتراجعها. قد تغير الرموز والفراغ والتعدد المعنى. اختبر الإضافة والصياغة الفعليتين، ولا تفترض أن الاسم الصحيح بصرياً ينتج تعبير المخزن المقصود.
transit_departure_delay_seconds{route=~"${route:regex}"}
يفترض المقطع متغير route مراجعاً وتنسيق إضافة متوافقاً. لا ينشئ متغيراً أو يرسل أو يقيّم استعلاماً بعد الإدراج.
قد يوسع All والتكرار العمل بشدة
قد يعني All قيمة مخصصة أو توسيع الخيارات بحسب الإعداد. يجب ألا يتحول بصمت إلى وصول بين المستأجرين أو بيئة أوسع من القصد. تضاعف اللوحات والصفوف المتكررة الاستعلام والعرض. يضرب النموذج مسارين مختارين في ثلاث لوحات فينتج ستة مثيلات محتملة، لا عدد طلبات مخزن فعلياً. قد تغير الذاكرة والمشاركة والإخفاء والإضافة العمل الحقيقي. وضح الافتراضات، ولا تدّع أن ست لوحات تنفذ دائماً ستة استعلامات.
selected_routes = ["r1", "r2"]
panels_per_route = 3
panel_instances = len(selected_routes) * panels_per_route
print("potential_panel_instances", panel_instances)
print("backend_request_count_not_measured")
potential_panel_instances 6
backend_request_count_not_measuredيعد الناتج مثيلات منمذجة فقط. لا ينفذ تكرار Grafana أو جدولة استعلام أو عرضاً أو قياس تكلفة.
انقل سياق التنقل اللازم فقط
قد تقود روابط اللوحة واللوحة الجزئية والبيانات من نظرة إلى عرض أو حدث مرتبط. احفظ المصدر والمسار والوقت المناسبين بمتغيرات وترميز مدعومين. قد يعرض رابط يحذف البيئة دليلاً غير مرتبط فيضلل المستجيب. لا تضع اعتماداً أو حمولة خاصة أو معرفاً شخصياً غير لازم في URL. تحتاج الوجهة تفويضها ولو ظهر الرابط. قيمة الحقل مدخل غير موثوق للتنقل والتنسيق؛ فراجع الوجهات المسموحة ومعنى الاستعلام، ولا تعد كل نص معاد رابطاً آمناً.
اختبر اللوحة كمجموعة حالات مدخلات
استخدم حالات افتراضية للاختيار الافتراضي والمفرد والمتعدد وAll والفارغ والقديم والقيم ذات الرموز الخاصة. افحص المتغيرات التابعة والتخطيط المتكرر والنطاق الظاهر والروابط وعقود الاستعلام معاً. احفظ افتراضات النسخة والإضافة لأن الصياغة والقدرات تتطور. ينفذ هذا الدرس ضرباً ثابتاً فقط ويقدم مقطع استعلام غير منفذ. لا ينشئ متغيراً أو رابطاً، ولا يفتح لوحة أو يستعلم حساباً أو مصدراً. أبلغ النتيجة المحلية كنموذج توسع محتمل، واترك الإدراج والوصول والعرض الفعليين لتكامل معزول مخول مستقل.
الأخطاء الشائعة وإصلاحها
يسمى المتغير المخفي أمناً للمستأجر.
- لماذا يحدث؟
- اختلط اختيار الواجهة بالتفويض المفروض.
- كيف تصلحه؟
- طبق الوصول عند حد الثقة المناسب.
- كيف تتجنب تكراره؟
- اختبر الوصول مستقلاً عن ظهور المتغير.
يكسر التعدد استعلاماً.
- لماذا يحدث؟
- لا يطابق التنسيق لغة الاستعلام.
- كيف تصلحه؟
- استخدم إدراجاً وهروباً مراجعاً خاصاً بالمصدر.
- كيف تتجنب تكراره؟
- اختبر الفارغ والرموز الخاصة.
يثقل التكرار العرض المتوقع.
- لماذا يحدث؟
- أُهمل توسع الاختيار وتضاعف العمل.
- كيف تصلحه؟
- حد الخيارات وراجع التكلفة الفعلية المخولة.
- كيف تتجنب تكراره؟
- نمذج التضاعف قبل النشر.
اختبر فهمك
1. لماذا يجب اختبار اختيار All بدلاً من افتراض تكافئه مع جميع الاختيارات المفردة؟
اعرض الحل المشروح
قد ينتج التوسيع أو القيمة المخصصة له صياغة استعلام ومطابقة ونطاقاً مختلفاً. ويتبع إدراج القيم المتعددة إضافة مصدر البيانات أيضاً. تحقق من المجموعة المقصودة وسلوك الفراغ وحد الوصول وتوسع العمل بحالات افتراضية صريحة قبل استخدامه في لوحة مشتركة.
2. يفتح رابط التفاصيل المسار الصحيح، لكنه يستخدم مدى زمنياً آخر. هل يكفي ذلك لتشخيص حادث؟
اعرض الحل المشروح
لا. الوقت جزء من نطاق الدليل، وقد تعرض الوجهة مشاهدات غير مرتبطة. انقل الوقت والمتغيرات الآمنة المدعومة وتحقق من تفويض الوجهة. لا تضع حمولات خاصة لتعويض النطاق المفقود؛ بل استخدم حقول تنقل ثابتة مقصودة وعقد رابط واضحاً.
أهم ما تعلمته
- المتغيرات مدخلات بتنسيق خاص بالمصدر.
- يغير All والتكرار النطاق والعمل المحتمل.
- تحفظ الروابط السياق ولا تمنح الوصول.