التنميط المستمر مع Pyroscope أو Parca: من الـ span البطيء إلى الشيفرة المسؤولة

التنميط المستمر مع Pyroscope أو Parca: التراخيص وربط التتبع بالملف التعريفي وeBPF وحال ملفات OpenTelemetry، للوصول إلى الشيفرة المسؤولة عن البطء.
Profilage continu avec Pyroscope ou Parca : du span lent au code coupable

يُظهر لك التتبع البطيء أن span مدته 900 ms يقضي وقته «داخل خدمة الدفع»، وينتهي الأمر هنا. أما التنميط المستمر (continuous profiling) فيجيب عن السؤال التالي: أي دالة وأي سطر استهلك هذا الوقت من المعالج؟ تتنافس أداتان مفتوحتا المصدر في هذا المجال، هما Grafana Pyroscope وParca. ينطلق المقال من القرار الذي ستتخذه في التشغيل، لا من جولة على الواجهات.

مصدر المعلومات صفحات GitHub للمشروعين ووثائقهما الرسمية، وقد قرأتها في 11 نوفمبر 2026. لم أثبّت أيًّا من الأداتين لكتابة هذا المقال، لذلك أُشير إلى كل ما لم أتحقق منه.

إن كنت في بداية الطريق مع التتبع، فابدأ بمقال تشريح span في OpenTelemetry. يكمّل الملف التعريفي الـ span: يشرح «لماذا» حيث يعطيك التتبع «أين».

المشكلة: التتبع يقول أين، لا لماذا

يقسّم التتبع الطلب إلى spans، ويشير إلى الحلقة البطيئة، لكنه لا يشير إلى الشيفرة المسؤولة. وللتقدم أكثر يضيف الفريق عادةً سجلات، ثم spans يدوية، ثم يعيد النشر. وتُدفع كل جولة من وقت المناوبة.

يأخذ المُنمِّط (profiler) عيّنات من مكدّس الاستدعاءات على فترات منتظمة، وكلما ظهرت دالة في عدد أكبر من العيّنات دلّ ذلك على استهلاك أكبر. وحين تُعرض النتيجة بشكل flamegraph تُقرأ بنظرة واحدة. ومعنى «مستمر» أن أخذ العيّنات يعمل دائمًا في الإنتاج، لا أثناء التحقيق فقط، فيكون الملف جاهزًا عند وقوع الحادث.

التنميط المستمر: الاختيار بين Pyroscope و Parca

هذا ما تقوله المستودعات، دون استنتاج متسرّع:

  • Grafana Pyroscope: ترخيص AGPL-3.0 وحوالي 11700 نجمة في صفحة المستودع. يصف نفسه بأنه «منصة تنميط مستمر» تساعد على تتبع المشكلة حتى سطر شيفرة واحد. تصل الملفات عبر Grafana Alloy (جمع بنمط pull أو push)، أو عبر حزم SDK (Go وJava وPython وRuby وNode.js و.NET وRust)، أو عبر OTLP من مُنمِّط eBPF التابع لـ OpenTelemetry.
  • Parca: ترخيص Apache 2.0 وحوالي 5000 نجمة. يقدّم خادمًا يخزّن الملفات ويستعلم عنها عبر الزمن، وParca Agent، وهو مُنمِّط eBPF للنظام كله. تذكر صفحة المستودع اللغات C وC++ وRust وGo للوكيل.

لم تعرض صفحة GitHub التي قرأتها تاريخ آخر commit ولا الإصدارات، فتحقق منها بنفسك قبل أن تقرر. ويُختصر الاختيار في سؤالين.

  1. هل تحتاج إلى الانتقال من التتبع إلى الملف التعريفي؟ تصف وثائق Pyroscope ما تسميه «span profiles» للغات Go وJava وRuby و.NET وPython. أما في صفحات Parca التي قرأتها فلم أجد وصفًا للربط مع التتبع، ولذلك لا أجزم به.
  2. أي ترخيص تقبله شركتك؟ يفرض AGPL-3.0 التزامات إذا عدّلت الخادم وقدّمته عبر الشبكة، بينما Apache 2.0 أكثر تساهلًا. اعرض هذه النقطة على الإدارة القانونية لديك.

من الـ span البطيء إلى الملف: كيف يعمل الربط

الآلية التي توثّقها Pyroscope بسيطة. تحمل كل عيّنة وسومًا: يحدد span_id الـ span النشط لحظة أخذ العيّنة، ويحدد trace_id التتبع الذي يحتويه. والـ span الذي قد يكون له ملف يحمل السمة pyroscope.profile.id وقيمتها معرّف الـ span. تستعملها Grafana لعرض الانتقال من الـ span إلى ملفه.

مثال توضيحي لوسوم عيّنة ملف تعريفي: span_id وtrace_id والسمة pyroscope.profile.id الموضوعة على الـ span

ولكي تجد Grafana الزوج تتبع وملف، تطلب الوثائق ضبط مصدر بيانات Tempo داخلها. وهي تحيل إلى صفحة «Traces to profiles» للتفاصيل، ولم أعد قراءتها. ولإعداد Tempo راجع مقالنا عن Grafana Tempo مع kube-prometheus-stack.

الخطوات: قياس خدمة مكتوبة بلغة Go

هذا مثال الوثائق الرسمية للغة Go. يفترض أن لديك بالفعل tracer من OpenTelemetry (tp) وخادم Pyroscope على المنفذ 4040.

  1. ثبّت الوحدة: go get github.com/grafana/otel-profiling-go.
  2. شغّل حزمة SDK الخاصة بـ Pyroscope عند بدء العملية.
  3. غلّف مزوّد التتبع بالدالة otelpyroscope.NewTracerProvider.
مقطع شيفرة Go من وثائق Pyroscope: استيراد otelpyroscope وpyroscope-go، ثم pyroscope.Start مع ApplicationName وServerAddress، ثم otel.SetTracerProvider

الخطوة الثالثة هي الحاسمة: بدون الغلاف تُوجد الملفات لكنها لا تحمل span_id، فيتعذر الانتقال من التتبع. استبدل my-service والعنوان بقيمك.

ما لا يضمنه الربط

الوثائق صريحة بشأن الحدود. وهذه أهمها لمن يتناوب على الاستجابة:

  • افتراضيًا يوسَم الـ span الجذر المحلي فقط، ويشمل ملفه عيّنات الـ spans الفرعية. ويمكن في Go وJava وسم كل span.
  • وجود السمة pyroscope.profile.id لا يضمن وجود عيّنات.
  • المُنمِّط يأخذ عيّنات: قد لا تكون لـ span قصير جدًا أي عيّنة، وقد يضلل ملف قليل العيّنات.
  • تجنب أسماء الـ spans الديناميكية (عناوين URL أو استعلامات SQL) لأنها تُضعف الأداء.

والخلاصة العملية: يصلح الملف لتأكيد فرضية حول spans طويلة، لا لتفسير span مدته 2 ms. وللتمييز بين معرّفات الربط اقرأ أيضًا correlation ID أم trace ID.

Parca و eBPF: التنميط دون لمس الشيفرة

إذا كانت خدماتك مكتوبة بـ C أو C++ أو Rust أو Go ولا تريد تعديل الشيفرة، فنهج eBPF مغرٍ. يكتشف Parca Agent الأهداف من Kubernetes أو systemd ويرسل الملفات إلى الخادم. وتصف وثائق Parca تخزينًا مخصصًا تُعرَّف فيه كل سلسلة بمجموعة وسومها، مما يتيح مقارنة الملفات بين العمليات أو بين إصدارات الشيفرة.

لقطة من واجهة Parca مأخوذة من مستودع parca-dev/parca: رسم سلاسل استهلاك المعالج، ثم flamegraph مقلوب بنمط icicle ملوّن بحسب الملف التنفيذي
Source : github.com

تعرض اللقطة، وهي من المستودع المرخّص بـ Apache 2.0، رسم الاستهلاك ثم الـ flamegraph المقلوب (icicle). ولفهم ما يغيّره eBPF في التشغيل راجع eBPF و Cilium على Kubernetes.

OpenTelemetry والملفات التعريفية: أين وصل الأمر؟

تعمل OpenTelemetry على إشارة جديدة اسمها «profiles». وبحسب إعلان مدونتها الرسمية دخلت مرحلة ألفا العامة، و«لا ينبغي استخدامها في أعباء الإنتاج الحرجة». ويذكر الإعلان أيضًا أن خوادم جاهزة للإنتاج لم تكن موجودة بعد، وأن المرحلتين التاليتين هما Beta ثم GA. لم أستطع معرفة تاريخ الإعلان، فتحقق من الوضع الحالي قبل الالتزام.

عمليًا، لا تنتظر هذا المعيار لتبدأ. فبحسب ملف README الخاص بها، تقبل Pyroscope بالفعل OTLP من مُنمِّط eBPF التابع لـ OpenTelemetry.

ممارسات جيدة

  • ابدأ بخدمة حرجة واحدة، لا بالأسطول كله.
  • أبقِ أسماء الـ spans ثابتة وقليلة.
  • قِس كلفة المُنمِّط الإضافية في بيئة ما قبل الإنتاج قبل تفعيله في الإنتاج: لا أملك رقمًا موثقًا أقدّمه لك.
  • دوّن في دليل التشغيل: «span بطيء، افتح ملفه، ابحث عن أعرض دالة».
  • سجّل الترخيص الذي اخترته وتاريخ تحققك.

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

ما الفرق بين التنميط المستمر والتتبع؟

يقيس التتبع الوقت المستغرق في كل مرحلة من الطلب. أما الملف التعريفي فيأخذ عيّنات من مكدّسات الاستدعاء ويبيّن الدوال التي تستهلك المعالج أو الذاكرة. والاثنان يكمّل أحدهما الآخر.

Pyroscope أم Parca: أيهما أختار؟

إذا أردت الانتقال من span إلى ملفه داخل Grafana فوثائق Pyroscope تصف ذلك. وإذا كان eBPF دون تعديل الشيفرة وترخيص Apache 2.0 هما الأهم فجرّب Parca. جرّب الاثنتين على خدمة واحدة قبل الحسم.

وماذا عن Dynatrace؟

يتناول هذا المقال أدوات مفتوحة المصدر من أطراف ثالثة فقط. وللاطلاع على ما تقدمه Dynatrace في هذا المجال راجع docs.dynatrace.com مع التفريق بين SaaS و Managed، فلا أخلط هنا بين أي ميزة وأخرى.

الخلاصة

يحوّل التنميط المستمر عبارة «الـ span بطيء» إلى «هذه الدالة هي المسؤولة»، بشرط أن تربط الملفات بالتتبع. اختر بحسب الترخيص والربط مع تتبعاتك ولغتك. المصادر: وثائق Pyroscope ووثائق Parca.

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

Total
0
Shares
Leave a Reply

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

Previous Post
Tutoriel eBPF : apprendre pas à pas avec bpf-developer-tutorial

تعلم eBPF خطوة بخطوة مع bpf-developer-tutorial

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

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

Related Posts