سجلات OpenTelemetry المستقرة: هل ترحّل منظومة السجلات؟

سجلات OpenTelemetry المستقرة: ما تضمنه الحالة وما تتركه مفتوحًا بحسب اللغة، وثلاث استراتيجيات لترحيل منظومة السجلات لديك.
Logs OpenTelemetry stables : faut-il migrer sa stack de logs ?

هل تغيّر سجلات OpenTelemetry المستقرة شيئًا في منظومة السجلات لديك؟ وفق صفحة حالة مواصفات OpenTelemetry، فإن Bridge API وSDK وبروتوكول OTLP الخاصة بالسجلات موسومة بالحالة «Stable». وبالنسبة إلى فريق SRE أو فريق المنصة، لم يعد السؤال «هل هي جاهزة؟» بل «ماذا نرحّل، وبأي ترتيب؟».

تقدّم هذه المقالة شبكة قرار: ما الذي يضمنه وصف «مستقر» وما الذي لا يضمنه، وثلاث استراتيجيات للترحيل، وطريقة التحقق من النتيجة. وهي تأتي بعد الدرس العملي عن ربط السجلات بالتتبعات عبر trace_id الذي يعرض الخطوات التقنية. أما هنا فنقرّر. النقاط الخاصة بـ Dynatrace تخص Dynatrace SaaS؛ وفي Dynatrace Managed راجع وثائق إصدارك.

باختصار

  • Bridge API وSDK وOTLP الخاصة بالسجلات «Stable»؛ ويتبع Collector حالة البروتوكول (صفحة حالة OpenTelemetry).
  • يختلف النضج بحسب اللغة: Java و.NET وC++ وPHP وRust «Stable»، وGo في «Release candidate»، وPython وJavaScript ما زالتا في «Development».
  • لا شيء يفرض استبدال كل شيء: تهدف OpenTelemetry إلى العمل مع السجلات التي تنتجها أصلًا.
  • أفضل خطوة أولى هي الأصغر: الإبقاء على مكتبة السجلات الحالية وإضافة appender من OpenTelemetry أو receiver للملفات.

سجلات OpenTelemetry المستقرة: ماذا يعني «مستقر»

تصنّف صفحة Specification Status Summary كل إشارة بحسب المكوّن. في قسم Logging تكون Bridge API وSDK والبروتوكول «Stable». ويُنشر نموذج البيانات مع OTLP، وتعرضه الصفحة المخصصة لنموذج بيانات السجلات بالحالة «Stable» أيضًا. وتوضح الصفحة أن حالة Collector تتبع حالة البروتوكول لكل إشارة.

جدول قسم Logging في صفحة حالة OpenTelemetry: Bridge API وSDK وبروتوكول OTLP بالحالة Stable، وCollector متوافق مع البروتوكول

عمليًا، تعني الحالة المستقرة في المواصفات أن عقد النموذج والبروتوكول لا ينبغي أن ينكسر بعد الآن. يحمل سجل الحدث ضمن حقوله Timestamp وTraceId وSpanId وSeverityText وSeverityNumber وBody وResource وAttributes. والخطورة رقمية: من 1 إلى 4 لـ TRACE، ومن 9 إلى 12 لـ INFO، ومن 17 إلى 20 لـ ERROR، ومن 21 إلى 24 لـ FATAL.

انتبه: المواصفات ليست هي التنفيذ. فالحالة المستقرة في المواصفات لا تخبرك شيئًا عن نضج SDK في لغتك، ولا عن نضج اصطلاحات الدلالات (semantic conventions).

ما لا تضمنه الحالة المستقرة

اللغة تغيّر كل شيء

تعطي صفحة Language APIs & SDKs حالة لكل لغة ولكل إشارة. وبالنسبة إلى السجلات، الجدول غير متكافئ.

جدول من وثائق OpenTelemetry: حالة التتبعات والمقاييس والسجلات بحسب اللغة، السجلات Stable في Java و.NET وC++ وPHP وRust، وRelease candidate في Go، وDevelopment في Python وJavaScript

إذا كانت خدماتك بلغة Java أو .NET فمسار SDK ناضج. وإذا كانت بلغة Python أو JavaScript فإشارة السجلات فيهما ما زالت «Development» وقت قراءة تلك الصفحة: قد تتغير واجهة API. هذا لا يمنع استخدامها، لكنه يفرض تثبيت الإصدارات وإعادة قراءة ملاحظات الإصدار عند كل تحديث. والدرس العملي عن الربط يستخدم Python تحديدًا: فهو ميدان تجريب جيد، لا أساس يُعمَّم دون ضمانات.

اصطلاحات الدلالات

تحذّر الصفحة نفسها من أن عمليات القياس (instrumentation) المعتمدة على اصطلاحات دلالات تجريبية قد تتعرض لتغييرات غير متوافقة، أيًا كانت حالة API أو SDK. عمليًا قد يتغير اسم سمة بين إصدارين. لذلك ينبغي أن تمرّ استعلاماتك وتنبيهاتك ولوحاتك عبر طبقة توحيد بدل استخدام الأسماء الخام في كل مكان.

Receiver الملفات

تمرّ كثير من عمليات الترحيل عبر Collector الذي يقرأ الملفات. يشير ملف README الخاص بـ receiver filelog إلى مستوى «beta» للسجلات. وهذا البيان منفصل عن حالة البروتوكول: البروتوكول مستقر، أما هذا المكوّن تحديدًا فليس كذلك بعد.

ثلاث استراتيجيات للترحيل

الاستراتيجية 1: لا تغيّر شيئًا، أضف جسرًا

تتناول وثائق OpenTelemetry حول السجلات المبدأ التالي: تواصل استخدام مكتبة السجلات لديك وتضبطها بـ appender (أو bridge) يرسل إلى exporter. وBridge API موجّهة إلى مؤلفي المكتبات؛ ولا حاجة إلى أن تستدعيها التطبيقات مباشرة. الميزة: شيفرة التطبيق لا تتغير. المخاطرة: مستوى النضج يتوقف على اللغة (انظر أعلاه).

وتشير صفحة المفاهيم أيضًا إلى أنه متى كان القياس التلقائي أو SDK فعّالًا، تربط OpenTelemetry السجلات بالتتبّع وبالـ span النشطين. وهذا هو المكسب الأكثر واقعية: يصل trace_id دون عمل مطابقة بالتوقيت.

الاستراتيجية 2: إبقاء الملفات والقراءة عبر Collector

إذا كانت تطبيقاتك تكتب سجلات JSON في ملفات أو على المخرج القياسي، يستطيع Collector قراءتها دون المساس بالشيفرة. المقطع التالي مأخوذ من README الخاص بالـ receiver: يقرأ ملفات JSON ويستخرج الطابع الزمني.

مقطع YAML من README الخاص بـ receiver filelog: include على /var/log/myservice/*.json ومشغّل json_parser مع timestamp وparse_from بالقيمة attributes.time
receivers:
  file_log:
    include: [ /var/log/myservice/*.json ]
    operators:
      - type: json_parser
        timestamp:
          parse_from: attributes.time
          layout: '%Y-%m-%d %H:%M:%S'

تفاصيل يجب معرفتها، بحسب README: الخيار include إلزامي، وقيمة start_at الافتراضية هي end (فالملف الذي لم تعد الكتابة فيه جارية لا يُعاد قراءته)، ومن دون امتداد تخزين (storage) لا تصمد مواضع القراءة بعد إعادة التشغيل. وهذه النقطة الأخيرة مهمة للموثوقية: إعادة تشغيل Collector دون تخزين قد تسبب فجوات أو تكرارًا. وتختلف أسماء الـ receiver بين الإصدارات (filelog أو file_log): اعتمد وثائق الإصدار المنشور لديك.

الاستراتيجية 3: ترحيل كامل إلى OTLP

تُرسل كل الخدمات عبر OTLP، ويركّز Collector المسار، ويختفي وكيل السجلات القديم. هذا هو الهدف الأنظف لكنه الأكثر مخاطرة: فهو يجمع تغيير الشيفرة وخط المعالجة (pipeline) والوجهة. ويكون مبررًا حين تكون لديك أصلًا التتبعات والمقاييس في OpenTelemetry، كما يصف OpenTelemetry Collector نحو Dynatrace، وتكون كلفة ازدواج الوكلاء أعلى من كلفة الترحيل.

ماذا عن الوجهة: مثال Dynatrace

في Dynatrace SaaS، تصف وثائق استقبال سجلات OTLP كيف يتحول سجل OTLP إلى سجل في Dynatrace: يغذّي Body الحقل content، وتغذّي الخطورة الحقل loglevel (SeverityText أولًا، ثم SeverityNumber، وإلا NONE)، ويصبح TraceId وSpanId هما trace_id وspan_id بالنظام السداسي عشري. وتُدمج سمات المورد ونطاق القياس والسجل. ويُستبدل الطابع الزمني الواقع في المستقبل بأكثر من عشر دقائق بالوقت الحالي، وتُرفض الأحداث الأقدم من حد العمر (انظر صفحة استقبال سجلات OTLP).

النتيجة العملية: ما تضعه في SeverityText وBody يحدد مباشرة المستوى والمحتوى اللذين سترى. وللمعالجة أو التوجيه أو الإخفاء لاحقًا، راجع مسارات OpenPipeline. وإذا كنت تمرّ اليوم عبر وكيل من طرف ثالث، فإن Fluent Bit نحو Dynatrace على Kubernetes يبقى مسارًا صالحًا: «مستقر» لا يُلزم أحدًا بالترحيل.

كيف تقرّر: شبكة من خمسة أسئلة

  1. ما اللغات؟ إذا غلبت Java أو .NET أو PHP أو C++ فمسار SDK ناضج. وإذا كانت Python أو JavaScript فابدأ بـ Collector على الملفات، أو جرّب في بيئة ما قبل الإنتاج.
  2. هل لديك تتبعات OpenTelemetry أصلًا؟ إذا كان الجواب نعم، فإن الربط عبر trace_id يبرّر وحده جسر السجلات.
  3. هل سجلاتك مهيكلة؟ تفضّل وثائق OpenTelemetry السجلات المهيكلة في الإنتاج؛ أما السجلات غير المهيكلة فتحليلها على نطاق واسع أصعب بكثير.
  4. كم تكلّف إضافة وكيل آخر؟ وجود وكيلين بالتوازي أثناء الانتقال يضاعف الحمل ومخاطر التكرار.
  5. ما خطة التراجع؟ ترحيل خدمة تلو أخرى مع إمكان الرجوع يحمي error budget لديك.

كيف تتحقق من أنه يعمل

بعد كل دفعة من الخدمات المرحَّلة، قارن الأحجام قبل الترحيل وبعده، ثم تحقق من الربط. في Notebook على Dynatrace SaaS:

fetch logs, from: now() - 30m
| filter isNotNull(trace_id)
| summarize logs = count(), by: {loglevel}

إذا كان عدد السجلات التي تحمل trace_id صفرًا مع أن الخدمات متتبَّعة، فسياق التتبع غير منقول: راجع الـ appender أو المشغّل trace_parser. وللاستعلامات بحسب المستوى، انظر عدّ أخطاء السجلات بحسب المستوى في DQL.

أفضل الممارسات

  • رحّل خدمة تلو أخرى، وقِس MTTR على حوادث حقيقية لا على عرض تجريبي.
  • ثبّت إصدارات SDK وCollector ما دامت اللغة ليست «Stable».
  • فعّل تخزين المواضع لـ receiver الملفات.
  • لا تخلط الإشارات: السجل ليس span ولا مقياسًا. تحتفظ كل إشارة بخط معالجتها.
  • أبقِ السجلات مهيكلة: فهي أفضل تأمين ضد تغيّر الصيغ.

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

هل سجلات OpenTelemetry مستقرة في كل اللغات؟

لا. تشير صفحة اللغات إلى «Stable» للغات C++ و.NET وJava وPHP وRust، وإلى «Release candidate» للغة Go، وإلى «Development» للغات Python وJavaScript وRuby وSwift وKotlin وErlang/Elixir. تحقق من تلك الصفحة قبل اختيار مسار SDK.

هل يجب التخلي عن وكيل السجلات الحالي؟

ليس بالضرورة. تؤكد OpenTelemetry أنها تريد العمل مع السجلات المنتَجة أصلًا. يمكن إضافة appender أو Collector إلى القائم، ثم يُسحب الوكيل القديم خدمة تلو أخرى إذا ثبتت الفائدة.

ما المكسب الملموس من الترحيل؟

أهمه الربط الأصلي بين السجلات والتتبعات عبر trace_id وspan_id، ثم صيغة إخراج واحدة (OTLP) لعدة وجهات. ومقارنة OpenTelemetry بمقاربات أخرى موضوع OpenTelemetry وPrometheus: أداتان متكاملتان.

الخلاصة

تزيل الحالة المستقرة لسجلات OpenTelemetry العقبة الجوهرية الرئيسية: النموذج والبروتوكول ثابتان. لكنها لا تعفيك من النظر في مستوى كل لغة ولا في مستوى مكوّنات Collector. والخيار المعقول تدريجي: جسر أو receiver على خدمة تجريبية، ثم تحقق في DQL، ثم التوسيع.

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. الحالات المذكورة هي حالات صفحات OpenTelemetry وDynatrace الرسمية التي روجعت في 31 أكتوبر 2026؛ وهي تتغير، فتحقق منها قبل أي قرار.

Total
0
Shares
Leave a Reply

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

Previous Post
OneAgent ActiveGate port 9999 : diagnostiquer une connexion impossible

OneAgent ActiveGate المنفذ 9999: تشخيص تعذّر الاتصال

Next Post
OWASP MCP Top 10 : les risques des serveurs MCP exposés

OWASP MCP Top 10: مخاطر خوادم MCP المعرَّضة

Related Posts