أبلغ عميل بأن طلبه فشل. يعطيك الدعم رقم الطلب لا معرّف التتبع. فهل تحتاج إلى correlation ID خاص بالعمل، أم يكفي trace_id من OpenTelemetry؟ يعتمد الجواب على ما تريد ربطه: طلب تقني واحد، أم إجراء يمتد عدة أيام.
تقارن هذه المقالة بين المعرّفين، وتشرح ما يضمنه كل منهما، ثم تقترح قاعدة اختيار لفريق SRE. المحتوى صالح لـ Dynatrace SaaS ولـ OpenTelemetry عمومًا؛ أما في Dynatrace Managed فتتوقف أسماء الحقول والشاشات على الإصدار، لذا تحقق منها في وثائق مجموعتك.
لإعداد trace_id في السجلات راجع سجلات OpenTelemetry وtrace_id في Dynatrace. أما هنا فالتركيز على اختيار المعرّف.
correlation ID أم trace ID: ما الفرق
إن trace_id معيار. فبحسب مواصفة W3C Trace Context يحدّد «the whole trace forest»، أي تتبعًا موزعًا كاملًا. حجمه 16 بايت، أي 32 محرفًا سداسيًا عشريًا بأحرف صغيرة، والقيمة الصفرية بالكامل غير صالحة. وتطلب المواصفة أن يكون فريدًا عالميًا وتفضّل قيمة عشوائية.
أما correlation ID فليس له تعريف معياري مماثل. إنه اصطلاح فريق: معرّف تختاره أنت (غالبًا الترويسة X-Request-ID أو رقم طلب) وتنسخه في السجلات والرسائل والتذاكر. فصيغته ومدة بقائه ونشره تعتمد على شيفرتك. وغياب المعيار عيبه، لكنه أيضًا قوته: يمكنه البقاء حيث يتوقف التتبع.

ما الذي يربطه كل معرّف
| المعيار | trace_id | Correlation ID |
|---|---|---|
| المصدر | يولّده SDK أو الوكيل عند بداية الطلب | يختاره التطبيق أو يُقرأ من ترويسة |
| الصيغة | 32 محرفًا سداسيًا عشريًا (W3C) | حرّة |
| النطاق | طلب موزع واحد | إجراء عمل واحد، وأحيانًا عدة طلبات |
| النشر | الترويسة traceparent وتتولاه أدوات القياس |
على عاتقك (ترويسة أو رسالة أو baggage) |
| مقروء للدعم | نادرًا | نعم، إن كان رقمًا يعرفه العميل |
| أخذ العينات | قد يختفي إذا لم يُحتفظ بالتتبع | يبقى في السجلات |
النقطة الحاسمة هي المدة. التتبع يغطي طلبًا واحدًا؛ أما دفعة تُعتمد بعد استدعاء غير متزامن مع رسالة تأكيد بالبريد ومحاولة إعادة ليلية فتغطي عدة طلبات. يتغير trace_id عند كل حلقة تبدأ تتبعًا جديدًا (معالجة بالدفعات، مستهلك طابور). أما correlation ID فيبقى كما هو إن نقلته.
كيف يستخدم Dynatrace معرّف التتبع
في OpenTelemetry يتضمن نموذج بيانات السجلات الحقول الاختيارية TraceId وSpanId وTraceFlags. والسجل المُصدر داخل span نشط يتلقاها من SDK. وتوضّح المواصفة أنه إذا وُجد SpanId فينبغي أن يوجد TraceId أيضًا.
تذكر وثائق Dynatrace عن استيعاب سجلات OTLP أن TraceID وSpanID يُحوَّلان إلى الحقلين trace_id وspan_id بعد تحويلهما إلى النظام السداسي العشري. وفي السجلات التي يثريها OneAgent تذكر الوثائق بالأحرى dt.trace_id وdt.span_id. إذن يوجد اسمان بحسب المصدر: افحص سجلًا حقيقيًا قبل كتابة استعلاماتك. راجع أيضًا Distributed traces وPurePath لقراءة تتبع.

نشر correlation ID عبر baggage
إذا احتفظت بـ correlation ID فلا تنسخه يدويًا في كل خدمة. يوفّر OpenTelemetry مفهوم baggage، وهو معلومة سياقية تنتقل بين الإشارات، وتسافر مع السياق عبر ترويسات HTTP.
- أنشئ المعرّف عند المدخل. اقرأ الترويسة الواردة أو ولّده عند حدود النظام.
- ضعه في baggage.
from opentelemetry import baggage, context ctx = baggage.set_baggage("correlation.id", "cmd-A-1042") token = context.attach(ctx) - انسخه صراحةً كسمة. توضّح الوثائق أن baggage هو «a separate key-value store» غير مرتبط بالسمات: عليك إضافته بنفسك إلى spans والسجلات، أو استخدام معالج baggage إن وفّرته لغتك.
span.set_attribute("correlation.id", baggage.get_baggage("correlation.id")) - اكتبه في السجلات تحت مفتاح ثابت، بجانب
trace_id.
تنبيه: تحذّر وثائق OpenTelemetry من أن baggage قد يُكشف لأطراف ثالثة ويظهر في حركة الشبكة، وأنه بلا مراقبة للسلامة. لا تضع فيه أبدًا بيانات شخصية أو أسرارًا، ولا تثق بقيمة واردة من عميل خارجي.
كيف تتحقق من أن الأمر يعمل
في Notebook ضمن Dynatrace SaaS ابحث أولًا عن سجلات إجراء عمل، ثم اصعد إلى تتبعاتها. قد تختلف أسماء الحقول: تحقق بالأمر fetch logs | limit 1.
fetch logs, from: now() - 2h
| filter correlation.id == "cmd-A-1042"
| summarize traces = countDistinct(trace_id), logs = count()
إذا كانت قيمة traces أكبر من 1 فالإجراء يعبر عدة تتبعات: وهذه هي الحالة التي يقدّم فيها correlation ID ما لا يقدّمه trace_id. ولتتبع محدد:
fetch logs, from: now() - 2h
| filter trace_id == "<trace_id>"
| fields timestamp, loglevel, content

قاعدة الاختيار لفريق SRE
- التشخيص التقني لطلب بطيء أو خاطئ:
trace_id. فهو معياري وتلقائي ويربط السجلات وspans والمقاييس. - دعم العملاء ومسار العمل: correlation ID، لأن شخصًا يستطيع تقديمه والعثور عليه.
- المعالجات غير المتزامنة: كلاهما. correlation ID يربط التتبعات، و
trace_idيربط كل تتبع بسجلاته. - المصادر غير المزوّدة بأدوات قياس (نظام طرف ثالث، ملف مسطح): correlation ID، إذ لا يوجد
trace_id.
بالنسبة إلى هدف الموثوقية، يقلّل الجمع بينهما MTTR: ينطلق الدعم من رقم مقروء، وينتقل مهندس المناوبة إلى التتبع. ويمس هذا الاختيار الحجم أيضًا؛ فـ tail sampling قد يحذف تتبعات، لكنه لا يحذف السجلات الحاملة لـ correlation ID.
أفضل الممارسات
- اسم حقل واحد لـ correlation ID في المؤسسة كلها، وموثّق.
- لا بيانات شخصية كمعرّف (لا عناوين بريد ولا أرقام بطاقات).
- لا تستبدل trace_id: لا تخترع صيغة تتبع ثانية، استخدم
traceparent. - الكاردينالية: تجنّب استخدام correlation ID بُعدًا للمقاييس؛ فهو يناسب السجلات وسمات span.
- الاحتفاظ: تأكد من أن السجلات تعيش بقدر مهلة الاعتراض عند عملائك.
الأسئلة الشائعة
هل يمكن استخدام trace ID بوصفه correlation ID؟
في طلب متزامن، نعم. وبمجرد أن تفتح معالجة غير متزامنة تتبعًا جديدًا يتغير trace_id، ونادرًا ما يعرفه العميل.
هل يحل correlation ID محل trace_id في Dynatrace؟
لا. يربط Dynatrace السجلات بالتتبعات عبر حقول التتبع (trace_id وspan_id). ويبقى correlation ID سمة تصفّي بها في DQL.
هل baggage آمن لنقل معرّف؟
فقط لمعرّف لا قيمة حساسة له. فبحسب وثائق OpenTelemetry هو ظاهر في حركة الشبكة وبلا مراقبة للسلامة.
الخلاصة
يخدم trace ID المهندس، ويخدم correlation ID جهة العمل: احتفظ بالاثنين، لكل منهما دوره. ابدأ بالتحقق من أن سجلاتك تحمل trace_id أصلًا، ثم أضف correlation ID حيث يتجاوز الإجراء طلبًا واحدًا. ولوضع هذه الإشارات في سياقها اقرأ الفرق بين قابلية الملاحظة والمراقبة.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. الحقول والشاشات تتغير: تحقق منها دائمًا في الوثائق الرسمية.