يعمل Jaeger v1 لديك منذ سنوات، ويعود السؤال نفسه في كل مراجعة معمارية: هل حان وقت الانتقال إلى Jaeger v2 أم ننتظر؟ لا يتوقف الجواب على تاريخ بعينه بقدر ما يتوقف على ما تشغّله اليوم: كم ملفًا تنفيذيًا، وأي خيارات (flags)، وأي سلسلة جمع تسبق التخزين.
ينطلق هذا الدليل من قرار التشغيل هذا. المعلومات مأخوذة من وثائق jaegertracing.io (يظهر الإصدار 2.23 بوصفه الأحدث) ومن مستودع jaegertracing/jaeger، وقد قُرئت في 11 نوفمبر 2026. لم أنقل بيئة إنتاج فعلية لكتابة المقال: مقتطفات الإعداد هي مقتطفات المستودع، وليست اختبارًا أجرته span.observer.
لفهم موقع Collector نفسه، راجع مكوّنات Collector Contrib؛ ولمراقبة الـ Collector الخاص بك، راجع مراقبة Collector.
لماذا الانتقال إلى Jaeger v2: ما الذي يتغيّر فعلًا
تؤرخ الوثائق صدور Jaeger v2 بنوفمبر 2024 وتصفه بأنه مبني على إطار OpenTelemetry Collector. وتقول صفحة المعمارية إن Jaeger «توزيعة مخصّصة من OpenTelemetry Collector بأدوار مختلفة». ملف تنفيذي واحد اسمه jaeger يؤدي هذه الأدوار بحسب إعداده.
- Collector: يستقبل التتبعات من التطبيقات ويكتبها في مخزن.
- Ingester: يقرأ الـ spans من Kafka ويكتبها في مخزن.
- Query: يقدّم الواجهة وواجهة القراءة البرمجية.
- Agent: توصي الوثائق الآن باستخدام OpenTelemetry Collector القياسي بدلًا منه.
أي أن ما كان يُضبط بالخيارات في الإصدار الأول أصبح ملف YAML بصيغة Collector. ويعلن ملف README في المستودع (ترخيص Apache 2.0، ونحو 23 400 نجمة وقت القراءة) أن «Jaeger v2 is out».
مسألة نهاية دعم الإصدار الأول
بصراحة: لم أجد أي تاريخ لنهاية دعم الإصدار الأول في صفحات المعمارية والنشر والترحيل، ولا في README. تكتفي صفحة الترحيل بالإحالة إلى مستند Google مشترك لم أتمكن من الاستفادة منه هنا. ولا تعرض صفحات الوثائق سوى إصدارات 2.x.
فلا تبنِ قرارك على تاريخ افتراضي. ابحث عن سياسة الدعم في ملاحظات الإصدار بالمستودع قبل تحديد جدولك، وتذكّر أن كل شهر يمضي على الإصدار الأول هو شهر بلا إصلاحات الفرع الرئيسي.
ارسم خريطة الإصدار الأول قبل أن تلمس أي شيء
تبدأ عملية الانتقال الناجحة بجرد، لا بملف YAML. دوّن لكل مكوّن في الإصدار الأول:
- أي مخزن يستخدمه (الذاكرة، Elasticsearch، Cassandra، أو Kafka كمخزن مؤقت)؛
- أي بروتوكولات ترسلها التطبيقات إليه (OTLP، أو Jaeger عبر gRPC أو Thrift، أو Zipkin)؛
- أي استراتيجية أخذ عيّنات (sampling) يقدّمها لحزم SDK؛
- أي خيارات مخصّصة موجودة في ملفات النشر أو الـ charts لديك.
يكشف هذا الجرد أساسًا أين يختبئ الخطر: خدمة بقيت على بروتوكول قديم، أو استراتيجية أخذ عيّنات تُقدَّم عن بُعد ونُسيت.
قراءة ملف إعداد الإصدار الثاني
يُشغَّل الملف بالأمر jaeger --config config.yaml. وهو يتبع بنية Collector: كتلة service تربط مكوّنات معرَّفة في الأسفل. ويوضح مثال المستودع ذلك جيدًا.

ثلاث نقاط تستحق التذكّر:
- لمسار
tracesمستقبِلات (OTLP وبروتوكولات Jaeger وZipkin) ومعالجات ومُصدِّر واحد؛ - المُصدِّر
jaeger_storage_exporterيكتب في مخزن مُسمّى، وهو هناsome_store؛ - قائمة
extensionsتفعّل الوظائف الخاصة بـ Jaeger: التخزين والاستعلام وأخذ العيّنات عن بُعد.
ويعرّف النصف الثاني من الملف هذه الامتدادات.

يعلن الامتداد jaeger_storage عن المخازن مرة واحدة تحت اسم، ثم يشير إليها jaeger_query والمُصدِّر بهذا الاسم. وهذا تغيير مفيد في المنطق: تبديل المخزن يعني تعديل مدخل واحد، لا عدة خيارات متفرقة. أما المخزن memory في المثال فللاختبار لا للإنتاج.
خطوات انتقال حذر
- شغّل النسختين بالتوازي. أطلق Jaeger v2 إلى جانب الإصدار الأول بمخزن اختباري، وأرسل إليه نسخة من حركة المرور.
- حوّل الإعداد. انطلق من جردك: مستقبِل لكل بروتوكول مستخدم، ومخزن مُسمّى لكل تخزين.
- تحقق من البيانات. قارن في الواجهة تتبعات معروفة بين النسختين.
- انقل الكتابة أولًا، ثم القراءة.
- أطفئ الإصدار الأول بعد انقضاء مدة الاحتفاظ بالبيانات.
وللتحديث بين إصدارات 2.x تحدد الوثائق الترتيب: query أولًا، ثم ingester إن كنت تستخدم Kafka، ثم collector. هذا الترتيب غير مكتوب للانتقال من v1 إلى v2، لكن مبدأه (القراءة قبل الكتابة) عادة جيدة.
فخ طابور المُصدِّر
تنبّه الوثائق إلى نقطة دقيقة: إذا أقرّ طابور المُصدِّر باستلام الـ spans بمجرد إدخالها فيه، فقد يؤدي تعطل المخزن إلى ضياع بيانات. ولتجنب ذلك تنصح بضبط wait_for_result: true وعدم استخدام المعالج batch. ويمكن للمُصدِّر نفسه أن يعمل موصِّلًا (connector) فيعيد الـ spans المرفوضة نهائيًا إلى مسار آخر يؤدي دور صندوق المرفوضات. راجع ذلك قبل الإنتاج، خصوصًا إذا كان هدف مستوى الخدمة (SLO) لديك يعتمد على اكتمال التتبعات.
ممارسات جيدة
- ضع ملف YAML تحت إدارة الإصدارات وراجعه كما تراجع الشيفرة.
- أبقِ المستقبِلات للبروتوكولات المستخدمة فعلًا فقط: كل منفذ مفتوح يزيد سطح الهجوم.
- قِس قبل الانتقال وبعده: زمن الكتابة، والـ spans المرفوضة، ومدة استعلام نموذجي.
- إذا كنت تأخذ عيّنات، فراجع أيضًا قواعد tail sampling حتى لا تفقد التتبعات المفيدة.
- أبقِ الإصدار الأول للقراءة فقط حتى نهاية مدة الاحتفاظ.
الأسئلة الشائعة
هل أحتاج إلى OpenTelemetry Collector أمام Jaeger v2؟
لا. توضح الوثائق أنه غير لازم لتشغيل Jaeger. وتضيف أن الفريق الذي يملك واحدًا بالفعل يمكنه وضعه أمام Jaeger لأنواع أخرى من القياس عن بُعد.
هل يجب أن تتغير تطبيقاتي؟
يُبقي ملف المثال على مستقبِلات Jaeger وZipkin إلى جانب OTLP، فيمكن للعملاء الحاليين متابعة الكتابة. تحقق من ذلك في إعدادك الخاص.
وماذا عن Dynatrace؟
يتناول هذا المقال Jaeger وحده. ولإرسال تتبعات OpenTelemetry إلى Dynatrace، راجع OpenTelemetry Collector مع Dynatrace؛ وتفرّق وثائق Dynatrace بين SaaS وManaged، ولا أتناول ذلك هنا.
الخلاصة
الانتقال إلى Jaeger v2 يعني قبول ملف YAML بصيغة Collector بدل الخيارات: وضوح أكبر مقابل جرد جاد. ابدأ بالتوازي، وتحقق من التتبعات، ثم بدّل. المصادر: وثائق Jaeger ومستودع jaegertracing/jaeger.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC (ولا لمشروع Jaeger). العلامات المذكورة ملك لأصحابها. الأدوات تتطور بسرعة: تحقق دائمًا من الأوامر والخيارات في الوثائق الرسمية الخاصة بإصدارك.