OpenTelemetry Collector Contrib: أي المكوّنات تختار للإنتاج

OpenTelemetry Collector Contrib: اختر المستقبِلات والمعالجات والمُصدِّرات بحسب الحاجة، ثم انتقل إلى توزيعة Dynatrace أو إلى بناء OCB.
OpenTelemetry Collector Contrib : quels composants choisir pour la production

تبدأ الصورة 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، بدقة ما تتضمنه:

مقتطف من ملف manifest.yaml لتوزيعة Dynatrace OTel Collector الإصدار v0.57.0: 17 مستقبِلًا منها filelog وhostmetrics وprometheus وkubeletstats وk8scluster، و14 معالجًا منها k8sattributes وtransform وtailsampling وredaction (مسارات الوحدات مختصرة)

الانتقال من 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).

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

  1. تحقق من صحة الإعداد قبل النشر:
    otelcol-contrib validate --config config.yaml

    المكوّن الغائب عن الملف التنفيذي ينتج خطأً صريحًا عن نوع غير معروف.

  2. فعّل health_check واستعلم عنه (المنفذ 13133 في أمثلة Dynatrace).
  3. في Dynatrace SaaS، تأكد من وصول كل إشارة:
    fetch logs, from: now() - 15m
    | summarize logs = count(), by: {k8s.namespace.name}

    بالنسبة إلى مقاييس المضيف، يوفر مستودع Dynatrace لوحة معلومات (dashboard) تستفيد من host_metrics وresource_detection:

لوحة OpenTelemetry Host Dashboard في Dynatrace: اسم المضيف ونوع نظام التشغيل وبنيته وعدد المعالجات والذاكرة وسعة القرص ومقاييس استخدام المعالج والذاكرة ونظام الملفات ومنحنى معدل نقل الشبكة، تغذّيها بيانات المستقبِل hostmetrics
Source : github.com

في 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.

Total
0
Shares
Leave a Reply

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

Previous Post
Log ingestion API Dynatrace : envoyer, transférer et enrichir vos logs

Log ingestion API في Dynatrace: إرسال السجلات وإعادة توجيهها وإثراؤها

Next Post
OpenTelemetry vs Prometheus (OTel vs Prometheus) : complémentaires ou concurrents ?

OpenTelemetry مقابل Prometheus (OTel vs Prometheus): متكاملان أم متنافسان؟

Related Posts