استيعاب APM Datadog يحدد التتبعات التي تدخل المنصة، أما الاحتفاظ فيحدد التتبعات التي تبقى قابلة للاطلاع. هما إعدادان منفصلان، والخلط بينهما مكلف: تظن أنك تخفض الفاتورة بالتصفية في موضع، بينما يُحسم الحجم في موضع آخر. تفصل هذه المقالة بين مراحل مسار التتبعات (trace pipeline) استنادًا إلى الوثائق الرسمية لـ Datadog.
تخاطب المقالة فرق SRE والمنصات التي تستخدم Datadog APM بالفعل وتريد الاحتفاظ بالتتبعات المفيدة (الأخطاء، زمن الاستجابة المرتفع) دون دفع تكلفة كل ما عداها. القيم المذكورة مأخوذة من صفحات وثائق Datadog التي جرى الاطلاع عليها في 30 أكتوبر 2026؛ وقد تتغير، فتحقق من الصفحة قبل تثبيتها في runbook.
باختصار
- الاستيعاب (ingestion): الـ spans التي ترسلها حزم SDK والـ Agent إلى Datadog. يُضبط بعناصر التحكم في الاستيعاب وبأخذ العيّنات.
- الفهرسة (indexation): من بين الـ spans المستوعَبة، تختار فلاتر الاحتفاظ ما يُخزَّن ويمكن البحث فيه، لمدة 15 يومًا في الفلاتر المخصصة.
- المقاييس: تُحسب انطلاقًا من الـ spans المستوعَبة، سواء كانت مفهرسة أم لا.
- فلتر الاحتفاظ لا يقلل الاستيعاب: الوثائق تنص على ذلك صراحة.
استيعاب APM Datadog: ثلاث مراحل لا يجوز الخلط بينها
تصف صفحة Trace pipeline السلسلة كاملة: الاستيعاب، ومسارات المعالجة، والفهرسة والاحتفاظ، والمقاييس المولَّدة، ومتابعة الاستخدام. وبالنسبة لمهندس SRE تكفي ثلاثة أسئلة للاستدلال على المسار.
- ما الذي يُرسَل؟ هذا هو الاستيعاب. تقرر حزمة SDK والـ Agent، تتبعًا بتتبع، الاحتفاظ أو الرفض.
- ما الذي يُخزَّن ويمكن الاستعلام عنه؟ هذه هي الفهرسة، وتتحكم بها فلاتر الاحتفاظ.
- ما الذي يُجمَّع في منحنيات؟ هذه هي المقاييس، وتُحسب على ما جرى استيعابه.
الـ span المرفوض عند الاستيعاب لا وجود له في المرحلتين التاليتين. وبحسب وثائق المقاييس المبنية على الـ spans، لا يمكن لـ span استُبعد بأخذ العيّنات أن ينتج مقياسًا. وبالعكس، فإن span مستوعَبًا وغير مفهرس يغذّي هذه المقاييس مع ذلك. وبخصوص جانب RED، راجع مقالتنا عن مقاييس التتبع في Datadog.
عناصر التحكم في الاستيعاب: أخذ العيّنات من رأس التتبع
تعرض صفحة Ingestion Control استيعاب الشهر الجاري، وتوقع نهاية الشهر قياسًا إلى حصتك، وجدولًا لكل خدمة (تتبعات في الثانية وبايتات في الثانية خلال الساعة الأخيرة). ويربط رسم بياني لكل «سبب استيعاب» كل حجم بآلية محددة.
افتراضيًا، أخذ العيّنات من النوع head-based: يُتخذ القرار على الـ span الجذر ويسري على التتبع كله. وبحسب الوثائق، إذا لم تُعرَّف قاعدة لخدمة ما، يستهدف الـ Agent 10 تتبعات في الثانية ويحسب المعدلات بنفسه. يمكنك تغيير هذا الهدف في Datadog أو عبر DD_APM_TARGET_TPS (المفتاح target_traces_per_second في datadog.yaml).
يكمّل هذه الآلية مُعيِّنان للتتبعات التي لم يحتفظ بها أخذ العيّنات من الرأس: مُعيِّن الأخطاء (10 تتبعات خطأ في الثانية لكل Agent افتراضيًا، DD_APM_ERROR_TPS) ومُعيِّن التتبعات النادرة (معطَّل افتراضيًا، DD_APM_ENABLE_RARE_SAMPLER، الإصدار 7.41 من Agent أو أحدث).
كتابة القواعد في SDK
تُوضع القواعد من جهة التطبيق عبر DD_TRACE_SAMPLING_RULES، وهي مصفوفة JSON تتراوح فيها sample_rate بين 0 و1. المثال التالي هو مثال الوثائق: يُحتفظ بكل تتبعات GET /checkout وبنسبة 20% من باقي تتبعات الخدمة.

الأسبقية: بحسب الوثائق، تتقدم إعدادات الـ tracer على إعدادات الـ Agent، وتتقدم الإعدادات عن بُعد على الإعدادات المحلية. وإذا لم يتصرف معدل كما هو متوقع، فتحقق أولًا من صاحب الكلمة الأخيرة: الـ Agent أم الـ tracer أم الإعدادات عن بُعد.
قراءة أسباب الاستيعاب
يحمل كل تتبع مستوعَب سببًا. وتسرد صفحة Ingestion Mechanisms عدة أسباب: auto وrule وmanual تتبع أخذ العيّنات من الرأس؛ وerror وrare تأتي من مُعيِّنات الـ Agent؛ وsingle_span يحتفظ بـ spans معزولة؛ وotel يدل على بيانات OpenTelemetry.

أخذ العيّنات بـ span واحد (single_span) يحتفظ بـ spans استبعدها أخذ العيّنات من الرأس، دون حفظ التتبع كاملًا. ولا يمكنه حذف spans سبق الاحتفاظ بها. وهو مفيد لعدّ استدعاء محدد دون دفع تكلفة التتبعات الكاملة.
فلاتر الاحتفاظ والـ spans المفهرسة
بعد استيعاب الـ span، تشرح صفحة Trace retention ما الذي يجعله قابلًا للاطلاع. وتتعايش فئتان من الفلاتر.
فلتر الاحتفاظ الذكي
هو نشط دائمًا ويعمل بالتوازي مع فلاترك. ويجمع آليتين:
- Diversity sampling: كل 15 دقيقة على الأكثر، تتبع واحد على الأقل لكل توليفة من البيئة والخدمة والعملية والمورد؛ والتتبعات عند المئينات p75 وp90 وp95 لزمن الاستجابة؛ وتشكيلة متنوعة من الأخطاء (400، 500). وهو موجَّه نحو الأخطاء وأزمنة الاستجابة المرتفعة، فليس عيّنة متناسبة مع الحركة.
- 1% flat sampling: نحو 1% من الـ spans المستوعَبة، يُحسم على
trace_idكي يبقى التتبع كاملًا، والتتبعات المرتبطة بنسبة 1% من جلسات RUM المستوعَبة.
بحسب الوثائق، لا تدخل الـ spans التي يفهرسها في احتساب استخدام الـ spans المفهرسة، ولذلك لا تؤثر في الفاتورة. وتشير الصفحة إلى مدة احتفاظ تبلغ 30 يومًا. وبالتالي فإن «1%» ليست نسبة احتفاظ شاملة، بل حصة منتظمة تكمّلها عيّنة التنوع: قد تغيب خدمة ضعيفة الحركة في نطاقات زمنية قصيرة.
الفلاتر المخصصة
تحتفظ بالبيانات 15 يومًا. لكل فلتر استعلام احتفاظ (أي وسم أو سمة في الـ span، مثل env:prod أو @duration:>2s)، ومعدل spans من 0 إلى 100%، واختياريًا معدل تتبعات يفهرس التتبع كاملًا، بما في ذلك الـ spans التي لا تطابق الاستعلام.

يُقيَّم معدل الـ spans أولًا؛ ولا يُطبَّق معدل التتبعات إلا على التتبعات التي اختارها. وتوضح الوثائق أنه قد يزيد استخدام الـ spans المفهرسة زيادة كبيرة. وتُقيَّم الفلاتر بترتيب القائمة: فالـ span الذي احتفظ به فلتر لا يُعاد النظر فيه في الفلاتر التالية.
مراقبة التكاليف والاستخدام
يتتبع المقياس datadog.estimated_usage.apm.indexed_spans الـ spans التي تفهرسها الفلاتر المخصصة والافتراضية. وتعرض لوحتا المعلومات APM Estimated Usage وIngestion Reasons الأحجام المستوعَبة والمفهرسة. ولا تُذكر الأسعار هنا: راجع صفحة التسعير الرسمية لـ Datadog للاطلاع على المبالغ السارية.
هذا القياس مؤشر جيد على صحة منصة قابلية الملاحظة: تابعه كأي SLI داخلي، مع تنبيه قبل نفاد الحصة الشهرية. ويمكن بناء تنبيه يجمع عدة شروط باستخدام composite monitor في Datadog.
خطوات لضبط مسار التتبعات
- افتح صفحة Ingestion Control وحدد الخدمات ذات الحجم الأكبر، وسبب الاستيعاب الرئيسي.
- قرر، خدمة بخدمة، ما يجب الاحتفاظ به بنسبة 100% (المسارات الحرجة، الدفع) وما يمكن خفضه، بقواعد
DD_TRACE_SAMPLING_RULES. - أنشئ فلاتر احتفاظ موجَّهة (
env:prod، مدة مرتفعة، حالة خطأ) بدل معدل شامل. - أبقِ الفلتر الذكي شبكة أمان، دون عدّه عيّنة تمثيلية.
- أنشئ مقاييس من الـ spans المستوعَبة لمؤشرات SLO طويلة الأجل، بدل فهرسة التتبعات من أجل العدّ.
- أعد التحقق بعد كل تغيير من أسباب الاستيعاب ومن مقياس الاستخدام المفهرس.
كيف تتحقق من أن الإعداد يعمل
بعد تغيير قاعدة، انظر إلى الرسم البياني حسب سبب الاستيعاب في صفحة Ingestion Control: يجب أن ينتقل الحجم المتوقع إلى السبب rule. وفي Trace Explorer، ابحث عن حالة معروفة (خطأ حديث في الخدمة المعدَّلة) وتأكد من أن تتبعها مفهرس. وإذا لم يظهر التتبع، فقد حُسم القرار عند الاستيعاب، لا عند الاحتفاظ.
العلاقة مع OpenTelemetry وDynatrace
تحمل بيانات OpenTelemetry المرسلة إلى Datadog السبب otel الوارد في القائمة أعلاه. ولفهم الفرق بين أخذ العيّنات من الرأس ومن الذيل في OpenTelemetry، راجع مقالتنا عن tail sampling في OpenTelemetry: منطق القرار مختلف، لأنه ينتظر نهاية التتبع. وللاطلاع على نظرة عامة على المنصتين، راجع مقارنة Dynatrace وDatadog. يصف هذا النص Datadog؛ ولا يدّعي أي تكافؤ في الميزات مع Dynatrace.
أفضل الممارسات
- افصل ذهنيًا بين الاستيعاب والفهرسة والمقاييس قبل لمس أي إعداد.
- احتفظ بنسبة 100% من تتبعات الأخطاء وزمن الاستجابة المرتفع في المسارات الحرجة.
- تجنب معدلات التتبعات المرتفعة في الفلاتر المخصصة دون قياس الأثر على الاستخدام.
- وثّق القواعد في مستودع التطبيق، لا في الواجهة فقط.
- راجع القواعد عند كل تغيير في الحركة أو الحصة.
الأسئلة الشائعة
ما الفرق بين الاستيعاب والفهرسة في Datadog APM؟
الاستيعاب هو إرسال الـ spans إلى Datadog، ويُضبط بأخذ العيّنات. أما الفهرسة فهي التخزين القابل للاستعلام لجزء من الـ spans المستوعَبة، وتتحكم فيها فلاتر الاحتفاظ. فلتر الاحتفاظ لا يقلل الاستيعاب.
هل يحتفظ الفلتر الذكي فعلًا بنسبة 1% من التتبعات؟
لا، ليس هذا فحسب. فهو يجمع عيّنة تنوع موجَّهة نحو الأخطاء وأزمنة الاستجابة، وعيّنة منتظمة بنحو 1% من الـ spans المستوعَبة. وليس عيّنة متناسبة مع الحركة.
هل يمكن الاحتفاظ بالمقاييس دون فهرسة التتبعات؟
نعم. تُحسب المقاييس المبنية على الـ spans على الـ spans المستوعَبة، سواء كانت مفهرسة أم لا. وتُحتسب تكلفتها كمقاييس مخصصة، فتجنب السمات ذات الكاردينالية العالية.
الخلاصة
للتحكم في Datadog APM، يُضبط الاستيعاب أولًا، ثم تُجرى الفهرسة بفلاتر موجَّهة، وتُعتمد المقاييس للأجل الطويل. تحقق من كل قيمة في وثائق موقع Datadog الخاص بك، لأن القيم الافتراضية قد تتغير.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا لشركة Datadog Inc. أسماء المنتجات المذكورة ملك لأصحابها؛ والقيم مأخوذة من وثائق Datadog التي جرى الاطلاع عليها في 30 أكتوبر 2026، والأمثلة هي أمثلة تلك الوثائق. تحقق دائمًا من القيم في الوثائق الرسمية الخاصة بإصدارك.