Grafana / الأساسي: المصادر والحقول والتفسير / الدرس 3
إطارات البيانات والحقول والقيم الفارغة
فسر النتائج الجدولية والزمنية عبر حقول محددة النوع وقيم متحاذية وتسميات ومعنى null، قبل اختيار تصور أو تحويل.
في هذه الصفحة
أهداف الدرس
- اشرح أنواع الحقول ومحاذاة الصفوف.
- قارن النتائج العريضة والطويلة.
- افصل null والنتيجة الفارغة والصفر العددي.
للحقل نوع ومعنى لا اسم فقط
تتبادل تكاملات Grafana بيانات منظمة تفسرها اللوحات والتحويلات عبر إطارات وحقول. قد يحمل الحقل اسماً ونوعاً وقيماً وتسميات وإعداد عرض، مع اختلاف النقل ونموذج الإضافة. ليست سلسلة تشبه رقماً حقلاً عددياً تلقائياً، ولا يثبت اسم Time صحة معنى الطابع الزمني. سجل الوحدة والمجموعة ومعنى null بجانب النوع. قد يمثل جدول صالح ظاهرياً حد حدث خاطئاً. افحص الاستجابة قبل تحويل قد يخفي اختلاف المصدر.
افهم التمثيل العريض والطويل
قد يضم الشكل العريض حقلاً زمنياً واحداً وحقولاً عددية منفصلة للمسارين r1 وr2. وقد يضم الطويل أعمدة وقت ومسار وتأخر مع صفوف متعددة عند الوقت نفسه. كلاهما مفيد، لكن اللوحة أو التحويل قد يحتاج شكلاً أو تحويلاً معيناً. وقد تمثل إطارات متعددة نتائج استعلامات مستقلة. لا تلصقها لمجرد تطابق الأسماء؛ فقد تختلف التسميات والأوقات والوحدات والمجموعات. JSON أدناه تمثيل مفاهيمي للحقول، لا بروتوكول نقل Grafana مدعى أو لوحة قابلة للاستيراد.
{"fields":[{"name":"Time","type":"time","values":[1720000000000,1720000060000]},{"name":"delay_seconds","type":"number","values":[4,null]}]}
الأوقات التعليمية مللي ثانية منذ epoch والتأخر ثوانٍ. تعني null عدم التوفر في العينة لا صفراً مقاساً؛ وليست حمولة إضافة متحققة.
افحص محاذاة الصفوف قبل الحساب
تحتاج حقول الإطار الجدولي محاذاة صفوف وفق النموذج. يجب أن يحتل المفقود موضعاً صريحاً، لا أن يزيح ما بعده إلى وقت خاطئ. تتحقق العينة من تساوي أطوال الأعمدة، وتعد التأخر المتاح دون استبدال null. تعرض موضعين زمنيين ومشاهدة تأخر واحدة. لا تتحقق الدالة من مخطط إطار Grafana أو تعرض لوحة. يحتاج التكامل الفعلي أيضاً تحليل الوقت واتساق النوع والتسميات ومعنى المصدر، وهي أمور لا يغطيها فحص القوائم الصغير.
times = [1720000000000, 1720000060000]
delays = [4.0, None]
assert len(times) == len(delays)
observed = [value for value in delays if value is not None]
print("rows", len(times))
print("observed_values", len(observed))
print("observed_mean_seconds", sum(observed) / len(observed))
rows 2
observed_values 1
observed_mean_seconds 4.0
تُفحص قوائم ثابتة فقط. يستخدم المتوسط المتاح، ولا يدعي أن تجاهل المفقود سياسة صحيحة لكل لوحة.
لا تصلح غياب الدليل بصفر تجميلي
قد تعني null مشاهدة مفقودة أو قيمة غير مدعومة أو فشل تحويل أو حالة يحددها المصدر. وقد تعني النتيجة الفارغة عدم وجود صفوف مؤهلة أو مجموعة صُفيت. أما الصفر المقاس فقد يثبت عدم التأخر. يجعل استبدال الجميع بصفر مصدراً معطلاً يبدو منتظماً، وقد يسيء عد كل null فشلاً وصف بيانات قليلة عمداً. حدد السياسة مع مالك البيانات، واحفظ العدد والحداثة، وراجع الاختزال والتعيين منفصلين. لا يخلق وصل الفجوات في رسم قياسات لم تُرصد.
طابق متطلبات التصور مع الإطار
تحتاج لوحة السلسلة الزمنية بنية وقت وقيمة متوافقة، بينما يستطيع الجدول عرض أبعاد أخرى، ويختزل stat قيماً مختارة. لذلك قد تكون اللوحة فارغة مع أن الاستعلام أعاد بيانات بشكل غير مدعوم. افحص حقول المصدر وأنواعها والتحويلات والتصور المختار بهذا الترتيب، قبل تغيير وصول المخزن. ينفذ هذا الدرس حساب قوائم محلياً ويقدم JSON مفاهيمياً فقط. لا يُنفذ مخطط إضافة أو محول طوابع زمنية أو API إطار Grafana أو استعلام مصدر أو عارض، ويخص الخرج المتوقع العينة الثابتة وحدها.
الأخطاء الشائعة وإصلاحها
لا يظهر رقم لأنه وصل نصاً.
- لماذا يحدث؟
- يختلف نوع المصدر عن حاجة التصور.
- كيف تصلحه؟
- راجع التحويل الصريح وحالات فشله.
- كيف تتجنب تكراره؟
- احفظ عينات أنواع بقيم معلومة.
تنزاح الصفوف بعد مشاهدة مفقودة.
- لماذا يحدث؟
- قُصرت الأعمدة مستقلة.
- كيف تصلحه؟
- احفظ المواضع المتحاذية بقيم مفقودة صريحة.
- كيف تتجنب تكراره؟
- أكد توافق أطوال الحقول.
يصبح التأخر المفقود التزاماً بالموعد.
- لماذا يحدث؟
- دُمج null والصفر لراحة العرض.
- كيف تصلحه؟
- احفظ المجهول الذي يحدده المصدر.
- كيف تتجنب تكراره؟
- اختبر الفراغ وnull والصفر والقدم مستقلة.
اختبر فهمك
1. يعيد استعلام جدولاً بطابع زمني نصي وتأخر عددي. هل يضمن اختيار تصور السلسلة الزمنية رسماً صحيحاً؟
اعرض الحل المشروح
لا. يجب أن يملك الطابع الزمني نوعاً ومعنى مدعومين، وأن يطابق شكل الحقول متطلبات اللوحة. تحقق من التحليل والمنطقة الزمنية والوحدات وسلوك التحويل عبر التكامل المختار. لا يثبت اسم عمود وحده أنه حقل وقت صالح.
2. هل ينبغي استبدال قيمة التأخر الثانية المفقودة في العينة بصفر قبل عرض المتوسط؟
اعرض الحل المشروح
ليس دون سياسة قياس مبررة. يؤكد الصفر مشاهدة التزام بالموعد لا تتضمنها العينة. أبق عدد المشاهدات وحالة المفقود ظاهرين، وقرر مع مالك المصدر هل يجيب متوسط القيم المرصودة السؤال المقصود أم يظل دليلاً غير مكتمل.
أهم ما تعلمته
- تحمل الحقول النوع والمحاذاة ومعنى المصدر.
- تحتاج الأشكال المختلفة والإطارات المتعددة معالجة مقصودة.
- لا تدمج null والصفر دون عقد واضح.