يعيد المصدر صفوفاً لكن اللوحة فارغة

افهم الأسباب المحتملة

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

ثبت الاستجابة وعقد اللوحة بدقة

سجل نسخ Grafana والإضافة والطبعة أو الاستضافة وUID والاستعلام والمتغيرات والمدى المطلق ونوع اللوحة وآخر نسخة سليمة. استخدم استجابة افتراضية آمنة، لا بيانات عملاء. أكد أن النتيجة المفحوصة من المصدر والنطاق نفسيهما للوحة الفاشلة؛ فقد يستخدم Explore افتراضات أو اعتماداً مختلفاً. لا يقرأ الدليل خرج فاحص حقيقياً ولا يغير حساباً أو مصدراً أو استعلاماً أو لوحة أو خدمة.

افحص الحقول قبل تحويلها

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

rows = [{"route":"r1", "delay_seconds":"6"}]
value = rows[0]["delay_seconds"]
if isinstance(value, str):
    print("review-source-type-and-explicit-conversion")
elif value is None:
    print("preserve-missing-evidence")
else:
    print("inspect-frame-and-display-selection")

review-source-type-and-explicit-conversion

تتبع كل تحويل وسيط

راجع التصفية والربط والتسمية والتحويل والاختزال بالترتيب. قد يزيل مفتاح ناقص صفوفاً، ويضاعف المكرر صفوفاً، ويحذف اختزال مبكر Time قبل الحاجة إليه. قارن الأشكال الوسيطة بالعقد. يخضع تبسيط لوحة فعلية مؤقتاً لمسارها المخول؛ ولا ينفذ الدليل إجراء واجهة. افحص التجاوزات ومحددات الحقول بعد التسمية. قد يستهدف regex واسع حقلاً آخر ويختفي المقصود من الاختيار المرئي.

أصلح الاختلاف الضيق واحفظ المجهول

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

امنع تكرار المشكلة

• احفظ عقود الاستعلام والإطار والتحويل والعرض معا تحت إدارة الإصدارات. واحتفظ بعينات أسماء الحقول وأنواعها خلال ترقيات الإضافة أو المصدر، واجعل سلوك انعدام البيانات والبيانات المتقادمة صريحا. راجع القيم الافتراضية للمتغيرات وربط معرّفات UID للمصادر كلما أُعيد استخدام لوحة، حتى تقود النتائج الفارغة اللاحقة إلى تشخيص مرحلي بدلا من استبدال تجميلي بصفر.