Grafana / المتوسط: التحويلات والإعداد والتنبيهات / الدرس 9

JSON اللوحات وتهيئتها وإدارتها بالهوية

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

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

في هذه الصفحة

أهداف الدرس

ميّز UID اللوحة ومعرفها المحلي ونسخة مخططها.
اشرح تهيئة الملفات مقابل تغييرات الواجهة.
افحص الموارد المشار إليها قبل نقل لوحة.

العنوان ليس هوية لوحة كاملة

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

اقرأ الإعداد دون افتراض اكتماله

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

json مقطع تعليمي لتعريف لوحة تقليدية

{"uid":"transit-lab-overview","title":"Transit Lab Overview","panels":[]}

المقطع غير كامل وغير منفذ. لا يثبت مخطط Grafana أو توافق API أو إنشاء مورد أو ربط مصادر قابل للنقل.

اختر مصدر حقيقة للإعداد المدار

تستطيع تهيئة الملفات إدارة اللوحات والمصادر في نشر ذاتي مدعوم، بسلوك تحديث وحذف موثق. لا تعيد كتابة المصدر تلقائياً بمجرد تعديل واجهة مسموح للوحة مهيأة؛ وقد يستبدل تحديث تهيئة لاحق حالة القاعدة. راجع إعداد السماح بتعديل الواجهة والحذف، ولا تفترض أن الحفظ إدارة إعداد دائمة. تختلف حدود الملكية والقدرات في Cloud وAPIs وموفري Terraform وغيرهم. اختر الآلية المخولة والنسخة قبل تصميم النشر أو النسخ أو الرجوع.

افحص المراجع المحلية والتفرد قبل المراجعة

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

python عينة محلية لمراجع الإعداد

import json
raw = '{"uid":"transit-lab-overview","panels":[{"id":1,"source_uid":"transit-lab-prom"},{"id":2,"source_uid":"transit-lab-prom"}]}'
document = json.loads(raw)
known_sources = {"transit-lab-prom"}
ids = [panel["id"] for panel in document["panels"]]
assert len(ids) == len(set(ids))
assert all(panel["source_uid"] in known_sources for panel in document["panels"])
print(document["uid"], "panels", len(ids))

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

transit-lab-overview panels 2

source_uid حقل سجل تعليمي، وليس حقلاً مدعى في مخطط Grafana. تُفحص بيانات JSON وافتراضات جرد ثابتة فقط.

راجع الفرق الدلالي وافتراضات الرجوع

يجب أن يشرح تغيير اللوحة السلوك الذي يواجه المستخدم، وتغير الاستعلام والمصدر، وافتراضات المتغيرات، وأثر الوصول، والتحقق. تجنب الاكتفاء بفرق تسلسلي ضخم تخفي فيه حقول التخطيط المولدة مقاماً تغير. احفظ الإعداد المعتمد وربط البيئة، وافهم كيف تستعيدهما آلية الإدارة المختارة. ينفذ هذا الدرس فحوص JSON محلية فقط. لا يستورد لوحة، أو يكتب حالة Grafana، أو يشغل موفر تهيئة، أو يغير ملفاً تراقبه خدمة. تبقى صياغة الإعداد وسلوك دورة الحياة الفعليان خصائص منصة لم تُختبر.

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

يُستخدم العنوان معرفاً عاماً.

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

يُستبدل تعديل الواجهة المهيأ دون توقع.

لماذا يحدث؟: بقي الملف مرجعاً وفق الآلية.
كيف تصلحه؟: راجع سياسة التحديث ومصدر الحقيقة الموثقين.
كيف تتجنب تكراره؟: نسّخ التغيير في مصدره المعتمد.

يسمى JSON الصالح لوحة مختبرة.

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

اختبر فهمك

1. لماذا قد تضر إعادة استخدام UID لوحة في بيئة أخرى دون مراجعة ربط الموارد؟

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

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

2. ما الذي تثبته عينة بايثون، وما جوانب Grafana التي تتركها دون اختبار؟