تشغّل استعلام DQL فيعيد بضعة صفوف فقط، أو لا شيء، مع أنك متأكد من وجود البيانات. والسبب في الغالب هو DQL timeframe: النافذة الزمنية المطبّقة على الاستعلام ليست التي تظنها. يشرح هذا المقال مصدر هذه النافذة، وكيف تعدّلها المعاملات from وto وtimeframe، وما الأسباب الأخرى لنتيجة شحيحة. ينطبق على Dynatrace SaaS (DQL وGrail)؛ أما Dynatrace Managed فغير معني.
بالنسبة لفريق SRE، الرهان ملموس: استعلام يحصي الأخطاء بأقل من حقيقتها يشوّه التشخيص أو مؤشر SLI أو تحليل post-mortem. من الأفضل أن تعرف في ثوانٍ هل المشكلة في النافذة أم في مرشّح أم في حدّ.
باختصار
- من دون معامل زمني في الاستعلام، تُطبَّق نافذة الواجهة («global timeframe»).
- بحسب الوثائق، النافذة الافتراضية ساعتان، ما لم تُضبط في التطبيق أو في API.
fromوtoداخلfetchلهما الأولوية على محدِّد الواجهة.- كذلك يفسّر النتيجة المقلّصة وجود
limitقبل التجميع، أو مرشّح صارم أكثر من اللازم، أو أخذ عيّنات.
من أين يأتي DQL timeframe لاستعلام ما
توصي وثائق DQL من Dynatrace، في صفحة «How to use DQL queries»، باختيار النافذة عبر عناصر التحكم في الواجهة. وعندما لا يحدد الاستعلام شيئًا، يُطبَّق النطاق الزمني المختار في الواجهة. وتذكر الصفحة نفسها أنه ما لم يُضبط خلاف ذلك في التطبيق أو في API فالنافذة الافتراضية ساعتان.
النتيجة المباشرة: fetch logs وحده يقرأ سجلات النافذة النشطة. إذا كان المحدِّد يعرض آخر ساعتين وكان الحادث قد وقع أمس، فسيعيد الاستعلام صفوفًا قليلة أو لا شيء. لا شيء معطّل: الاستعلام يجيب عن السؤال المطروح، لكن على فترة غير التي تقصدها.
لهذا الاعتماد على الواجهة أثر آخر: زميلان يشغّلان الاستعلام نفسه بمحدِّدين مختلفين يحصلان على نتيجتين مختلفتين. وفي notebook مشترك أو لوحة معلومات (dashboard) أو workflow، تجنّبك كتابة النافذة داخل الاستعلام هذا الفخ.
تثبيت النافذة بـ from وto وtimeframe
يقبل الأمر fetch، بحسب وثائق «commands example»، المعاملات الاختيارية from وto وtimeframe وsamplingRatio وscanLimitGBytes. الأمثلة أدناه مأخوذة من تلك الصفحة، أما التعليقات فأضفناها نحن.

مدد نسبية مع from وto
المدد الصالحة لـ from وto هي إزاحات بالنسبة إلى now(): القيمة -25m تعني قبل 25 دقيقة من الآن، و-2h قبل ساعتين. فالاستعلام fetch logs, from:-24h, to:-2h يقرأ الفترة الممتدة من 24 ساعة إلى ساعتين في الماضي. وهذا مفيد للمقارنة مع الفترة الأخيرة أو لاستبعاد الدقائق الأخيرة غير المكتملة بعد.
بحسب صفحة «How to use DQL queries»، تتقدم هذه المعاملات على الاختيار المضبوط في الواجهة. إذا كان الاستعلام يحتوي على from:-10m، فتغيير المحدِّد إلى 7 أيام لا يغيّر شيئًا: يظل الاستعلام يقرأ 10 دقائق. وهذا هو المصدر الكبير الثاني للمفاجآت، وهو عكس الأول.
نطاق مطلق مع timeframe
لنطاق ثابت، مثل نافذة حادث سابق، استخدم timeframe مع ختمين زمنيين بصيغة ISO 8601 تفصل بينهما شرطة مائلة، كما في مثال الوثائق: fetch logs, timeframe: "2021-10-20T00:00:00Z/2021-10-28T12:00:00Z". وبحسب الوثائق، لا يُستخدم from حينئذ إلا عند عدم تقديم timeframe صريح.

لماذا يعيد استعلام DQL صفوفًا قليلة: قائمة الفحص
تقدّم بهذا الترتيب، من الأكثر شيوعًا إلى الأندر. يمكن التحقق من كل نقطة في ثوانٍ.
- أي نافذة تُطبَّق؟ انظر إلى محدِّد الواجهة وابحث عن
fromأوtoأوtimeframeفي الاستعلام. أضف نافذة صريحة، مثلfrom:-24h، وأعد التشغيل. - هل يقطع
limitمبكرًا؟ الأمرlimitيحدّ عدد السجلات المعادة. وتحذّر صفحة «DQL best practices»: لا تضعlimitقبل التجميع إلا بقصد صريح، وإلا كانت النتائج المجمّعة خاطئة. - هل المرشّح صارم أكثر من اللازم؟ يُبقي
filterعلى السجلات المطابقة للشرط فقط. احذف الشروط واحدًا واحدًا لترى أيها يستبعد كل شيء. - هل يوجد
samplingRatio؟ بالنسبة إلى السجلات، تعيد القيمة 10 أو 100 أو 1000 أو 10000 نحو 1/N من السجلات الخام. والنتيجة غير حتمية. - هل يقيّد
bucketالمصدر؟ تقبل صيغةfetchمعاملًا هوbucket؛ وتذكره صفحة أفضل الممارسات وسيلةً لتقليص البيانات المقروءة. اختيار bucket غير مناسب يستبعد السجلات التي تبحث عنها. - هل يؤثر سقف القراءة؟ يتحكم
scanLimitGBytesفي كمية البيانات غير المضغوطة التي تقرؤها خطوةfetch؛ والقيمة الافتراضية 500 GB، وتحلّل القيمة-1كل بيانات النافذة. وفي نافذة ضخمة جدًا، تحقق من هذا المعامل.
مقارنة واقعية قبل التصحيح وبعده
فيما يلي استعلامان يحصيان أخطاء السجلات. الأول يجمع ثلاثة فخاخ: نافذة ضمنية، وlimit قبل التجميع، واعتماد على المحدِّد. والثاني يصلحها. أسماء الحقول هي المستعملة عادةً في السجلات؛ كيّفها مع بيئتك.

في الأول، يقلّص limit 20 التدفق إلى عشرين سجلًا قبل summarize: لن يتجاوز العدّاد 20 مهما كان الحجم الحقيقي. وفي الثاني، النافذة مكتوبة، ويشمل العدّاد كل أخطاء آخر 24 ساعة. إذا أردت عرض بضعة صفوف كمثال فقط، فضع limit بعد التجميع أو في استعلام منفصل.
التحقق من أن الاستعلام يقرأ الفترة الصحيحة
بعد التصحيح، تحقق بثلاث خطوات:
- شغّل الاستعلام بنافذة واسعة (
from:-7d) ثم بنافذة ضيقة: يجب أن يتغير عدد الصفوف بصورة متسقة. - قارن مع استعلام أدنى،
fetch logs, from:-24h | summarize count()، لمعرفة الحجم الكلي قبل الترشيح. - لحادث سابق، انتقل إلى
timeframeبأختام زمنية مطلقة، كي لا تتحرك النتيجة عند تغيير المحدِّد.
مع الأحجام الكبيرة، تذكّر الممارسة الرسمية: نافذة أقصر تعطي أداءً أفضل على بيانات متطابقة، ويجب الترشيح مبكرًا قبل اختيار الحقول أو التجميع. فتقليص النافذة لا ينبغي أن يكون ردّة فعل عمياء: اختر أقصر نافذة تغطي سؤالك.
أفضل الممارسات
- اكتب النافذة في الاستعلامات المشتركة (notebooks ولوحات المعلومات وworkflows) بدل الاعتماد على المحدِّد.
- رشّح مبكرًا، ورتّب في النهاية، ولا تضع
limitقبل التجميع من دون سبب. - وثّق أخذ العيّنات: إذا استخدمت
samplingRatio:100، فاضرب العدد في 100 كما في مثال الوثائق، ونبّه إلى أن النتيجة تقريبية. - استخدم
timeframeفي تحليلات post-mortem، ليبقى التحليل قابلًا للتكرار، بروح «بلا لوم» (blameless) في تحليلات post-mortem المبنية على DQL.
للمزيد
إذا كانت fetch وfilter ودوال التجميع ما تزال غير مألوفة لك، فابدأ بـوحدة أساسيات DQL. ولاستعلامات جاهزة للاستخدام على السجلات والتتبعات، راجع أمثلة استعلامات التشغيل، ولمنطق filter وsummarize راجع المقال عن أوامر DQL. المبدأ نفسه كما في دلالات group by المفصّلة في دليلنا عن summarize: استعلام DQL ينفّذ بالضبط ما يُكتب له، لا ما نتخيله.
أما في جانب OpenTelemetry، فيشمل هذا السلوك السجلات والتتبعات التي ترسلها أيضًا: إذا كان مُصدِّر لا يسلّم البيانات إلا منذ دقائق، فلن تُظهر نافذة قديمة جدًا شيئًا. تحقق من الفترة قبل الشك في Collector.
الأسئلة الشائعة
ما النافذة الافتراضية لاستعلام DQL؟
من دون معامل زمني، يستخدم الاستعلام النافذة المختارة في الواجهة. وبحسب وثائق Dynatrace، القيمة الافتراضية ساعتان، ما لم تُضبط في التطبيق أو في API.
ما الفرق بين from/to وtimeframe؟
يقبل from وto مددًا نسبية إلى now()، مثل -24h، أو أختامًا زمنية. أما timeframe فيصف نطاقًا كاملًا، مثل تاريخين بصيغة ISO 8601 تفصل بينهما شرطة مائلة. وإذا قُدّم timeframe، فلا يُستخدم from إلا من دون timeframe صريح.
لماذا يظل العدّاد عالقًا عند رقم صغير؟
ابحث عن limit موضوع قبل summarize. تنصح الوثائق بتجنب هذا الترتيب، إلا بقصد صريح، لأنه يجعل النتائج المجمّعة خاطئة.
المصادر
- أمر fetch (commands example)، وثائق Dynatrace
- How to use DQL queries، وثائق Dynatrace
- DQL best practices، وثائق Dynatrace
- DQL commands، وثائق Dynatrace
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. العلامات المذكورة تعود إلى مالكيها؛ وأمثلة الاستعلامات تعليمية ويجب تكييفها مع بيئتك. تحقق دائمًا من القيم (المنافذ والإصدارات والأحجام) في الوثائق الرسمية الخاصة بإصدارك.