Grafana Beyla: قياس تلقائي عبر eBPF لخدمات HTTP وgRPC دون تعديل الشيفرة

Grafana Beyla: قياس تلقائي لخدمات HTTP وgRPC عبر eBPF دون تعديل الشيفرة. متطلبات النواة وصلاحيات Linux وحدود التتبعات وعلاقته بـ OpenTelemetry OBI.
Grafana Beyla : auto-instrumentation eBPF HTTP et gRPC sans code

Grafana Beyla أداة قياس تلقائي (auto-instrumentation) عبر eBPF: تراقب خدمات HTTP وgRPC من داخل نواة Linux وتنتج تتبعات ومقاييس RED دون تعديل الشيفرة ودون إعادة تشغيل التطبيق. وبالنسبة لفريق منصة يرث عشرات الخدمات غير المقيسة، هي طريقة سريعة للحصول على رؤية أولى.

يشرح هذا الدليل العملي ما تفعله Beyla فعلًا، وكيف تُشغَّل على حاوية، وما صلاحيات Linux التي تتطلبها، وأين تتوقف تتبعاتها، ولماذا تغيّر وضعها: فقد أُهدي الكود إلى OpenTelemetry في 2025. كل ما فيه مصدره الوثائق الرسمية لـ Grafana وOpenTelemetry. لا يعتمد المحتوى على Dynatrace SaaS ولا على Dynatrace Managed؛ ولا يربط بينهما إلا مخرج OTLP عبر واجهة خلفية متوافقة.

باختصار

  • Beyla تلتقط spans معاملات الويب ومقاييس Rate وErrors وDuration (RED) لخدمات HTTP/S وgRPC، دون تعديل الشيفرة أو إعدادات التطبيق (وثائق Grafana).
  • المتطلبات: نواة Linux 5.8 أو أحدث مع BTF؛ و5.17 أو أحدث لنشر سياق التتبع عبر ترويسات HTTP.
  • مقاييس RED هي الخيار المضمون؛ أما التتبعات فهي «مدعومة بحدود» بحسب اللغة.
  • الكود يعيش الآن في المنبع ضمن OpenTelemetry eBPF Instrumentation (OBI)؛ وBeyla هي التوزيعة التي تدعمها Grafana.

Grafana Beyla: ما الذي تراقبه الأداة وكيف

بحسب وثائق Grafana، تفحص Beyla الملفات التنفيذية للتطبيقات وطبقة الشبكة في نظام التشغيل بفضل eBPF. ومنها تستخرج spans معاملات الويب ومقاييس RED لخدمات Linux من نوع HTTP/S وgRPC. وتشمل اللغات المذكورة Go وC/C++ وRust وPython وRuby وJava (بما فيها GraalVM Native) وNode.js و.NET.

التصدير محايد تجاه المزوّد: بصيغة OpenTelemetry (OTLP) أو بمقاييس Prometheus الأصلية. كما تستمع Beyla إلى واجهة Kubernetes API لإثراء المقاييس والتتبعات ببيانات pods والخدمات الوصفية، وتتكامل مع Grafana Alloy.

لماذا يغيّر وكيل خارج العملية طريقة القياس

يقيس الوكيل التقليدي زمن الخدمة، أي الزمن المقضي داخل معالج الطلبات. أما Beyla فتراقب على مستوى شبكة النواة. وبحسب وثائقها، تعكس أزمنة الاستجابة لديها ما يراه العميل، بما في ذلك الانتظار في الطابور الداخلي. وهذا الفرق مهم لهدف مستوى خدمة (SLO) خاص بالزمن: خدمة مشبعة كل خيوطها مشغولة تبدو سريعة من الداخل وبطيئة من وجهة نظر المستخدم.

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

المتطلبات وصلاحيات Linux

تحدد الصفحة الرئيسية لوثائق Beyla الشروط التالية:

  • نواة Linux 5.8 أو أحدث مع تفعيل BTF (الملف /sys/kernel/btf/vmlinux)؛ ونواة 4.18 في عائلة RHEL 8 مدعومة أيضًا؛
  • نشر السياق عبر ترويسات HTTP: نواة 5.17 أو أحدث، لأن الأداة تستخدم الدالة المساعدة bpf_loop؛
  • تطبيقات Go المبنية بإصدار Go 1.17 أو أحدث.

تحمّل Beyla برامج eBPF وتقرأ /proc: فهي تحتاج إلى صلاحيات. وتوصي صفحة Security بمنحها القدرات اللازمة فقط بدل root الكامل. عند البدء تحذّر إذا غابت قدرة ما؛ والمتغير BEYLA_ENFORCE_SYS_CAPS=1 يجعلها تفشل فورًا.

قائمة قدرات Linux التي تتطلبها Beyla: CAP_BPF وCAP_NET_RAW وCAP_NET_ADMIN وCAP_PERFMON وCAP_SYS_PTRACE وCAP_SYS_ADMIN واستخدام كل منها

نقطة انتباه في العناقيد المُدارة: بحسب الوثائق، تأتي AKS وEKS افتراضيًا بقيمة perf_event_paranoid أعلى من 1، ما يفرض استخدام CAP_SYS_ADMIN بدل CAP_PERFMON. وغالبًا ما تستخدم توزيعات Debian القيمة 3، بالأثر نفسه. اطلب من فريق الأمن اعتماد هذا المتطلب قبل أي نشر.

تشغيل Beyla على حاوية خطوة بخطوة

أبسط طريقة للتجربة هي وضع Docker في الوثائق: حاوية Beyla تشارك فضاء PID مع الحاوية المراد قياسها.

  1. تشغيل خدمة اختبار. تستخدم الوثائق مدوّنة صغيرة بلغة Go هي mariomac/goblog:dev، تستمع عبر HTTPS على المنفذ الداخلي 8443.
  2. اختيار العملية. المتغير BEYLA_OPEN_PORT=8443 يحدد العملية التي تستمع على هذا المنفذ. وBEYLA_AUTO_TARGET_EXE يحدد العملية بمسار الملف التنفيذي (نمط glob).
  3. عرض التتبعات نصًا. BEYLA_TRACE_PRINTER=text يطبعها على الخرج القياسي، وهو مفيد للتحقق قبل التصدير.
  4. تشغيل Beyla مع --pid="container:goblog" وإما --privileged وإما القدرات المذكورة أعلاه.
أوامر docker run لخدمة goblog ثم لـ Beyla مع BEYLA_OPEN_PORT وBEYLA_TRACE_PRINTER، تليها أسطر التتبع المطبوعة
docker run -p 18443:8443 --name goblog mariomac/goblog:dev

docker run --rm \
  -e BEYLA_OPEN_PORT=8443 \
  -e BEYLA_TRACE_PRINTER=text \
  --pid="container:goblog" \
  --privileged \
  grafana/beyla:latest

كيف تتحقق من أن كل شيء يعمل

افتح https://localhost:18443 وتصفّح، ثم راقب خرج Beyla. يظهر كل طلب في سطر يتضمن المدة ورمز HTTP والطريقة والمسار والعناوين، مثل «200 GET /». إذا لم يظهر شيء، فابحث في السجلات عن تحذير القدرات الناقصة، ثم تحقق من المنفذ المختار.

الانتقال إلى ملف إعداد وإلى OTLP

للتشغيل الدائم يُنقل الإعداد إلى YAML. وبحسب الوثائق، تتغلب متغيرات البيئة على الملف. يصف القسم discovery.instrument الخدمات المستهدفة؛ ويقبل المفتاح open_ports منافذ ونطاقات (80,443,8000-8999)، ويقبل exe_path نمطًا على مسار الملف التنفيذي. وعلى Kubernetes يقبل أيضًا مرشحات مثل k8s_namespace أو k8s_deployment_name.

ملف beyla-config.yaml فيه discovery.instrument مع open_ports وebpf مع context_propagation all وotel_traces_export مع endpoint وprometheus_export مع port 8999
discovery:
  instrument:
    - open_ports: 8443
ebpf:
  context_propagation: "all"
otel_traces_export:
  endpoint: http://otel-collector:4318
prometheus_export:
  port: 8999
  path: /metrics
log_level: INFO

يجمع المثال أعلاه مفاتيح موجودة في الوثائق (عنوان Collector وهمي). وإذا كنت تستهدف Collector، فإن دليلنا عن OpenTelemetry Collector على Kubernetes يصف مسار استقبال OTLP كاملًا مع الإرسال إلى Dynatrace. ولتقليل حجم التتبعات لاحقًا، راجع أخذ العينات المتأخر (tail sampling).

منفذ Prometheus يخدم جمع مقاييس RED بواسطة خادم Prometheus؛ ومقالنا عن Prometheus وDynatrace على Kubernetes يغطي هذا الجمع.

حدود التتبعات لغةً بلغة

تقدم الوثائق مصفوفة توافق تستحق القراءة قبل الوعد بتتبعات لأي فريق. خلاصتها: Beyla هي الأمتن كطبقة أساس دون شيفرة لمقاييس RED ورسوم الخدمات، بينما تبقى SDK الخاصة بـ OpenTelemetry الخيار الموصى به للتتبعات الموزعة المفصلة.

  • Go مع HTTP وHTTP/2 وHTTPS وgRPC: التتبعات موصى بها. وGo هي الحالة الأفضل تغطية.
  • Java التقليدية وNode.js وPython وRuby: التتبعات «مدعومة بحدود».
  • Java التفاعلية أو المتغيّرة الخيوط: التتبعات غير موصى بها؛ وقد لا ترتبط spans معزولة بالتتبع الصحيح.
  • .NET: مقبولة إذا لم تكن الخدمة الأولى في السلسلة؛ وإن كانت نقطة الدخول فقد لا يعمل التتبع جيدًا.
  • خدمة مقيسة أصلًا بـ SDK الخاصة بـ OpenTelemetry: تعطّل Beyla تتبعاتها الخاصة تلقائيًا وتبقى موصى بها لمقاييس RED.

نشر السياق بين الخدمات

تعتمد التتبعات الموزعة على ترويسة W3C traceparent. تقرأ Beyla السياق الوارد، وتتابع التنفيذ، وتضيف traceparent إلى طلبات HTTP وgRPC الصادرة؛ وإذا كان التطبيق قد وضعها بالفعل فإنها تعيد استخدام تلك القيمة. أما النشر على مستوى الشبكة فهو معطّل افتراضيًا: يُفعَّل بالمتغير BEYLA_BPF_CONTEXT_PROPAGATION=all أو بالمفتاح ebpf.context_propagation. ويتطلب قدرات إضافية (CAP_NET_ADMIN وCAP_PERFMON). ولفهم ما يوفره نشر صحيح للسياق على طوابير الرسائل، اقرأ مقالنا عن نشر السياق مع Kafka.

Beyla وOBI وOpenTelemetry: أين نحن؟

تذكر وثائق Grafana أن كود Beyla أُهدي في 2025 إلى مشروع OpenTelemetry باسم OpenTelemetry eBPF Instrumentation (OBI)، وتتولى صيانته اليوم مجموعة من المساهمين من بينهم Grafana. Beyla هي توزيعة OBI التي تدعمها Grafana، وتستورد كود OBI كمكتبة. فكل ميزة في OBI موجودة في Beyla، لكن العكس غير صحيح: مقاييس العمليات (process metrics) ووضع survey والتكامل مع Alloy غير موجودة في OBI.

فرقان عمليان يُحفظان عند النشر: متغيرات بيئة OBI تبدأ بـ OTEL_EBPF_ (وBeyla تقبل البادئتين)، والمقاييس التي ليس لها اصطلاح دلالي تحمل البادئة beyla_ أو obi_. مخطط YAML هو نفسه. ويصف موقع OpenTelemetry أداة OBI بأنها أداة انطلاق لقابلية ملاحظة التطبيقات، تدعم HTTP/S وgRPC وKafka وعدة قواعد بيانات، على نواة 5.8 أو أحدث. أما الإصدار المحدد من Beyla الذي يجب تثبيته فلم يُتحقق منه هنا: راجع صفحة الإصدارات في المستودع قبل تثبيت إصدار.

تسير هذه الحركة في اتجاه معيار موحد: فإذا كنت تبني استراتيجية OpenTelemetry، فإن القياس التلقائي عبر eBPF يجد مكانه فيها دون الاعتماد على مزوّد واحد. وتضع مقارنتنا OpenTelemetry وPrometheus الإطار العام.

ما الذي يتغير بالنسبة لفريق SRE

تخفض Beyla كلفة الطبقة الأولى من قابلية الملاحظة: تحصل على مقاييس RED، أي مؤشرات مستوى خدمة (SLI) للتوفر والزمن، في خدمات لا يستطيع أحد إعادة بنائها. وهي لا تغني عن عمل القياس في الخدمات الحرجة، حيث تبقى spans الأعمال والربط بالسجلات أغنى عبر SDK. ويذكّر مقالنا قابلية الملاحظة والمراقبة بسبب تكامل هذه الإشارات.

ممارسات جيدة

  • ابدأ بخدمة واحدة وبـ BEYLA_TRACE_PRINTER=text قبل أي تصدير.
  • حدّ الاكتشاف بـ discovery.instrument على Kubernetes بدل قياس العقدة كلها.
  • اضبط مسارات (Routes Decorator) منخفضة التنوع (cardinality) للحصول على تتبعات قابلة للاستثمار، كما تنصح الوثائق.
  • امنح قدرات محددة ووثّق الاستثناء CAP_SYS_ADMIN إذا فرضته العقدة.
  • لا تجمع Beyla مع SDK على تتبعات الخدمة نفسها؛ واحتفظ بـ Beyla لمقاييس RED.
  • اختبر على نواة إنتاج مطابقة: فالمتطلبات تتوقف على إصدار النواة.

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

هل تحل Grafana Beyla محل SDK الخاصة بـ OpenTelemetry؟

لا. بحسب وثائق Grafana، Beyla هي الأقوى كطبقة أساس لمقاييس RED، بينما تبقى SDK موصى بها للتتبعات الموزعة المفصلة. ويمكن أن يتعايش الاثنان، وعندها توقف Beyla تتبعاتها الخاصة.

هل يجب إعادة تشغيل التطبيق للقياس بواسطة Beyla؟

لا. تذكر الوثائق أن Beyla تقيس دون إعادة تشغيل ودون تعديل التطبيق. لكن لا بد من منحها صلاحيات Linux اللازمة ونواة متوافقة.

هل ما زالت Beyla قيد الصيانة بعد الإهداء إلى OpenTelemetry؟

نعم. تقدمها Grafana على أنها توزيعة OBI التي تدعمها، وتوضح أن دورة إصداراتها أسرع عادةً من دورة OBI. ويذكر مستودع GitHub أيضًا أن التطوير ينتقل إلى مستودع OBI في المنبع.

الخلاصة

تقدم Beyla طريقًا قصيرًا إلى مقاييس RED وتتبعات جزئية، بثمن صلاحيات Linux مرتفعة وحدود في التتبع بحسب اللغة. جرّبها على خدمة واحدة، واقرأ مصفوفة التوافق، ثم قرر أين تبقى SDK ضرورية.

المصادر

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

Total
0
Shares
Leave a Reply

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

Previous Post
DDU Dynatrace : calculer la consommation des métriques et de la licence

DDU Dynatrace: حساب استهلاك المقاييس والترخيص

Next Post
Agent SRE AIOps : ce que promettent les plateformes

وكيل SRE AIOps: ما تعد به المنصات

Related Posts