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

OTLP APM Server أو EDOT Collector: شجرة قرار وendpoints ومنافذ وأخطاء شائعة لإرسال بيانات OpenTelemetry إلى Elastic دون أخطاء.
OTLP APM Server ou EDOT Collector : quel chemin choisir

يظهر الاختيار بين OTLP APM Server وEDOT Collector بمجرد أن تريد إرسال بيانات OpenTelemetry إلى Elastic: هل توجّه التطبيقات إلى نقطة استقبال OTLP (intake) في APM Server، أم تمرّ عبر EDOT Collector؟ يشرح دليل القرار هذا المسارين، والـ endpoints الواجب معرفتها، والأخطاء الشائعة، وما توصي به وثائق Elastic. لا يتناول الدليل Dynatrace Managed أو SaaS: فهو موضوع خاص بـ Elastic، يُعالج من زاوية فريق SRE أو فريق منصة يوحّد معاييره على OpenTelemetry. الصفحات الرسمية مُطّلع عليها في 30 أكتوبر 2026.

الاختيار مهم لأنه يحدد صيغة التخزين (OTel أصلية أو مترجمة إلى ECS)، وحزم SDK القابلة للاستخدام، وسهولة الانتقال لاحقًا.

OTLP APM Server أو EDOT Collector: الخلاصة

  • للمشروع الجديد، توصي وثائق Elastic بالإرسال إلى Elastic Agent أو إلى Managed OTLP endpoint، «instead of to the APM Server» (بدلًا من APM Server).
  • نقطة استقبال OTLP في APM Server تُقدَّم على أنها مسار قديم («legacy»): تُترجم البيانات إلى ECS قبل تخزينها.
  • حزم EDOT SDK غير مدعومة مع هذه النقطة، بحسب صفحة القيود.
  • البروتوكول لا يتغير: هو OTLP نفسه، عبر gRPC (المنفذ 4317 افتراضيًا) أو HTTP (المنفذ 4318 افتراضيًا).

ما يفعله كل مسار

نقطة استقبال OTLP في APM Server

يقبل APM Server بروتوكولي OTLP/gRPC وOTLP/HTTP على المنفذ نفسه الذي تستخدمه وكلاء Elastic APM، بحسب الوثائق. ترسل تطبيقاتك، أو أي Collector من OpenTelemetry، مباشرة إلى هذا المنفذ. الميزة هي البساطة: لا مكوّن إضافي إذا كان لديك APM Server بالفعل.

EDOT Collector وElastic Agent

تجمع EDOT (Elastic Distribution of OpenTelemetry) توزيعات OpenTelemetry المكيّفة مع Elastic: Collector وعدة حزم SDK للغات. بحسب الوثائق، منذ Elastic Agent 9.2 يعمل Collector الخاص بـ OpenTelemetry داخل Elastic Agent ويتشارك ملف إعداده: لم تعد هناك حاجة إلى ملف تنفيذي منفصل. في Elastic Cloud Serverless لا يوجد APM Server: تتولى managed inputs استقبال البيانات وتحويلها.

Managed OTLP endpoint

في Serverless وElastic Cloud Hosted، تخزّن نقطة الدخول هذه البيانات بصيغة OTel الأصلية. وهي تتجنب الترجمة إلى ECS، مما يغيّر لوحات المعلومات (dashboards) والاستعلامات المتاحة.

شجرة القرار

  1. هل تعمل على Elastic Cloud Serverless؟ لا يوجد APM Server. استخدم Managed OTLP endpoint أو Elastic Agent.
  2. هل تستخدم حزم EDOT SDK؟ تجنّب نقطة استقبال APM Server: فهي غير مدعومة معها. اتجه إلى Elastic Agent أو Managed OTLP endpoint.
  3. هل تبدأ نشرًا جديدًا؟ اتبع توصية Elastic: Elastic Agent (مع Collector مدمج) أو Managed OTLP endpoint.
  4. هل لديك أسطول قائم من وكلاء Elastic APM وAPM Server؟ تبقى نقطة استقبال OTLP ممكنة، مع حدودها. خطّط للانتقال بدلًا من توسيعها.
  5. هل تريد الاحتفاظ بالتحكم في التوجيه؟ ضع Collector (بوابة gateway) أمام الخلفية، كما في المقال عن Collector الخاص بـ OpenTelemetry على Kubernetes.

الـ endpoints والأخطاء الشائعة

تحدد مواصفة OTLP القيم الافتراضية: 4317 لـ gRPC، و4318 لـ HTTP، وثلاثة مسارات لـ HTTP.

المنفذان الافتراضيان لـ OTLP: 4317 (gRPC) و4318 (HTTP)، ومسارات HTTP وهي /v1/traces و/v1/metrics و/v1/logs

تتكرر عدة أخطاء في وثائق Elastic:

  • منفذ واحد وبروتوكولان. في APM Server يتشارك gRPC وHTTP المنفذ نفسه. تتطلب طلبات gRPC بروتوكول HTTP/2 (مع TLS أو H2C). قد لا يتعامل موازن حمل من المستوى 7 مع الاثنين: تفضّل Elastic موازن حمل L4 TCP، مثل AWS NLB. خلف proxy يكون OTLP/HTTP أبسط.
  • protobuf فقط. يقبل OTLP/HTTP صيغة protobuf فقط، وليس JSON.
  • المسارات. مع مصدّر HTTP تضيف حزمة SDK المسارات /v1/traces و/v1/metrics و/v1/logs إلى عنوان URL الأساسي. لا تفصّل صفحات Elastic التي قُرئت هذه المسارات في APM Server: تحقق منها في صفحة APM Server الخاصة بإصدارك قبل تثبيتها في الشيفرة.
  • السجلات. استقبال OTLP للسجلات في وضع technical preview لدى APM Server، مع تعطيل الخرائطية الديناميكية (dynamic mapping) على تدفق البيانات.
  • Ingress NGINX. يلزم المصدّر otlp مع تعليق بروتوكول gRPC التوضيحي (annotation)، أو otlphttp مع تعليق HTTP التوضيحي.

مثال: Collector بوضع gateway نحو Elastic

هذا مقتطف من إعداد Gateway في وثائق EDOT Collector: يستقبل OTLP على المنفذين ويصدّر بوضع OTel الأصلي.

إعداد EDOT Collector: المستقبِل otlp على 4317 و4318، والمصدّر elasticsearch/otel بوضع otel

سطران مهمان. mapping: mode: otel يحافظ على نموذج OpenTelemetry. تصف الوثائق أيضًا مصدّرًا elasticsearch/ecs لصيغة ECS (غير مدرج هنا). المتغيران ELASTIC_ENDPOINT وELASTIC_API_KEY قيمتان خاصتان بك: لا تكتبهما أبدًا بنص صريح في مستودع.

ما تخسره مع نقطة استقبال APM Server

تسرد صفحة القيود في Elastic المقايضات الخاصة بالمسار القديم.

مقتطفات من صفحة القيود في Elastic: حزم EDOT SDK غير مدعومة، والترجمة إلى ECS، والسجلات في وضع technical preview، وprotobuf فقط

بالنسبة لمهندس SRE تثقل كفة نقطتان: السمات غير المرتبطة تنتقل إلى labels.* مما يعقّد الاستعلامات، ولا تعمل حزم محتوى OpenTelemetry مع البيانات المترجمة. وتشير الوثيقة نفسها إلى أن tail sampling في Collector قد يشوّه مقاييس الإنتاجية: راجع مقالنا عن tail sampling في OpenTelemetry.

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

  1. في سجلات Collector أو Elastic Agent، ابحث عن أخطاء التصدير أو الاستقبال (401 وَ403 ورفض الاتصال).
  2. أرسل تتبعًا (trace) تجريبيًا من تطبيق وتحقق من ظهوره في Observability باسم الخدمة الصحيح.
  3. قارن استعلامًا على سمة مخصصة: في OTel الأصلية تحتفظ باسمها، وفي ECS المترجمة قد تنتهي في labels.*.
  4. خلف موازن الحمل، اختبر gRPC وHTTP كلًّا على حدة.

أفضل الممارسات

  • وحّد المعيار على OTLP من جهة التطبيقات: يبقى اختيار الخلفية قابلًا للعكس. راجع OpenTelemetry وPrometheus لمنطق المعيار المشترك.
  • ضع Collector بين تطبيقاتك والخلفية، لتغيير الوجهة دون إعادة نشر الخدمات.
  • دوّن إصدار Elastic Agent أو APM Server المستخدم: الوثائق تتطور (تذكر صفحة EDOT الإصدار Elastic Agent 9.5.5 في 30 أكتوبر 2026).
  • اربط هذا الاختيار بـ SLO لجودة البيانات: التتبعات المفقودة أو سيئة الربط ترفع MTTR.

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

هل OTLP المباشر إلى APM Server متقادم؟

تصفه وثائق Elastic بأنه «legacy» وتنصح المستخدمين الجدد بتجنبه. لا تقول إنه سيتوقف عن العمل، لكنها توثّق حدوده.

هل يمكنني استخدام حزمة SDK قياسية من OpenTelemetry مع APM Server؟

نعم، فنقطة الاستقبال تقبل OTLP. الحزم غير المدعومة مع هذه النقطة هي حزم EDOT SDK، بحسب Elastic.

هل أحتاج إلى Collector منفصل مع Elastic Agent؟

لا، منذ Elastic Agent 9.2 بحسب الوثائق: يعمل Collector داخل الوكيل ويتشارك إعداده. يبقى Collector منفصل مفيدًا للتوجيه إلى عدة خلفيات، مثلًا نحو عدة أدوات.

الخلاصة

للنشر الجديد، اتبع توصية Elastic: Elastic Agent أو Managed OTLP endpoint. احتفظ بنقطة استقبال OTLP في APM Server للأسطول القائم، مع معرفة حدودها. المصادر: وثائق OpenTelemetry لدى Elastic ومرجع EDOT.

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا لشركة Elastic N.V. معلومات Elastic مأخوذة من وثائقها العامة المُطّلع عليها في 30 أكتوبر 2026؛ تحقق منها لإصدارك.

Total
0
Shares
Leave a Reply

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

Previous Post
DDOT Datadog : le collecteur OpenTelemetry installé avec l'Agent

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

Next Post
Elasticsearch OpenTelemetry monitoring : le collecteur pas à pas

مراقبة Elasticsearch باستخدام OpenTelemetry: دليل Collector خطوة بخطوة

Related Posts