نشر السياق غير المتزامن: طوابير الرسائل والمهام الخلفية

نشر السياق غير المتزامن: احقن traceparent في رسائلك، واربط العامل وAPI برابط span، وتحقق من التتبع في Dynatrace باستعلام DQL.
Propagation contexte asynchrone : files de messages et jobs en arrière-plan

نشر السياق غير المتزامن: يطلق مستخدم فاتورة، فتردّ واجهة API خلال 80 ms، ثم ينشئها عامل (worker) بعد أربعين ثانية من طابور. في أداة التتبعات ترى حكايتين لا رابط بينهما. لم يحدث نشر السياق غير المتزامن: لم يكتب أحد سياق التتبع في الرسالة، فبدأ العامل تتبعًا جديدًا.

يستهدف هذا الدرس فرق SRE والمنصات التي تستخدم طوابير الرسائل (RabbitMQ وSQS وRedis أو جدول مهام) أو المهام الخلفية. يشرح ما يجب أن يسافر مع الرسالة، ومتى يُفضَّل رابط span على الأب، وكيف يُتحقق من النتيجة. تفاصيل حالة Kafka في نشر سياق Kafka في Dynatrace؛ أما هنا فالطريقة تصلح لأي ناقل. يخص استيعاب OTLP بيئة Dynatrace SaaS؛ واستعلامات DQL تفترض Grail، أي بيئة SaaS.

نشر السياق غير المتزامن: المبدأ

في HTTP يكتب العميل ترويسة traceparent ويقرؤها الخادم. وفق وثائق OpenTelemetry يُحقن السياق «في الحامل» (carrier) لدى المرسل، ثم يُستخرج لدى المستقبل. في بروتوكول بلا حقل بيانات وصفية مخصص، عليك اختيار مكان تخزين السياق، وعلى المستقبل قراءته من المكان نفسه.

في الطابور، الحامل هو ما تتيحه الرسالة: خصائص الرسالة أو ترويساتها، أو سمات رسائل SQS، أو حقل في جسم JSON، أو عمود في جدول المهام. والمبدأ واحد: المنتج يحقن، والمستهلك يستخرج.

الصيغة الافتراضية في OpenTelemetry هي W3C Trace Context. تساوي قيمة المتغير OTEL_PROPAGATORS القيمة tracecontext,baggage افتراضيًا في SDK الخاص بـ Python (المصدر: وثائق opentelemetry.propagate). يجب أن يستخدم الطرفان الصيغة نفسها.

ماذا تحتوي ترويسة traceparent

تتألف الترويسة من سطر واحد بطول 55 حرفًا في الإصدار 00: الإصدار، ثم معرّف التتبع من 32 خانة سداسية عشرية، ثم معرّف span الأب من 16، ثم الأعلام. في الإصدار 00 لا يُعرَّف سوى علم sampled، وهو البت الأخير. المعرّف المكوّن من أصفار فقط غير صالح (مواصفة W3C).

صيغة ترويسة traceparent في W3C مع مثال المواصفة، ثم جدول نوع span في OpenTelemetry بحسب عملية المراسلة

يلخّص الإطار الثاني الاتفاقيات الدلالية للمراسلة: العملية create تعطي span من النوع PRODUCER، والعملية process نوع CONSUMER، والعمليتان receive وsettle نوع CLIENT.

الخطوة 1 — حقن السياق عند الإرسال

أنشئ span للنشر، ثم احقن السياق الحالي في قاموس. يسافر هذا القاموس مع الرسالة. الشيفرة التالية عامة عمدًا: queue.put يمثل استدعاء عميلك.

شيفرة Python للمنتج: span من النوع PRODUCER، والسمتان messaging.system وmessaging.destination.name، وpropagate.inject في قاموس يُضاف إلى المهمة

الأسطر الحرجة: يكتب propagate.inject(carrier) الترويسة traceparent (وtracestate إن وُجدت) انطلاقًا من السياق الحالي، أي من span من النوع PRODUCER فُتح قبلها مباشرة. وفق اتفاقيات OpenTelemetry «ينبغي» أن يرفق المنتج سياق إنشاء بكل رسالة؛ وبدونه لا يمكن ربط تتبعات المستهلك بتتبعات المنتج.

بالنسبة إلى Celery أو SQS أو عميل آخر، تحقق أولًا من وجود أداة قياس (instrumentation) لـ OpenTelemetry لمكتبتك: فهي تؤدي هذا العمل بلا شيفرة. وإلا فالنسخة اليدوية أعلاه تبقى صالحة.

الخطوة 2 — استخراج السياق في العامل

يقرأ العامل القاموس ويستدعي propagate.extract فيحصل على Context. ثم يُتاح خياران: جعله أبًا لـ span المعالجة، أو إنشاء رابط span إليه.

تقدّم اتفاقيات المراسلة في OpenTelemetry الروابط بوصفها آلية الربط الافتراضية، وتعطي ثلاثة أسباب: الروابط هي البنية الوحيدة المضمونة في جميع نماذج المراسلة، وهي الخيار الوحيد للدفعة (لـ span أب واحد فقط)، وهي الوحيدة التي تعمل حين تُنفَّذ المعالجة أصلًا ضمن سياق محيط، مثل span لخادم HTTP. أما استخدام سياق الإنشاء أبًا فلا يصح إلا لرسالة واحدة.

شيفرة Python للعامل: propagate.extract على كل مهمة، وكائنات Link، وspan من النوع CONSUMER أُنشئ مع links لمعالجة دفعة من الرسائل

الأسطر الحرجة: يأخذ Link(span_context) قيمة SpanContext الخاصة بالـ span المراد ربطه (التوقيع Link(context, attributes=None))؛ ويقبل start_as_current_span المعاملات kind وlinks وcontext. للحصول على الأب بدل الرابط في رسالة واحدة، مرّر context=ctx بدلًا من links=.

الخطوة 3 — التعامل مع الدفعات وإعادة المحاولة والمهام المجدولة

  • الدفعات: يمكن لـ span معالجة واحد أن يغطي عدة رسائل. وفق الاتفاقيات يربط حينئذ سياق إنشاء كل رسالة معالَجة. توثّق Dynatrace حدًا نموذجيًا هو 128 رابطًا لكل span (حد في SDK الخاص بـ OpenTelemetry لا تفرضه Dynatrace، بحسب صفحة استيعاب التتبعات): وما فوقه قسّم الدفعة.
  • الرسائل المحمّلة مسبقًا: لا يجب إنشاء span للاستقبال للرسائل المخزّنة مؤقتًا فقط؛ بل يظهر عند تسليم الرسالة إلى شيفرة التطبيق.
  • إعادة المحاولة: الرسالة المعاد تشغيلها تحتفظ بالسياق الأصلي. فيرتبط تتبع إعادة المحاولة بالطلب الأول، أحيانًا بعد ساعات. هذا مفيد للتشخيص، لكن الفارق الزمني يطيل التتبع.
  • المهام المجدولة (cron): لا يوجد سياق سابق. أنشئ جذرًا، وهذا طبيعي.
  • المحطات الوسيطة: الموجّه أو الجسر أو الموصّل الذي ينسخ الرسالة يجب أن ينسخ السياق أيضًا. اختبر كل قفزة.

الخطوة 4 — أخذ العينات والاستيعاب

يسافر علم sampled مع السياق. مع جهاز أخذ عينات يتبع الأب، يحترم العامل القرار المتخذ في API؛ وإذا اختلف أخذ العينات بين الطرفين، يُبتر التتبع. لأخذ العينات من جهة Collector انظر tail sampling مع OpenTelemetry وDynatrace.

يتبع التصدير إلى Dynatrace مسار OTLP المعتاد، المفصّل في OTel Collector لـ Dynatrace. وإن لم يصل شيء، فراجع أولًا تشخيص التتبعات الغائبة. وإذا كان OneAgent وOpenTelemetry يقيسان العميل نفسه، فاحذر تكرار spans.

كيف تتحقق من أن الأمر يعمل

في Dynatrace SaaS افتح Notebook. يحدد هذا الاستعلام التتبعات التي تعبر خدمتين على الأقل لطابورك:

fetch spans, from: now() - 1h
| filter messaging.system == "rabbitmq"
| summarize services = collectDistinct(service.name), spans = count(), by: { trace.id }
| filter arraySize(services) >= 2
| limit 20

في المعالجات المرتبطة برابط لا بأب يبقى تتبع العامل منفصلًا: ابحث إذن عن spans تحمل روابط، عبر filter isNotNull(span.links) (الحقل span.links وارد في القاموس الدلالي لـ Dynatrace). تعتمد أسماء الحقول وقيمة messaging.system على أداة القياس لديك: تحقق منها أولًا بـ fetch spans | limit 10. وإذا لم يظهر شيء رغم أن الخدمتين ترسلان، فالسياق مفقود بينهما. هذه النقطة تحتاج إلى تأكيد في بيئتك: لم تنفّذ span.observer الاستعلام.

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

  • صيغة نشر واحدة في كل مكان: tracecontext.
  • سمِّ الـ spans على النحو «<الطابور> publish» و«<الطابور> process» لبحث مقروء.
  • قِس التأخر بين النشر والمعالجة: إنه SLI طبيعي لخط معالجة غير متزامن، وأوضح من زمن استجابة HTTP.
  • أبقِ السياق بعيدًا عن بيانات الأعمال في الرسالة: ضعه في حقل بيانات وصفية مخصص، مثل trace_headers.
  • تجنب البيانات الشخصية في baggage: فهو يسافر مع كل رسالة.

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

رابط span أم أب: ماذا نختار للعامل؟

للدفعة، الرابط هو الخيار الوحيد. أما للرسالة الواحدة فيعطي الأب تتبعًا من قطعة واحدة، لكن اتفاقيات OpenTelemetry تنصح بعدم اعتماده افتراضيًا حين تُنفَّذ المعالجة أصلًا داخل span آخر. عند الشك، استخدم الرابط.

هل ينجو السياق من تأخير يمتد ساعات؟

السياق مجرد سلسلة نصية مخزّنة مع الرسالة: ينجو ما دامت الرسالة موجودة. أما التتبع فيتوقف على الاحتفاظ وحدود الاستيعاب. تذكر Dynatrace مثلًا أنه لا يجب أن ينتهي span قبل أكثر من 60 دقيقة في الماضي عند الاستيعاب.

هل يجب تعديل الوسيط (broker)؟

لا. ينقل الوسيط الرسالة كما هي. المنتج والمستهلك وحدهما يحقنان السياق ويستخرجانه.

الخلاصة

الحقن عند الإرسال، والاستخراج عند الاستقبال، والربط برابط متى أمكن وجود دفعة: ثلاث حركات تكفي لإبقاء الطلب ومعالجته المؤجلة مترابطين. فيتتبع فريق المناوبة فاتورة من API إلى العامل دون ربط يدوي، ويصبح SLI زمن المعالجة قابلًا للحساب. للصورة الشاملة انظر OpenTelemetry من البداية إلى النهاية. المصادر الرسمية: اتفاقيات المراسلة في OpenTelemetry ومواصفة W3C Trace Context.

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. تحقق دائمًا من القيم (المنافذ والإصدارات والأحجام) في الوثائق الرسمية الخاصة بإصدارك.

Total
0
Shares
Leave a Reply

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

Previous Post
Seuil statique Dynatrace ou baseline : configurer la détection d'anomalies

العتبة الثابتة Dynatrace أم baseline: ضبط اكتشاف الشذوذ

Next Post
Passerelle LLM : suivre les coûts avec LiteLLM et Helicone

بوابة LLM: تتبّع التكاليف باستخدام LiteLLM وHelicone

Related Posts