يعمل Collector لديك بصورة Contrib، ويطلب منك أحدهم التحول إلى Dynatrace OTel Collector. قبل أن تغيّر سطرًا واحدًا، اسأل نفسك: ما الذي يتغير فعلًا؟ لن نعيد هنا استعراض Contrib، فله دليل مكوناته الخاص. نركّز على الفرق بين الإصدارين وعلى مسار الانتقال.
ما قرأته: صفحة التعريف وصفحة النشر في وثائق Dynatrace، ثم ملف README في مستودع GitHub، وذلك في 9 نوفمبر 2026. الإصدارات المذكورة هي ما ورد في هذه الصفحات بذلك التاريخ. لم أشغّل الملف التنفيذي، لذلك وسمتُ كل ما يخص السلوك أثناء التشغيل بأنه غير متحقق منه.
Dynatrace OTel Collector: مجموعة جزئية مختارة وليس نسخة متفرعة
تقول الوثائق ذلك بوضوح: تحتفظ التوزيعة بنموذج الإعداد القياسي وبدلالات المكونات، دون طبقة خاصة ولا قيم افتراضية مخفية. أي أن ملف YAML المكتوب لـ Contrib يبقى مقروءًا كما هو. الفرق فيما يُجمَّع داخل الملف التنفيذي.
يضم Contrib عددًا هائلًا من المستقبِلات (receivers) والمعالجات (processors) والمُصدِّرات (exporters) من أطراف ثالثة. وتنصح صفحة Dynatrace بعدم استخدامه في الإنتاج وتحصره في الاختبار، لأنه يستهلك تخزينًا وذاكرة أكثر من بناء مخصص. أما توزيعة Dynatrace فلا تحوي إلا مكونات تقول الشركة إنها تحققت منها للاستخدامات الشائعة. وقائمتها الكاملة في مستودع GitHub وليست في الوثائق.
ما تحذفه التوزيعة: اقرأ القائمة قبل الانتقال
هنا يكمن خطر الانتقال. غياب مكوّن عن الملف التنفيذي يُفشل التشغيل، لأن Collector يرفض إعدادًا يذكر مكونًا غير معروف. وهذا ما دوّنته من قسم Components في ملف README.

- المستقبِلات: otlp وfilelog وhostmetrics وprometheus وstatsd وsyslog وfluentforward وjaeger وzipkin وkafka وkafka_metrics، إضافة إلى أربعة مستقبِلات لـ Kubernetes هي k8sobjects وk8scluster وkubelet_stats وk8sevents. أما journald وnetflow فهما في مرحلة alpha.
- المعالجات: batch وmemory_limiter وattributes وresource وresource_detection وtransform وk8sattributes وcumulativetodelta وmetricstarttime وprobabilistic_sampler وtail_sampling وgroupbytrace، إضافة إلى filter وredaction وgenainormalizer في مرحلة alpha.
- المُصدِّرات: otlp وotlphttp وdebug وkafka، إضافة إلى load_balancing في مرحلة alpha.
- الإضافات والموصِّلات: bearertokenauth وoidcauth وhealthcheck وzpages وk8sleaderelector وfilestorage؛ والموصِّل forward، وكذلك spanmetrics في مرحلة alpha.
لا أجد في هذه القائمة مُصدِّر Prometheus Remote Write ولا مُصدِّر ملفات ولا مستقبِل SQL ولا مستقبِل Docker. إن كانت مساراتك تعتمد على أحدها فستحتاج طريقًا آخر. هذا الغياب مستنتج من قراءتي لملف README، ولم أبنِ الملف التنفيذي لأؤكده.
ما تقدمه التوزيعة في المقابل
لا تضيف التوزيعة وظائف خفية، بل تضيف ضمانات حول الملف التنفيذي.
- دعم من الشركة المزوّدة محدود المدة: البناءان x86-64 وARM64 مشمولان بدعم Dynatrace. ويستمر دعم كل إصدار فرعي (minor) ثلاثة أشهر، مع تصحيحات تصدر على آخر إصدار فرعي مدعوم أو في الإصدار الفرعي التالي.
- تصحيحات أمنية مستقلة: تقول Dynatrace إنها تتلقاها دون انتظار إصدارات Collector الأصلية (upstream).
- صور موقّعة: بأداة cosign ابتداءً من الإصدار 0.49.0، ومنشورة على GHCR وAmazon ECR Public وDocker Hub.
- دعم محدود لما سوى ذلك: فيما يخص Contrib، لا تغطي Dynatrace إلا المكونات والإصدارات الموجودة في توزيعتها. أما البلاغات على GitHub فتُعالج بأقصى جهد ممكن، دون عقد ولا اتفاقية مستوى خدمة (SLA).
الحساب إذن مقايضة: مكونات أقل مقابل نطاق مدعوم. وبالنسبة لفريق SRE فهذا يعني أيضًا سطحًا أصغر للترقيع، وبالتالي جهدًا يدويًا متكررًا (toil) أقل مع كل ثغرة CVE.
الانتقال من Contrib في خمس خطوات
هذا هو المسار الذي أتبعه. ينطلق من إعدادك الفعلي لا من الوثائق.
- اجرد المكونات المستخدمة. باستخدام
yq(الإصدار 4) اعرض ما تذكره مساراتك، ثم الإضافات:
yq '.service.pipelines[] | .receivers[], .processors[], .exporters[]' config.yaml \
| sed 's#/.*##' | sort -u
yq '.service.extensions[]' config.yaml | sed 's#/.*##' | sort -u
- قارنها بقائمة المستودع. كل مكوّن ناقص يقع في إحدى حالات ثلاث: يُحذف، أو يُستبدل، أو يبقى في Collector ثانٍ من نوع Contrib أو OCB قبل التوزيعة.
- اربط مُصدِّر Dynatrace. تعطي صفحة النشر المثال التالي، مع قراءة العنوان والرمز من متغيرات البيئة:

- بدّل الصورة أو الحزمة. تشير صفحة النشر إلى الإصدار 0.60.0 (
dynatrace/dynatrace-otel-collector:0.60.0على Docker Hub). ثبّت إصدارًا محددًا بدلlatest. - انتقل تدريجيًا. ابدأ بتحويل Collector واحد يعمل كبوابة (gateway)، وقارن النتائج، ثم عمّم على الوكلاء (agents).
تفصيل يستحق الاختبار: يسمّي مثال الوثائق المُصدِّر otlp_http، بينما تكتبه كثير من إعدادات Contrib otlphttp. لا أعرف إن كان الإصدار 0.60.0 يقبل الاسمين معًا. شغّل أمر التحقق قبل التعميم.
كيف تتأكد أن كل شيء يعمل
تحقق من الملف أولًا، ثم راقب الإشارات. أمر واحد يكفي للخطوة الأولى:
./dynatrace-otel-collector validate --config=config.yaml
هذا الأمر الفرعي موجود في Collector الأصلي، لكنني لم أجربه على هذا الملف التنفيذي. وهو يكشف المكونات المجهولة قبل النشر. بعد ذلك، على صعيد التشغيل:
- أضف المُصدِّر
debugمؤقتًا لترى البيانات وهي تمر. - فعّل الإضافة
healthcheck: تعرضها أمثلة Helm في الوثائق على المنفذ 13133. - قارن حجم ما يُستقبَل بما يُصدَّر قبل الانتقال وبعده، لكل نوع من الإشارات.
- في Dynatrace، تأكد من وصول التتبعات، مثلًا بالسمات الموصوفة في تشريح الـ span في OpenTelemetry.
النشر: ثلاثة مسارات على Kubernetes
تميّز صفحة النشر بين وضع الوكيل (Collector قرب التطبيق) ووضع البوابة (خدمة مستقلة، غالبًا واحدة لكل عنقود). وعلى Kubernetes ثلاثة مسارات:
- مشغّل Dynatrace Operator ابتداءً من الإصدار 1.11.0، وهو يحدد صورة Collector بنفسه (راجع دليلنا إلى Dynatrace Operator)؛
- مشغّل OpenTelemetry Operator الذي يشترط وجود cert-manager (راجع مقال OpenTelemetry Operator)؛
- مخطط Helm باسم
open-telemetry/opentelemetry-collector، مع الكتلةalternateConfigالتي تحل محل الإعداد الافتراضي.
توضع بيانات الاعتماد في سر Kubernetes، واسمه dynatrace-otelcol-dt-api-credentials في الأمثلة، ويحوي DT_ENDPOINT وDT_PLATFORM_TOKEN. تحدد الأمثلة الذاكرة بـ 512 Mi، فعدّلها بحسب حملك. وخارج Kubernetes تتيح الوثائق أيضًا Docker وملفات تنفيذية وحزم DEB وRPM.
Managed أم SaaS: ما لم أستطع تأكيده
تستخدم الأمثلة التي قرأتها رمز منصة (platform token)، وهذا يناسب بيئة SaaS. لم أتحقق من العناوين والرموز الواجب استخدامها على Dynatrace Managed. في حالة Managed انطلق من شرحنا خطوة بخطوة لـ Collector وDynatrace، وتحقق من عنوان الاستقبال على عنقودك. كما أن النطاقات (scopes) الدقيقة للرمز غير مذكورة في الصفحات التي قرأتها.
ممارسات جيدة
- أبقِ قائمة المكونات المستخدمة تحت التحكم بالإصدارات بجانب الإعداد، فهي أداة فحص عند كل تحديث.
- خطط لتحديث فرعي واحد كل ربع سنة، لأن دعم الإصدار الفرعي يدوم ثلاثة أشهر.
- تعامل مع مكونات alpha على أنها غير مستقرة، فوثائق المستودع تقول إنها قد تتغير جذريًا.
- أبقِ Collector ثانيًا متسلسلًا للمصادر غير الشائعة بدل التخلي عن التوزيعة المدعومة.
- لا تضع الرمز داخل الملف أبدًا، واستخدم متغير بيئة أو سرًّا.
الأسئلة الشائعة
هل يتوافق Dynatrace OTel Collector مع إعداد Contrib؟
نعم من حيث الصيغة، فالوثائق تؤكد أن نموذج الإعداد يبقى قياسيًا. لا من حيث المكونات الغائبة عن الملف التنفيذي، فهي تمنع التشغيل. راجع القائمة قبل الانتقال.
هل يمكن إرسال البيانات إلى Dynatrace باستخدام Contrib؟
نعم، فالبروتوكول هو OTLP في الحالتين. الفرق في الدعم: فهو في حالة Contrib مقصور على المكونات والإصدارات المضمّنة في توزيعة Dynatrace.
ماذا أفعل إذا غاب مكوّن؟
ابنِ Collector مخصصًا باستخدام OpenTelemetry Collector Builder، أو سلسل Collectorين: الأول الخاص بك للمصدر غير الشائع، وتوزيعة Dynatrace عند الخروج نحو المنصة.
الخلاصة
لا يغيّر Dynatrace OTel Collector طريقة كتابتك للإعداد، لكنه يغيّر ما يقبله الملف التنفيذي وما تقبل الشركة دعمه. اجرد مكوناتك، وقارنها بقائمة المستودع، ثم انقل Collector واحدًا في كل مرة. ويُقاس المكسب بسطح أصغر وتصحيحات أسرع.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. تحقق دائمًا من القيم (المنافذ والإصدارات والأحجام) في الوثائق الرسمية الخاصة بإصدارك، وراجع الوثائق الرسمية ومستودع GitHub.