يضيف فريق وكيل OpenTelemetry لـ Java إلى خدمة يراقبها OneAgent أصلًا. النتيجة: يظهر كل طلب مرتين، ويتوقف تتبع فجأة في منتصف سلسلة الاستدعاءات، ولا يعرف أحد أي زمن استجابة يصدّق. وحالة تكرار spans بين OneAgent وOpenTelemetry (spans مزدوجة وسياق مقطوع) شائعة، وتُحل بقرار معماري بسيط: مالك واحد للقياس في كل عملية.
هدف هذا الدرس التطبيقي: تحديد سبب الـ spans المزدوجة أو السياق المقطوع، واختيار نمط التعايش المناسب، ثم التحقق من أن كل طلب ينتج تتبعًا واحدًا كاملًا. ينطبق المحتوى على Dynatrace SaaS وDynatrace Managed؛ وشاشات تحليل التتبعات تختلف لكن المنطق واحد.
وللنظرة الشاملة على سلسلة مقيسة من البداية إلى النهاية اقرأ أيضًا OpenTelemetry من البداية إلى النهاية مع Dynatrace.
تكرار spans بين OneAgent وOpenTelemetry: الأسباب الثلاثة
تتكرر ثلاثة أسباب في الغالب:
- قياسان تلقائيان في العملية نفسها. يقيس OneAgent الـ JVM (أو بيئة .NET أو Node.js…) ويقيس وكيل OpenTelemetry مكتبات HTTP وJDBC نفسها. فينتج كل استدعاء span مزدوجًا، يُرسَل عبر مسارين مختلفين.
- الـ spans الخاصة بـ OpenTelemetry تُلتقط مرتين. يستطيع OneAgent التقاط الـ spans المنشأة بواجهة OpenTelemetry API في عملية يراقبها. وإن كان التطبيق يصدّر هذه الـ spans أيضًا بـ OTLP إلى Dynatrace وصلت مرة عبر OneAgent ومرة عبر OTLP.
- انقطاع انتشار السياق. ترسل الخدمة A ترويسة
traceparent(W3C Trace Context) تتجاهلها الخدمة B، أو يحذف وكيل (proxy) الترويسات. فتبدأ B تتبعًا جديدًا: وتنقطع السلسلة إلى نصفين.
المتطلبات
- بيئة Dynatrace SaaS أو Managed مع OneAgent بنمط full-stack على المضيفات أو عبر Dynatrace Operator.
- صلاحية قراءة إعدادات البيئة (OneAgent features ومراقبة العمليات).
- لخدمات OpenTelemetry: رمز API مميّز بالنطاق
openTelemetryTrace.ingestونقطة OTLP، مباشرة أو عبر Collector الخاص بـ OpenTelemetry. - صلاحية shell أو
kubectlإلى العمليات المعنية.
خطوات إزالة تكرار spans بين OneAgent وOpenTelemetry
الخطوة 1 — جرد من يقيس ماذا
على مضيف، اسرد الوكلاء المحمَّلين في عمليات JVM:
# Agents Java chargés au démarrage
ps -eo pid,args | grep -E 'javaagent|JAVA_TOOL_OPTIONS' | grep -v grep
# Variables OpenTelemetry d'un processus (remplacer 1234 par le PID)
tr '\0' '\n' < /proc/1234/environ | grep -E '^OTEL_|JAVA_TOOL_OPTIONS'
وفي Kubernetes ابحث عن الحقنين الممكنين داخل الـ pods:
kubectl get pod checkout-7d9f -n shop -o yaml \
| grep -E 'instrumentation.opentelemetry.io|oneagent.dynatrace.com|JAVA_TOOL_OPTIONS'
إن رأيت حقن OneAgent مع الوسم التوضيحي instrumentation.opentelemetry.io/inject-java: "true" الخاص بمشغّل (operator) OpenTelemetry، فللعملية مالكان.
الخطوة 2 — اختر مالكًا واحدًا لكل عملية
| النمط | من يقيس | متى تختاره |
|---|---|---|
| A. OneAgent هو المالك | OneAgent؛ وتُستخدم واجهة OpenTelemetry API فقط للـ spans اليدوية الخاصة بالأعمال | خدمات يراقبها OneAgent أصلًا، وفريق يريد PurePath والتنميط (profiling) |
| B. OpenTelemetry هو المالك | SDK أو وكيل OpenTelemetry؛ ويبقى OneAgent على المضيف دون قياس هذه العملية | فريق يوحّد معياره على OpenTelemetry، وقابلية النقل بين أدوات متعددة |
| C. مختلط بحسب الخدمة | A لبعض الخدمات وB لأخرى | ترحيل تدريجي؛ ويتطلب انتشار W3C من البداية إلى النهاية |
ما لا يجوز فعله أبدًا: قياسان تلقائيان نشطان في JVM واحدة.
الخطوة 3أ — النمط A: OneAgent هو المالك
أزل وكيل OpenTelemetry من بدء التشغيل وأوقف تصدير OTLP للتتبعات. وأبقِ واجهة OpenTelemetry API في الشيفرة إن كنت تنشئ spans خاصة بالأعمال:
# Retirer -javaagent:opentelemetry-javaagent.jar de JAVA_TOOL_OPTIONS
# Si un SDK OpenTelemetry reste initialisé dans le code :
export OTEL_TRACES_EXPORTER=none
ثم تحقق في إعدادات OneAgent features من تفعيل OpenTelemetry Span Sensor الخاص بوحدة الشيفرة (code module) في OneAgent لتقنيتك (متاح لـ Java وGo وNode.js وPHP و.NET). يختلف الاسم الدقيق للخيار بحسب اللغة والإصدار؛ ابحث عن «OpenTelemetry» في القائمة وتأكد من وثائق OpenTelemetry في Dynatrace. وإعادة تشغيل العملية لازمة عادة.
الخطوة 3ب — النمط B: OpenTelemetry هو المالك
امنع OneAgent من قياس العملية دون إزالته من المضيف. في Kubernetes مع Dynatrace Operator عطّل الحقن على مستوى الـ pod:
apiVersion: apps/v1
kind: Deployment
metadata:
name: checkout
spec:
template:
metadata:
annotations:
oneagent.dynatrace.com/inject: "false"
instrumentation.opentelemetry.io/inject-java: "true"
وعلى مضيف تقليدي أنشئ قاعدة مراقبة عمليات تستثني هذه العملية من المراقبة المعمّقة (Settings → Processes and containers، بحسب إصدارك). ويبقى OneAgent يجمع مقاييس المضيف. وتفاصيل Operator في Dynatrace Operator على Kubernetes.
الخطوة 4 — أصلح انتشار السياق
في السلاسل المختلطة يجب أن يتحدث العالمان W3C Trace Context. من جهة OpenTelemetry حدّد الناشرات (propagators) صراحة:
export OTEL_PROPAGATORS=tracecontext,baggage
ومن جهة OneAgent تحقق في إعدادات التتبع الموزّع من تفعيل إرسال ترويسات W3C Trace Context (وهو مفعّل افتراضيًا في الإصدارات الحديثة، فتأكد من إصدارك). وافحص أيضًا الوكلاء (proxies) وبوابات API وشبكات الخدمة (service meshes): يجب أن تمرّر traceparent وtracestate دون إعادة كتابتهما.
كيف تتحقق من أن كل شيء يعمل
أرسل طلب اختبار بقيمة traceparent معروفة:
curl -s -o /dev/null -w '%{http_code}\n' \
-H 'traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01' \
https://checkout.example.internal/api/cart
في SaaS ابحث عن هذا التتبع في Grail:
fetch spans, from: now() - 15m
| filter trace.id == "4bf92f3577b34da6a3ce929d0e0e4736"
| summarize spans = count(), by: { dt.entity.service, span.name }
| sort spans desc
المتوقع: يظهر كل زوج خدمة/عملية مرة واحدة لكل استدعاء حقيقي. وظهور خدمتين مختلفتين للعملية نفسها (مثلًا واحدة سمّاها OneAgent وأخرى سُمّيت بـ service.name) يدل على قياس مزدوج. وقد تختلف أسماء الحقول: تحقق منها بـ fetch spans | limit 1. وفي Managed افتح عرض التتبعات الموزّعة، وصفِّ على الخدمة وتحقق من أن التتبع يحوي جميع الخدمات المتوقعة دون عقدة مكررة.
أفضل الممارسات
- اكتب القاعدة في معايير منصتك: عملية واحدة، مالك قياس واحد.
- استخدم
service.nameنفسه الذي يراه OneAgent لاسم الخدمة أثناء الترحيل، لتحافظ على استمرارية SLO. - بعد كل تغيير قارن عدد الطلبات قبل التغيير وبعده: فحجم ينخفض إلى النصف يدل على انتهاء تكرار، لا على هبوط في الحركة.
- يضخّم التكرار كذلك استهلاك الترخيص ويشوّه SLI: راقبه بوصفه خطرًا على الموثوقية، راجع تنبيهات burn rate لـ SLO.
الأسئلة الشائعة
هل يمكنني إبقاء OneAgent وواجهة OpenTelemetry API في الخدمة نفسها؟
نعم، وهذا هو النمط A. تُستخدم واجهة OpenTelemetry API لإنشاء spans خاصة بالأعمال، ويلتقطها OneAgent. ولا يظهر التكرار إلا إذا كان مصدّر OTLP يرسل هذه الـ spans أيضًا.
هل مقاييس OpenTelemetry مكررة أيضًا؟
لا تُلتقط بالآلية نفسها التي تُلتقط بها الـ spans. والخطر الرئيسي هو تصدير المقياس نفسه مرتين عبر مسارين (SDK وCollector مثلًا). افحص خطوط التصدير لديك.
هل يُضعف النمط المختلط التحليل؟
يعمل إذا كان انتشار W3C كاملًا. وتبقى بعض تحليلات OneAgent، مثل تنميط الشيفرة، غائبة عن الخدمات المقيسة بـ OpenTelemetry فقط.
الخلاصة
التكرار بين OneAgent وOpenTelemetry ليس خللًا يُلتفّ حوله، بل عَرَض لقياسين متنافسين. اجرد القياسات، واختر مالكًا لكل عملية، وافرض W3C Trace Context، ثم تحقق تتبعًا تتبعًا. فتعود مؤشرات SLI موثوقة، ويعود تحليل الحوادث كذلك.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. الميزات تتطور بسرعة: تحقق من توفرها في بيئتك وفي الوثائق الرسمية.