تبدأ الصورة otel/opentelemetry-collector-contrib في دقيقتين ويعمل كل شيء. وبعد ستة أشهر يستهلك الـ Collector ذاكرة أكثر من المتوقع، ويكسر تحديثٌ مكوّنًا لم يكن أحد يستخدمه، ويسأل فريق الأمان لماذا يتضمن ملف تنفيذي في الإنتاج مُصدِّرات إلى عشرات الأنظمة الخلفية. إن OpenTelemetry Collector Contrib صندوق أدوات ممتاز؛ لكن الفخ هو استخدامه توزيعةً للإنتاج دون فرز.
هدف هذا المقال: فهم ما يحتويه Contrib، واختيار المكوّنات التي تحتاجها فعلًا بحسب الإشارة والمصدر، ثم بناء Collector موجَّه: توزيعة Dynatrace، أو توزيعة Kubernetes الرسمية، أو بناء خاص بأداة OpenTelemetry Collector Builder. تصدّر الأمثلة بصيغة OTLP إلى Dynatrace SaaS أو Dynatrace Managed؛ وحده عنوان نقطة النهاية يتغير.
إذا كان خط المعالجة receivers وprocessors وexporters جديدًا عليك، فاقرأ أولًا Collector من OpenTelemetry نحو Dynatrace.
ما الذي يحتويه OpenTelemetry Collector Contrib
يستضيف المستودع opentelemetry-collector-contrib المكوّنات التي لا تنتمي إلى نواة الـ Collector: مستقبِلات لعشرات المصادر، ومعالجات متقدمة، ومُصدِّرات إلى أنظمة خلفية تابعة لجهات خارجية. يشير ملف إعداد البناء الاختباري فيه إلى أكثر من 250 وحدة (module). وتجمّع توزيعة Contrib معظمها في ملف تنفيذي واحد.
لكل مكوّن مستوى استقرار خاص به، بحسب الإشارة: قد يكون المكوّن نفسه Stable للتتبعات وAlpha للمقاييس وقيد التطوير للسجلات. يذكر ملف README الخاص بكل مكوّن ذلك، وكذلك القائمين على صيانته.
ينشر مشروع OpenTelemetry عدة توزيعات جاهزة للاستخدام، تصف كلًا منها ملف manifest.yaml:
| التوزيعة | المحتوى | متى تستخدمها |
|---|---|---|
Core (otelcol) |
مستقبِل OTLP وbatch وmemory_limiter ومُصدِّرا OTLP وdebug | مرحّل OTLP بسيط، وتحويل gRPC إلى HTTP |
Contrib (otelcol-contrib) |
Core إضافة إلى معظم المكوّنات التابعة لجهات خارجية | الاختبارات والنماذج الأولية والبحث عن المكوّن المناسب |
Kubernetes (otelcol-k8s) |
مجموعة جزئية من Core وContrib (Alpha فما فوق) لـ Kubernetes | Collector داخل عنقود (cluster) |
OTLP (otelcol-otlp) |
مستقبِل OTLP ومُصدِّراه فقط | بوابة دنيا |
| بناء خاص (OCB) | بالضبط ما تدرجه أنت | الإنتاج مع احتياجات محددة |
من جهة Dynatrace، وثائق الـ Collector واضحة: Contrib مثالي للاختبارات، لكنه لا يُوصى به عمومًا في الإنتاج، لأنه يستهلك موارد أكثر وقد يكون أقل استقرارًا من بناء محسَّن. وتوصي الوثائق بتوزيعة Dynatrace OTel Collector، وهي مجموعة مكوّنات جرى التحقق منها وتغطيها خدمة دعم Dynatrace (كل إصدار فرعي مدعوم لثلاثة أشهر). أما Core وContrib والبناءات الخاصة فيقتصر دعمها على المكوّنات والإصدارات المضمّنة في توزيعة Dynatrace.
اختيار مكوّنات OpenTelemetry Collector Contrib بحسب الحاجة
انطلق من الحاجة لا من الكتالوج. الأسماء أدناه هي أسماء الإصدارات الحديثة التي تنتقل تدريجيًا إلى صيغة snake_case (otlp_http منذ الإصدار v0.144.0 من الـ Collector، ثم file_log وhost_metrics وk8s_attributes…)؛ وتظل الأسماء القديمة (otlphttp وfilelog وhostmetrics وk8sattributes) مقبولة كأسماء مستعارة مُهمَلة (deprecated aliases).
الاستقبال
- التطبيقات المقيسة:
otlp(Core). أضفzipkinأوjaegerفقط للتطبيقات القديمة. - سجلات الملفات والنظام:
file_logللملفات (بما فيها/var/log/pods)، وjournaldوsyslogوfluent_forwardللاستقبال من Fluent Bit أو Fluentd. - مقاييس المضيف:
host_metrics(المعالج والذاكرة والقرص والشبكة والعمليات). - Kubernetes:
kubelet_stats(الـ pods والحاويات لكل عقدة)، وk8s_cluster(حالة الكائنات)، وk8s_eventsأوk8s_objects(الأحداث). - منظومة Prometheus وStatsD:
prometheusلجمع البيانات من المُصدِّرات (scrape)، وstatsd. - Kafka:
kafkaلاستهلاك بيانات القياس عن بُعد، وkafka_metricsلمراقبة العنقود.
المعالجة
- الحماية:
memory_limiterفي رأس كل خط معالجة. - السياق: يضيف
k8s_attributesوresource_detectionالـ pod ومساحة الأسماء والمضيف والسحابة. - التحويل والتصفية:
transform(لغة OTTL) وfilterوattributesوresource. - البيانات الحساسة:
redactionللإخفاء وفق أنماط. - أخذ العيّنات:
tail_samplingأو معالج أخذ العيّنات الاحتمالي. - التوافق مع Dynatrace:
cumulative_to_delta، لأن Dynatrace يتوقع مقاييس بزمنية دلتا (انظر زمنية مقاييس OTLP)، وmetric_start_timeلمقاييس Prometheus.
التصدير والربط
otlp_httpنحو Dynatrace، وdebugلاستكشاف الأخطاء، وload_balancingلتوجيه وحدات span في التتبع نفسه إلى Collector واحد قبلtail_sampling.- الموصِّلات (connectors):
span_metricsلاشتقاق مقاييس RED من وحدات span، وforwardلربط خطوط المعالجة بعضها ببعض. - الامتدادات (extensions):
health_check، وfile_storageلقائمة انتظار دائمة، والمصادقةbearertokenauthأوoidc.
تغطي توزيعة Dynatrace معظم هذه الاحتياجات. ويسرد بيانها (manifest)، في مستودع عام بترخيص Apache 2.0، بدقة ما تتضمنه:

الانتقال من Contrib إلى Collector موجَّه
الخطوة 1: جرد ما تستخدمه
اسرد المكوّنات الموجودة في ملفك التنفيذي الحالي مع مستوى استقرار كل منها:
otelcol-contrib components
قارن مع الأقسام receivers وprocessors وexporters وconnectors وextensions في ملف الإعداد: لا يعمل فعليًا إلا المكوّنات المذكورة في service.pipelines وservice.extensions.
الخطوة 2: التحقق من تغطية توزيعة Dynatrace
إذا وردت كل مكوّناتك في بيان توزيعة Dynatrace، فانتقل إليها: نموذج الإعداد نفسه، ومكوّنات جرى التحقق منها، ودعم. وانتهز الفرصة لاعتماد الأسماء الجديدة:
exporters:
otlp_http:
endpoint: ${env:DT_ENDPOINT}
headers:
Authorization: "Api-Token ${env:DT_API_TOKEN}"
processors:
memory_limiter:
check_interval: 1s
limit_percentage: 80
spike_limit_percentage: 25
cumulative_to_delta: {}
يحمل الرمز النطاقات openTelemetryTrace.ingest وmetrics.ingest وlogs.ingest بحسب الإشارات المُصدَّرة.
الخطوة 3: وإلا فابنِ توزيعتك بـ OCB
هل ينقصك مكوّن؟ ابنِ توزيعة بأداة OpenTelemetry Collector Builder. يستعير الملف بنية بيان Dynatrace:
dist:
name: otelcol-team
description: Platform team Collector
output_path: ./build
receivers:
- gomod: go.opentelemetry.io/collector/receiver/otlpreceiver v0.161.0
- gomod: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/filelogreceiver v0.161.0
processors:
- gomod: go.opentelemetry.io/collector/processor/memorylimiterprocessor v0.161.0
- gomod: github.com/open-telemetry/opentelemetry-collector-contrib/processor/k8sattributesprocessor v1.0.0
exporters:
- gomod: go.opentelemetry.io/collector/exporter/otlphttpexporter v0.161.0
# same version as the listed components
go install go.opentelemetry.io/collector/cmd/builder@v<version>
builder --config builder-config.yaml
حافظ على إصدارات متسقة صادرة عن إصدار (release) واحد، كما في بيان Dynatrace. وللمعالج k8sattributes الآن ترقيمه الخاص (v1.0.0 في بيان Dynatrace).
كيف تتحقق من أن كل شيء يعمل
- تحقق من صحة الإعداد قبل النشر:
otelcol-contrib validate --config config.yamlالمكوّن الغائب عن الملف التنفيذي ينتج خطأً صريحًا عن نوع غير معروف.
- فعّل
health_checkواستعلم عنه (المنفذ 13133 في أمثلة Dynatrace). - في Dynatrace SaaS، تأكد من وصول كل إشارة:
fetch logs, from: now() - 15m | summarize logs = count(), by: {k8s.namespace.name}بالنسبة إلى مقاييس المضيف، يوفر مستودع Dynatrace لوحة معلومات (dashboard) تستفيد من
host_metricsوresource_detection:

في Managed تحقق من التتبعات في عرض التتبعات الموزّعة ومن المقاييس في Data Explorer. ولمتابعة صحة الـ Collector نفسه انظر مراقبة Collector من OpenTelemetry.
أفضل الممارسات
- Contrib للاستكشاف، وتوزيعة موجَّهة للإنتاج: شيفرة أقل ومساحة هجوم أصغر وذاكرة أقل.
- اقرأ مستوى الاستقرار بحسب الإشارة قبل اعتماد مكوّن Alpha في الإنتاج.
- ثبّت الإصدارات في الصورة أو البناء، واقرأ CHANGELOG عند كل ترقية: فعمليات إعادة التسمية إلى snake_case يُعلن عنها فيه.
- memory_limiter في كل مكان، ودور واحد لكل Collector (وكيل DaemonSet أو بوابة)، كما في Collector من OpenTelemetry على Kubernetes.
- الإعداد في Git والتحقق منه في CI لتقليل العمل اليدوي المتكرر (toil) عند التحديثات.
الأسئلة الشائعة
هل يمكنني إبقاء Contrib في الإنتاج؟
تقنيًا نعم، لكن Dynatrace لا ينصح بذلك ولا يدعم إلا المكوّنات الموجودة في توزيعته. وإذا أبقيته فثبّت الإصدار وراقب استهلاك الذاكرة.
ماذا أفعل إذا غاب مكوّن عن توزيعة Dynatrace؟
ابنِ توزيعة بـ OCB تضيف هذا المكوّن، أو شغّل Collectorين متسلسلين: التوزيعة المدعومة عند المخرج نحو Dynatrace، وبناء خاص عند المنبع للمصدر غير المعتاد.
هل ستختفي الأسماء القديمة مثل otlphttp؟
هي مُهمَلة (deprecated) وتبقى مقبولة كأسماء مستعارة حاليًا. اعتمد الأسماء الجديدة عند أول تعديل لإعدادك، لتتجنب انقطاعًا عند ترقية مستقبلية.
الخلاصة
يصلح OpenTelemetry Collector Contrib للاكتشاف والاختبار؛ أما الإنتاج فيستحق توزيعة مختارة. اجرد مكوّناتك، وتحقق من وجودها في توزيعة Dynatrace، وإلا فابنِ توزيعتك بـ OCB. Collector أصغر يُعاد تشغيله أسرع ويُحدَّث بثقة أكبر ويحمي أهداف SLO لخط المعالجة لديك حماية أفضل.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. تتغير المكوّنات وأسماؤها مع كل إصدار: تحقق منها في مستودعات OpenTelemetry وفي الوثائق الرسمية لـ Dynatrace.