DDOT Datadog: مجمّع OpenTelemetry Collector الذي يُثبَّت مع وكيل Datadog

DDOT Datadog: Collector OpenTelemetry المدمج في الوكيل. المكوّنات والتثبيت على Kubernetes وLinux والإصدارات والحدود، وفق وثائق Datadog الرسمية.
DDOT Datadog : le collecteur OpenTelemetry installé avec l'Agent

DDOT Datadog هو توزيعة Collector الخاصة بـ OpenTelemetry التي تضمّنها Datadog داخل وكيلها (Agent). بالنسبة لفريق SRE يشغّل الوكيل أصلًا، السؤال بسيط: هل نُبقي Collector منفصلًا في المنبع، أم نترك الوكيل يتولى أيضًا مسارات (pipelines) OpenTelemetry؟ يصف هذا المقال ما يحتويه DDOT، وكيفية تثبيته على Kubernetes وLinux، وما الذي يغيّره في التشغيل، وذلك استنادًا إلى وثائق Datadog التي تمت مراجعتها في 30 أكتوبر 2026.

النطاق: يتناول هذا النص Datadog لا Dynatrace. وهو نقطة مقارنة نزيهة لمن يختار طريقة إيصال إشارات OpenTelemetry. وللسياق الأوسع، راجع المقارنة بين Dynatrace وDatadog.

DDOT Datadog: ما هو

وفق وثائق Datadog، فإن DDOT Collector (اختصار Datadog Distribution of OpenTelemetry) حل مفتوح المصدر «يجمع بين مرونة OpenTelemetry وإمكانات قابلية الملاحظة في Datadog». وهو مدمج في وكيل Datadog ويضم ثلاثة أشياء: مكوّنات OpenTelemetry مختارة، والجمع والمعالجة الخاصين بالوكيل، وبعض مكوّنات Datadog المخصصة.

إذن فهو ليس Collector «contrib» الكامل. تسرد الوثائق مجموعة محددة من المكوّنات:

  • Receivers: ‏otlpreceiver وprometheusreceiver وfilelogreceiver وhostmetricsreceiver وkubeletstatsreceiver وjaegerreceiver وzipkinreceiver، وغيرها؛
  • Processors: ‏batchprocessor وmemorylimiterprocessor وk8sattributesprocessor وresourcedetectionprocessor وtransformprocessor وtailsamplingprocessor وprobabilisticsamplerprocessor، إلخ؛
  • Exporters: ‏datadogexporter وotlpexporter وotlphttpexporter وloadbalancingexporter وdebugexporter؛
  • Connectors: ‏datadogconnector وroutingconnector وspanmetricsconnector؛
  • مكوّنات Datadog: ‏Infrastructure Attribute Processor، وConverter، وامتداد DD Flare.

إذا كان مكوّن ما غير موجود، تحيل الوثائق إلى دليل «Use Custom OpenTelemetry Components». والملف المرجعي هو manifest المستودع DataDog/datadog-agent (comp/otelcol/collector-contrib/impl/manifest.yaml). تحقق منه قبل ترحيل أي إعداد قائم، فهو السبب الأول للتعثر.

المتطلبات المسبقة والإصدارات التي ينبغي معرفتها

تذكر صفحة التثبيت على Kubernetes هذه المتطلبات:

  • عنقود Kubernetes بالإصدار 1.29 أو أحدث؛
  • Helm 3 أو أحدث، وkubectl؛
  • حساب ومفتاح API من Datadog؛
  • وسم صورة للوكيل بالإصدار 7.67.0 أو أحدث للصورة ddot-collector؛
  • مع Datadog Operator، الإصدار 1.22.0 أو أحدث: تستخدم حاوية DDOT حينئذٍ الصورة ddot-collector بدل الصورة -full.

المنافذ التي يجب إتاحتها هي 4317 و4318 (‏OTLP عبر gRPC وHTTP)، و8126 عبر TCP (استقبال تتبعات Datadog)، و8125 عبر UDP (‏DogStatsD). أما من ناحية النضج، فلا تعلن الصفحة الرئيسية حالة عامة (GA أو preview). وهي تشير فقط إلى أن الإعداد عن بُعد (Remote Configuration) لـ DDOT Collector في حالة Preview، وتذكر صفحة الترحيل أن النشر في وضع Gateway في حالة Preview. ويُعرض DaemonSet هناك بوصفه الوضع المدعوم. أما EKS Fargate فغير مدعوم.

لم أتمكن من تأكيد رقم إصدار أدنى واحد للوكيل من أجل DDOT، فالصفحة الرئيسية لا تذكره. لذلك فإن عتبة «7.65» المحتملة غير متحقق منها؛ اكتفِ بالعتبات المذكورة أعلاه (7.67.0 و7.78).

تثبيت DDOT Collector على Kubernetes باستخدام Helm

الخطوة 1: أضف المستودع وأنشئ سرّ مفتاح API.

helm repo add datadog https://helm.datadoghq.com
helm repo update
kubectl create secret generic datadog-secret \
  --from-literal api-key=<DD_API_KEY>

الخطوة 2: فعّل الـ Collector في ملف القيم. المفتاح المهم هو datadog.otelCollector.enabled. تكشف المنافذ hostPort بروتوكول OTLP على العقدة.

ملف datadog-values.yaml يظهر فيه datadog.otelCollector.enabled بقيمة true والمنفذان 4317 (otel-grpc) و4318 (otel-http)

الخطوة 3: انشر بالإعداد الافتراضي للـ Collector.

helm upgrade -i <RELEASE_NAME> datadog/datadog -f datadog-values.yaml

لإعداد مسار مخصص، أضف --set-file datadog.otelCollector.config=otel-config.yaml. ومع Datadog Operator، المكافئ هو features.otelCollector.enabled: true في المورد DatadogAgent ‏(datadoghq.com/v2alpha1)؛ ويربط الـ Operator حينئذٍ الـ Collector بالمنفذين 4317 و4318 افتراضيًا.

يتضمن الإعداد الافتراضي الذي تصفه الوثائق receiver من نوع otlp لجميع الإشارات، وreceiver من نوع prometheus، والـ processors ‏infraattributes وcumulativetodelta، والـ exporter ‏datadog. يقرأ الـ exporter القيمتين ${env:DD_API_KEY} و${env:DD_SITE}. ولكي يضيف infraattributes وسوم Kubernetes، يجب أن تحمل بيانات القياس عن بُعد سمة المورد container.id.

تثبيت DDOT على Linux

تغطي الوثائق أيضًا مضيفات Linux (الخوادم الفعلية والآلات الافتراضية). على مضيف جديد، يقبل سكربت تثبيت الوكيل المتغير DD_OTELCOLLECTOR_ENABLED=true. وعلى مضيف يوجد فيه الوكيل أصلًا بالإصدار 7.78 أو أحدث، يضيف الأمر sudo datadog-agent otel install الـ Collector.

أمر تثبيت الوكيل مع DD_OTELCOLLECTOR_ENABLED=true، وأمر datadog-agent status، وملف datadog.yaml يظهر فيه otelcollector.enabled بقيمة true

يحتوي الملف /etc/datadog-agent/datadog.yaml على otelcollector.enabled: true، ويُستخدم /etc/datadog-agent/otel-config.yaml إعدادًا أوليًا. بعد أي تعديل على هذين الملفين، أعد تشغيل الوكيل. لم أجد أمر إعادة التشغيل في هذه الصفحة: ارجع إلى وثائق توزيعتك. كما لا توضح صفحة التثبيت على Linux ما إذا كان هذا المسار في حالة preview؛ لذلك تبقى هذه النقطة غير متحقق منها.

إرسال القياس عن بُعد من تطبيق إلى DDOT

في Deployment الخاص بالتطبيق، وجّه SDK الخاص بـ OpenTelemetry إلى عنوان IP للعقدة. تعطي الوثائق متغيرات البيئة التالية.

متغيرات البيئة في Deployment: OTEL_EXPORTER_OTLP_ENDPOINT باتجاه HOST_IP والمنفذ 4317، والبروتوكول grpc

من أجل «unified service tagging»، عرّف OTEL_SERVICE_NAME وOTEL_RESOURCE_ATTRIBUTES مع service.version وdeployment.environment.name. وتنصح الوثائق بعدم الجمع بينها وبين labels Kubernetes الخاصة بـ Datadog، لأن ذلك ينشئ وسومًا مكررة.

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

على Linux، يجب أن يعرض الأمر sudo datadog-agent status قسم «OTel Agent» بالحالة Running. وعلى Kubernetes، لا تذكر الصفحة أي أمر للتحقق؛ بل تحيل إلى واجهة Datadog: ‏Fleet Automation (إعداد الوكيل والـ Collector) وInfrastructure Host List وLogs Explorer وTrace Explorer ولوحة صحة OTel Collector. بعد إعادة نشر التطبيق، يُفترض أن تظهر فيها التتبعات والمقاييس.

ما الذي يغيّره DDOT لفريق SRE

  • قطع أقل للتشغيل: يحمل DaemonSet واحد الوكيل والـ Collector، بدل دورتي تحديث. والمقابل هو الاقتران: إصدار الـ Collector يتبع إصدار الوكيل.
  • كتالوج مكوّنات محدود: كل ما يخرج عن القائمة يتطلب إجراء المكوّنات المخصصة. قارن مع إعدادك الحالي قبل الترحيل.
  • قيم افتراضية مختلفة: تحذر صفحة الترحيل من أن القيم الافتراضية في DDOT قد تختلف عن قيم Collector الأصلي (upstream)، مثلًا في filelogreceiver.
  • تكلفة تستحق المراقبة: تذكّر الوثائق بأن بعض الخيارات (APM وprocess وpodLabelsAsTags) قد تترتب عليها رسوم أو تؤثر في المقاييس المخصصة. لا أذكر أي تعرفة؛ راجع الصفحة الرسمية لـ Datadog.

تبقى الصلة بـ OpenTelemetry حقيقية: فالـ receiver من نوع OTLP والـ processors والـ exporter تأتي من منظومة OpenTelemetry، وتحتفظ تطبيقاتك بـ SDK القياسية. أما مع Dynatrace فالمنطق مختلف: يمكن أيضًا إرسال OTLP إلى Collector، كما هو موضح في Collector الخاص بـ OpenTelemetry على Kubernetes. لا أزعم وجود أي تكامل بين DDOT وDynatrace، لأن الوثائق التي رجعت إليها لا تصف أيًا منها. وبخصوص أخذ العينات، راجع tail sampling مع OpenTelemetry.

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

هل يحل DDOT محل Collector الأصلي الخاص بـ OpenTelemetry؟

يمكنه ذلك إذا كان إعدادك لا يستخدم سوى المكوّنات المضمّنة. تقترح الوثائق دليل ترحيل خطوة بخطوة. وإلا فعليك إضافة مكوّنات مخصصة أو الإبقاء على الـ Collector الأصلي.

هل يعمل DDOT على Linux وعلى Kubernetes؟

نعم، تصف الوثائق التثبيت على Kubernetes (‏DaemonSet) وعلى مضيفات Linux. وتشير صفحة الترحيل إلى أن EKS Fargate غير مدعوم.

هل ينبغي استخدام DDOT إذا كنا نرسل OTLP إلى Datadog أصلًا؟

ليس بالضرورة. يتوقف الاختيار على حاجتك إلى مسارات محلية وعلى استعدادك لقبول Collector مقترن بالوكيل. وللمقارنة مع مسارات إرسال أخرى، راجع OpenTelemetry وPrometheus.

الخلاصة

يوفّر DDOT مجمّع OpenTelemetry Collector داخل وكيل Datadog، مع كتالوج مكوّنات محدد وطريقتي تثبيت موثقتين. تحقق أولًا من مكوّناتك، وجرّب على عقدة واحدة، ثم رحّل. المراجع الرسمية: DDOT Collector والتثبيت على Kubernetes والتثبيت على Linux ودليل الترحيل.

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا لشركة Datadog Inc. علامتا Datadog وDDOT تعودان إلى مالكهما. الأمثلة مأخوذة من الوثائق الرسمية التي تمت مراجعتها في 30 أكتوبر 2026: تحقق منها في إصدارك.

Total
0
Shares
Leave a Reply

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

Previous Post
Monitoring Elasticsearch Dynatrace : l'extension pas à pas

مراقبة Elasticsearch في Dynatrace: الامتداد خطوة بخطوة

Next Post
OTLP APM Server ou EDOT Collector : quel chemin choisir

OTLP APM Server أو EDOT Collector: أي مسار تختار

Related Posts