لوحات المعلومات ككود مع Perses: بديل عن Grafana؟

لوحات المعلومات ككود مع Perses: حزم CUE وGo وأداة percli والترحيل من Grafana ومشغّل Kubernetes ورخصة Apache 2.0 وحدودها.
Tableaux de bord as code avec Perses : une alternative à Grafana ?

ينتهي حادث تشغيلي، ويعدّل أحدهم «لوحة واحدة فقط» من الواجهة. وبعد ثلاثة أشهر لا يعرف أحد لماذا تختلف لوحة الإنتاج عن لوحة ما قبل الإنتاج. تعالج لوحات المعلومات ككود هذا الانحراف: يعيش التعريف في Git، ويُراجَع عبر طلب دمج، ويُنشر من خط أنابيب آلي. ويجعل مشروع Perses التابع لمؤسسة CNCF هذه الفكرة حجته الأساسية.

ينطلق المقال من قرار تشغيلي: هل يستحق الأمر تغيير أداة العرض من أجل ذلك؟ الوقائع مأخوذة من مستودع perses/perses (ملف README وملف VERSION وسجل CHANGELOG ومجلد docs/) كما قُرئ في 11 نوفمبر 2026، ومن مستودع grafana/grafana فيما يخص الرخصة. لم أثبّت Perses لكتابة المقال، والصور المرفقة مقتطفات حقيقية من وثائق المشروع.

المدونة مستقلة. وهي لا تقارن هذه الأدوات بـ Dynatrace هنا، وكل ميزة من Dynatrace تُذكر في صفحات أخرى من الموقع تحيل إلى docs.dynatrace.com.

ما هو Perses وما ليس هو

  • أداة للوحات المعلومات: يصفه ملف README بأنه كذلك «أولًا وقبل كل شيء». يقرأ مقاييس Prometheus وتتبعات Tempo وسجلات Loki وبيانات التوصيف من Pyroscope، ومصادر أخرى عبر الإضافات.
  • الرخصة والحوكمة: رخصة Apache 2.0 (ملف LICENSE)، ومشروع بمرحلة «sandbox» في مؤسسة Cloud Native Computing Foundation. أما Grafana فيوزَّع برخصة AGPL-3.0 (README في grafana/grafana)، مع استثناءات برخصة Apache-2.0 مفصّلة في ملف LICENSING.md.
  • الإصدار المقروء: 0.55.0، نُشر في 21 أكتوبر 2026 بحسب CHANGELOG. يذكّر الرقم 0.x بأن واجهة API قد تتغير بعد، وهذا الإصدار يكسر عدة أمور: توقف دعم React 17، واشتراط Node 24، وحذف مواصفات قديمة.
  • ليس منصة متكاملة: لا تخزين للمقاييس ولا تنبيهات في الصفحات التي قرأتها هنا. يعرض Perses البيانات، وتبقى مصادرك Prometheus وأمثاله.

لم أسجّل عدد نجوم المستودع، فواجهة GitHub API لم تكن متاحة من جهازي. وعدد النجوم لا يغيّر هذا الاختيار أصلًا.

نقطة البداية: الانحراف بين الواجهة والمستودع

حين تكون الواجهة مصدر الحقيقة تتكرر ثلاث مشكلات. تتباعد النسخ بين البيئات. لا أحد يراجع التعديلات. وتصحيح الاستعلام نفسه في أربعين لوحة يستغرق يومًا كاملًا. يتبنى README الخاص بـ Perses نهجًا «GitOps-friendly»: حزم SDK ومكتبات للتكامل والنشر المستمرين CI/CD وتحققًا ساكنًا وأداة سطر أوامر أصلية.

وتبرر وثائقه اللجوء إلى الكود بالحجم: تظهر الفائدة حين تصون لوحات كثيرة يجب إبقاؤها متسقة. ومع خمس لوحات يكفيك على الأرجح تصدير JSON مؤرشف بالإصدارات. وبعد ذلك تلزم مكوّنات قابلة لإعادة الاستخدام.

كيف تعمل لوحات المعلومات ككود مع Perses

المبدأ من ثلاث خطوات: تكتب بحزمة SDK، ثم تبني ملف JSON أو YAML بصيغة Perses، ثم تطبّقه على واجهة API.

  1. الكتابة بحزمة SDK لـ CUE أو لـ Go. تقارن الوثائق بينهما: CUE أقوى في التحقق ويغطي جميع الإضافات، وGo أسهل تعلّمًا وأنسب للدمج مع كود موجود.
  2. البناء بالأمر percli dac build. يُوضع الناتج في مجلد built، بصيغة YAML افتراضيًا أو JSON مع -ojson.
  3. التحقق بالأمر percli lint. لا يتطلب خادمًا افتراضيًا، أما الخيار --online فيستعلم عن خادم Perses لاختبار التوافق مع إضافاته.
  4. النشر بالأمر percli apply -f built/mon_tableau.json.

توصي الوثائق بلوحة واحدة في كل ملف، وبالأمر percli dac build -d mon_dossier لبناء الجميع دفعة واحدة. والمتطلبات المذكورة للإصدار 0.55.0: percli بالإصدار 0.55.0 على الأقل، وcue بالإصدار 0.17.1 على الأقل لحزمة CUE.

مقتطف من مخرجات percli --help يعرض الأوامر apply وdac وlint وmigrate وschema

تلخّص الصورة الأولى العدّة: الأوامر dac وlint وapply وmigrate تغطي الدورة كاملة. ويدعم percli login الدخول برمز، أو باسم مستخدم وكلمة مرور، أو عبر مزوّد OIDC، أو بملف kubeconfig؛ وينتهي رمز الهوية بعد ساعة بحسب الوثائق.

لوحة مكتوبة بـ CUE: قراءة مثال الوثائق

تقدّم الوثائق مثالًا كاملًا. وهذه بدايته: نسمّي اللوحة، ونعلن المشروع، ثم متغيرًا يستمد قيمه من وسم في Prometheus، ثم مصدر البيانات.

مقتطف من ملف CUE لحزمة Perses SDK: اسم اللوحة والمشروع، ومتغير قيم الوسم، ومصدر بيانات Prometheus

تهم هنا نقطتان في التشغيل. الأولى أن مصدر البيانات يُعلَن في الملف نفسه، فتحمل اللوحة اعتماداتها معها. والثانية أن الحقول التي تبدأ بالرمز # معاملات لمُنشئ CUE: تُجرّد الشيفرة مرة واحدة ثم تُنشئ نسخة لكل فريق أو لكل بيئة. وهنا يقل جهد الصيانة، لأن تعديلًا في المكوّن المشترك ينتقل إلى كل اللوحات عند البناء التالي.

تنبيه: استعلامات PromQL تبقى على عاتقك. وثبات أسماء المقاييس يسهّل ذلك؛ راجع ملاحظاتنا عن قواعد التسجيل في Prometheus وعن تعدد قيم المقاييس في Kubernetes، فهما يحددان كلفة كل لوحة فرعية.

الترحيل من Grafana: ما تَعِد به الأداة فعلًا

يحوّل الأمر percli migrate لوحة Grafana إلى صيغة Perses. وتضع الوثائق حدودًا واضحة، من الأفضل قراءتها قبل أن تَعِد فريقك بترحيل:

  • تُرحَّل لوحات المعلومات وحدها، دون التنبيهات أو المستخدمين؛
  • الترحيل بأقصى جهد ممكن: Perses أحدث عهدًا ولا يغطي كل إضافات Grafana؛
  • إصدارات Grafana المدعومة من 9.0.0 إلى 11.x؛ ويُرفض نموذج Grafana 12 (المخطط v2، وقيمة apiVersion التي تبدأ بـ dashboard.grafana.app/)، فيلزم تصدير JSON التقليدي؛
  • حقل «Regex» في المتغيرات لا يُرحَّل.
بداية لوحة Node Exporter Full بعد ترحيلها بـ percli migrate: النوع Dashboard، والمدة 24h، والمتغير job

توصيتي: رحّل لوحة تجريبية واحدة، وراجع ملف YAML الناتج كما تراجع الكود، ثم قارن اللوحات الفرعية على الشاشة. اعتبر الناتج مسودة وليس تحويلًا مضمونًا.

Kubernetes: مشغّل Perses

يمكن أن تعيش التعريفات داخل العنقود أيضًا. يقدّم مستودع perses/perses-operator (رخصة Apache 2.0) موارد مخصصة لنشر نسخ Perses ولوحات المعلومات ومصادر البيانات مع مزامنة تلقائية. ويتيح استهداف نسخة بمحدِّد، وربط مساحة أسماء بمشروع Perses لعزلها. لم أختبر المشغّل، فاقرأ دليله قبل اعتماده.

أما من جهة الأمان، فإن CHANGELOG الإصدار 0.55.0 يعالج ثغرات كثيرة، منها حرجة يمكن استغلالها دون مصادقة بالإعداد الافتراضي، ويفرض مفتاح تشفير حين تكون المصادقة مفعّلة. ويرفض وكيل مصادر البيانات الآن افتراضيًا عناوين الاسترجاع المحلي وبيانات السحابة الوصفية وواجهة Kubernetes API. فإن نشرت Perses فابدأ من إصدار حديث، واقرأ صفحة «security» في الوثائق.

Perses أم Grafana: مقارنة صريحة

  • النضج: Grafana أقدم وله منظومة إضافات أوسع. ويقرّ Perses بأنه أحدث؛ والرقم 0.x والتغييرات الكاسرة بين الإصدارات تذكّر بذلك.
  • Dashboard-as-Code: هو نقطة انطلاق Perses، بأداة سطر أوامر وحزم SDK وتحقق مدمج. ويوفر Grafana أيضًا طرقًا لإدارة لوحاته ككود؛ لم أعد التحقق منها في هذا المقال، فلا أقارن بينهما ميزة بميزة.
  • النطاق: يغطي Grafana مجالات أكثر. ويركّز Perses على العرض.
  • الرخصة: Apache 2.0 لـ Perses وAGPL-3.0 لـ Grafana. إن كانت إدارتك القانونية تتجنب AGPL فللمعيار وزنه، وإلا فليس حاسمًا.
  • كلفة التغيير: إعادة بناء اللوحات وعادات الفريق أغلى من الرخصة. أما تجربته إلى جانب أداتك الحالية فكلفتها قليلة.

ولوضع الموضوع في استراتيجية أوسع، راجع OpenTelemetry وPrometheus وتثبيت Grafana Tempo مع kube-prometheus-stack، وهما مكوّنان تقرأ منهما لوحة المعلومات ككود.

ممارسات جيدة

  • لوحة واحدة في كل ملف، تُراجَع في طلب دمج، مع تشغيل percli lint في CI.
  • مكوّن مشترك لكل نوع خدمة، ثم تُنشأ منه النسخ.
  • لوحة تجريبية قبل أي دفعة ترحيل.
  • تثبيت إصدارَي percli وحزمة SDK، لأن المشروع ما زال في 0.x.
  • لا أسرار في المستودع: مصادر البيانات والرموز تبقى على الخادم.

الأسئلة الشائعة

هل يحل Perses محل Grafana؟

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

هل يجب تعلّم CUE لاستخدام Perses؟

لا. توجد حزمة Go، كما يمكن إنشاء اللوحات من الواجهة أو بملفات JSON أو YAML. وتشير الوثائق إلى أن CUE أفضل في التحقق، لكنه يتطلب تعلّمًا أطول.

هل تُرحَّل لوحات Grafana دون فقد؟

لا، فالوثائق تتحدث عن ترحيل بأقصى جهد ممكن، للإصدارات من 9.0.0 إلى 11.x ولوحات المعلومات وحدها. جرّب أولًا على حالة حقيقية.

الخلاصة

تعالج لوحات المعلومات ككود في Perses مشكلة حقيقية من الانحراف وصعوبة الصيانة، بعدّة متكاملة: حزم SDK وpercli والتحقق ومشغّل Kubernetes. ويظل المشروع حديثًا، وجاء الإصدار 0.55.0 في معظمه لسد ثغرات أمنية، فجرّبه إلى جانب أداتك الحالية. المستودع والوثائق: perses/perses وperses.dev.

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا لمشروعَي Perses وGrafana. العلامات التجارية المذكورة ملك لأصحابها. الأدوات تتطور بسرعة، فتحقق دائمًا من الأوامر والخيارات في الوثائق الرسمية.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
OpenCost Kubernetes : relier coûts et observabilité

OpenCost Kubernetes: ربط التكاليف بالمراقبة

Next Post
OpenLIT OpenTelemetry : instrumenter une application LLM sans effort

OpenLIT OpenTelemetry: تهيئة تطبيق LLM بأقل جهد

Related Posts