Grafana / المتوسط: التحويلات والإعداد والتنبيهات / الدرس 8
تجاوزات الحقول وتعيين القيم والعتبات
وجه قواعد العرض إلى الحقول المقصودة، وميّز تعيين القيم وعتباتها من تحويل المصدر والتفويض وتقييم التنبيه.
في هذه الصفحة
أهداف الدرس
- اشرح الافتراضات ومحددات الحقول.
- راجع تعيين القيمة والمدى والنمط والحالات الخاصة.
- فسر العتبات المطلقة والنسبية في العرض.
التجاوز قاعدة عرض مشروطة
توفر افتراضات الحقول إعدادات مشتركة، بينما تختار التجاوزات حقولاً بمحددات مدعومة مثل الأسماء أو الأنماط أو الأنواع أو سياق مرتبط بالاستعلام. تعتمد خيارات المحدد الدقيقة على النسخة والتصور. راجع جميع القواعد المطابقة وأثرها المجمع، ولا تفترض أن إعداداً مرئياً واحداً يمثل الإعداد الكامل. قد توقف إعادة تسمية المصدر محدداً دقيقاً عن العمل، بينما يؤثر نمط واسع في حقل عدد غير مقصود. احفظ معنى الحقل الثابت ووحدته في العقد. يغير التجاوز سلوك العرض، وليس إذن مخزن أو بديلاً عن بيانات ذات نوع صحيح.
استهدف حقل المدة لا كل رقم
يطبق مقطع إعداد الحقول التقليدي وحدة الثواني على delay_seconds فقط، بينما يشترك في افتراض المنازل العشرية. المقطع غير كامل كلوحة، ولم يُستورد أو يُعرض. قد يعيد مصدر حقلاً آخر بالاسم المرئي نفسه وهوية مختلفة، لذا افحص الإطارات الفعلية وسلوك المحدد المختار. لا تزيد المنازل العشرية المعروضة دقة المصدر. لا ينبغي أن يشترك حقل عدد وحقل مدة في وحدة واحدة لمجرد أنهما عدديان. راجع أسماء الحقول المتوقعة وغير المتوقعة بعينة قبل الاعتماد على لوحة يعاد استخدامها عبر مصادر.
{"fieldConfig":{"defaults":{"decimals":1},"overrides":[{"matcher":{"id":"byName","options":"delay_seconds"},"properties":[{"id":"unit","value":"s"}]}]}}
يوضح JSON محدد byName التقليدي وخاصية الوحدة فقط. ليس لوحة كاملة أو تجاوز Grafana مختبراً.
يجب أن يحفظ الاسم الودي الحالة الأصلية
تعرض التعيينات قيماً أو نطاقات أو مطابقات نمطية أو حالات خاصة بنص ولون مفهومين وفق الدعم. سم الصفر الحقيقي التزاماً بالموعد فقط إن أيده العقد. تختلف null والقدم وخطأ الاستعلام، فلا تجعلها كلها سليمة. لا يثبت regex على نص صحة البيانات أو ينقح حمولة خاصة. احفظ وسيلة لفحص القيمة والنوع الأصليين. قد يحسن التعيين الفهم ويخفي تمييزاً مهماً إن أسيء تصميمه.
ليست عتبات العرض قواعد تنبيه
تقارن العتبات المطلقة بقيم ضمن مقياس الحقل. وتعتمد أوضاع النسبة في العرض على معنى المدى المهيأ أو المحسوب، لا تلقائياً على مئين أو نسبة أخطاء خدمة. يوضح المصنف حدوداً مطلقة افتراضية ومجهولاً صريحاً، ولا ينفذ عتبات Grafana أو يقرر سياسة نقل. لا يرسل اللون إشعاراً بذاته. عرّف واختبر استعلام التنبيه وتقييمه مستقلاً إذا احتاج الحد المفاهيمي نفسه، ولا تفترض أن إعداد اللوحة يتحكم في القاعدة الخادمية.
def display_band(delay):
if delay is None:
return "unknown"
if delay < 10:
return "normal"
return "warning" if delay < 30 else "critical"
for value in (9, 10, 30, None):
print(value, display_band(value))
9 normal
10 warning
30 critical
None unknown
تختبر الحدود الافتراضية الانتقال عند القيم فقط. لا ينفذ تعيين Grafana أو عارض عتبات أو قاعدة تنبيه.
تحقق من التفاعل وإمكانية الوصول
اختبر الحقول العادية والحدية والمتطرفة والصفرية وnull والمعاد تسميتها وذات النوع غير المتوقع. راجع الافتراضات والتجاوزات والتعيين والوحدة والاختزال والتصور معاً، لأن تفاعلها يحدد النتيجة. قدم نصاً أو إشارة أخرى متاحة عندما يحمل اللون حالة مهمة. أبق الدليل الخام متاحاً عبر مسار المصدر المخول، دون كشف قيم خاصة في الروابط. ينفذ هذا الدرس مصنفاً محلياً فقط، ولا يفحص نسخة Grafana أو أولوية محدد أو مخططاً أو عرضاً. يصف المقطع والمراجع الأساس المختار، ويتركان الواجهة والإضافة الفعليتين لتكامل مخول مستقل.
الأخطاء الشائعة وإصلاحها
يحول تجاوز نمطي عدداً إلى ثوانٍ.
- لماذا يحدث؟
- اختار المحدد حقولاً أكثر من القصد.
- كيف تصلحه؟
- افحص الهوية الفعلية وضيق القاعدة.
- كيف تتجنب تكراره؟
- اختبر المتشابه والمعاد تسميته.
تُعين null إلى طبيعي.
- لماذا يحدث؟
- دُمج المجهول بقياس سليم.
- كيف تصلحه؟
- احفظ حالة عدم توفر مستقلة.
- كيف تتجنب تكراره؟
- أدرج المفقود والقديم في المراجعة.
يُفترض أن اللوحة الحمراء تستدعي شخصاً.
- لماذا يحدث؟
- اختلطت العتبة المرئية بالتقييم.
- كيف تصلحه؟
- عرّف القاعدة والتوصيل المستقلين.
- كيف تتجنب تكراره؟
- تحقق من العرض والإشعار منفصلين.
اختبر فهمك
1. لماذا قد يفشل تجاوز حقل يعتمد اسمه الدقيق بعد هجرة مصدر بيانات؟
اعرض الحل المشروح
قد يعاد اسم الحقل، أو ينقسم إلى إطارات، أو يظهر باسم وبنية تسميات مختلفين. قد يتوقف التطابق أو يستهدف حقلاً آخر. قارن عقد المخرج الفعلي ومعنى المحدد المدعوم قبل تعديل العرض، واحفظ عينة قيمة معلومة للمدة المقصودة.
2. هل يمكن تفسير عتبة عرض بالنسبة المئوية على أنها p95 أو هدف لميزانية الخطأ؟
اعرض الحل المشروح
لا. يعتمد معناها على الحقل وإعداد المدى. يحتاج المئين ونسبة الأحداث حسابات مصدر أو استعلام صحيحة مستقلة. وثق الكمية أولاً ثم اختر قاعدة العرض، وأبق أي عتبة تنبيه معرفة ومختبرة بصورة مستقلة.
أهم ما تعلمته
- تختار التجاوزات حقولاً ولا تعيد تعريف القياس.
- يجب أن تحفظ التعيينات والعتبات المجهول.
- قواعد العرض والتنبيه عقدان منفصلان.