Grafana / الأساسي: المصادر والحقول والتفسير / الدرس 2

مصادر البيانات وعقود الاستعلام

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

وقت القراءة التقريبي: 4 دقيقةتاريخ مراجعة المحتوى 2026-10-28

في هذه الصفحة

أهداف الدرس

ميّز نوع مصدر البيانات واسمه ومعرفه UID.
حدد لغة الاستعلام وسياق تنفيذه.
افصل فحص الاتصال عن صحة القياس.

يحدد التكامل معنى الاستعلام

يربط مصدر بيانات Grafana إضافة مدعومة بإعداد مخزن خلفي معين. تختلف لغات ومعاني تعبيرات Prometheus وSQL واستعلامات السجلات وبحث التتبعات. لا يجعلها Grafana متبادلة بوضعها في لوحة واحدة. سجل نوع الإضافة ونسختها ونسخة المخزن والنطاق والقياس المقصود. يحدد المرجع A استعلاماً داخل لوحة أو سلسلة تعبيرات، ولا يمثل هوية مصادقة المخزن. افصل خطأ المخزن والنتيجة وتفسير التصور عند التحقيق.

استخدم هوية ثابتة دون خلطها بالوصول

يساعد اسم عرض مصدر البيانات الناس على التعرف إليه، بينما تستخدم مراجع اللوحات وعقود التهيئة معرّفه UID. لا تعتبر إعادة تسمية المصدر إثباتا بأن كل مستهلك يشير الآن إلى البديل المقصود. قد يترك نسخ لوحة بين البيئات UID غير محلول أو مربوطا بمخزن خلفي آخر. ولا يتضمن UID إذن الاستعلام. راجع نطاق المؤسسة أو بيئة Grafana Cloud المسماة stack ونموذج الوصول الفعلي، بما فيه أي قدرة لصلاحيات مصادر البيانات في Enterprise أو Cloud. وقد لا تقيد صلاحية عرض لوحة وحدها جميع الاستعلامات التي يستطيع المستخدم إصدارها عبر مصدر متاح له.

اقرأ مقطع استعلام خاصاً بإضافة

يصف JSON هدف استعلام Prometheus تعليمياً لمقياس تأخر نقل افتراضي. ليس لوحة كاملة أو طلب إنشاء مصدر أو نداء API تنفيذياً. يجب أن يشير UID إلى تكامل مهيأ مناسب عند التكييف الفعلي. يختار التعبير مساراً واحداً ويعيد ثواني وفق عقد المقياس الافتراضي. لا يثبت قبول المحرر للنص صحة المجموعة أو معنى الوقت أو الصلاحيات. تستخدم إضافات أخرى نماذج مختلفة؛ فلا تلصق الهدف في تكامل SQL أو سجلات.

json JSON تعليمي لهدف استعلام Prometheus

{"refId":"A","datasource":{"type":"prometheus","uid":"transit-lab-prom"},"expr":"transit_departure_delay_seconds{route=\"r1\"}"}

يظهر المقطع غير التنفيذي هوية المصدر وحقول التعبير الخاصة بالإضافة فقط. لا يُستورد أو يُرسل أو يُستعلم أو يتحقق منه Grafana.

اجعل عقد الاستجابة صريحاً

ترشح العينة صفوف مسارات افتراضية وتحسب متوسط تأخر بالثواني. تثبت حساب تلك المجموعة الثابتة، لا تعبير PromQL السابق. تعتمد النتيجة على كون الصف مركبة أو انطلاقة أو فاصلاً مجمعاً؛ فقد يعطي متوسط المتوسطات وزناً خاطئاً. سجل الوحدة والوقت والتسميات ومعنى null والتجميع قبل اختيار stat. قد يعيد المصدر صفوفاً صالحة لحد عمل خاطئ. تحقق بحالة صغيرة معلومة حتى لا يستبدل رقم مقنع القياس المقصود بصمت.

python نموذج محلي لمجموعة استعلام مسار

rows = [("r1", 4.0), ("r1", 8.0), ("r2", 20.0)]
selected = [delay for route, delay in rows if route == "r1"]
print("selected_count", len(selected))
print("mean_seconds", sum(selected) / len(selected))

الناتج المتوقع

selected_count 2
mean_seconds 6.0

تُرشح صفوف ثابتة فقط. لا ينفذ Prometheus أو SQL أو سجلات أو إضافة مصدر Grafana أو استعلام خارجي.

نجاح الاتصال أضيق من النجاح الكامل

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

الأخطاء الشائعة وإصلاحها

تستعلم لوحة منسوخة بيئة خاطئة.

لماذا يحدث؟: يشير UID إلى مصدر مختلف.
كيف تصلحه؟: راجع ربط الوجهة ونطاقها.
كيف تتجنب تكراره؟: احفظ مراجع مصادر البيانات الخاصة بكل بيئة تحت إدارة الإصدارات.

يسمى نجاح الاتصال استعلاماً صحيحاً.

لماذا يحدث؟: اختلط الاتصال بالتفويض والمعنى.
كيف تصلحه؟: اختبر العقد المقصود في البيئة المخولة.
كيف تتجنب تكراره؟: افصل دليل الاتصال والقياس.

يُلصق مقطع الاستعلام في إضافة أخرى.

لماذا يحدث؟: افتُرض عموم نموذج خاص بإضافة.
كيف تصلحه؟: استخدم نموذج التكامل المدعوم.
كيف تتجنب تكراره؟: سجل نوع الإضافة ونسختها مع المثال.

اختبر فهمك

1. تستخدم لوحة وتنبيه خادمي UID نفسه لمصدر البيانات. هل يثبت ذلك تطابق قدرات التنفيذ وهوية المصادقة بينهما؟

اعرض الحل المشروح

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

2. لماذا ينبغي فحص استجابة مصدر تعيد صفوفا وفق عقد القياس؟