DQL timeframe: المعاملان from وto ولماذا يعيد الاستعلام صفوفًا قليلة

DQL timeframe: افهم النافذة الزمنية المطبّقة على fetch ومعاملات from وto وtimeframe، ثم أصلح استعلام DQL يعيد صفوفًا قليلة بخطوات واضحة.
DQL timeframe : from, to et pourquoi peu de lignes

تشغّل استعلام 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. الأمثلة أدناه مأخوذة من تلك الصفحة، أما التعليقات فأضفناها نحن.

أربعة أمثلة على fetch logs: من دون معامل، ومع from:-25m، ومع from:-24h وto:-2h، ومع timeframe مطلق، مصحوبة بتعليقات بالفرنسية

مدد نسبية مع 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 صريح.

جدول يلخص معاملات fetch: from وto وtimeframe وsamplingRatio وscanLimitGBytes، مع أثر كل منها وقيمها الافتراضية

لماذا يعيد استعلام DQL صفوفًا قليلة: قائمة الفحص

تقدّم بهذا الترتيب، من الأكثر شيوعًا إلى الأندر. يمكن التحقق من كل نقطة في ثوانٍ.

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

مقارنة واقعية قبل التصحيح وبعده

فيما يلي استعلامان يحصيان أخطاء السجلات. الأول يجمع ثلاثة فخاخ: نافذة ضمنية، وlimit قبل التجميع، واعتماد على المحدِّد. والثاني يصلحها. أسماء الحقول هي المستعملة عادةً في السجلات؛ كيّفها مع بيئتك.

استعلاما DQL جنبًا إلى جنب: fetch logs مع filter ثم limit 20 ثم summarize، والنسخة المصححة مع from:-24h من دون limit

في الأول، يقلّص limit 20 التدفق إلى عشرين سجلًا قبل summarize: لن يتجاوز العدّاد 20 مهما كان الحجم الحقيقي. وفي الثاني، النافذة مكتوبة، ويشمل العدّاد كل أخطاء آخر 24 ساعة. إذا أردت عرض بضعة صفوف كمثال فقط، فضع limit بعد التجميع أو في استعلام منفصل.

التحقق من أن الاستعلام يقرأ الفترة الصحيحة

بعد التصحيح، تحقق بثلاث خطوات:

  1. شغّل الاستعلام بنافذة واسعة (from:-7d) ثم بنافذة ضيقة: يجب أن يتغير عدد الصفوف بصورة متسقة.
  2. قارن مع استعلام أدنى، fetch logs, from:-24h | summarize count()، لمعرفة الحجم الكلي قبل الترشيح.
  3. لحادث سابق، انتقل إلى 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. تنصح الوثائق بتجنب هذا الترتيب، إلا بقصد صريح، لأنه يجعل النتائج المجمّعة خاطئة.

المصادر

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
Auditer serveurs MCP en entreprise : inventaire, jetons, portées et outils

تدقيق خوادم MCP في المؤسسة: الجرد والرموز والنطاقات والأدوات

Next Post
Conventions sémantiques OpenTelemetry : stabilité et impact sur vos attributs

اتفاقيات OpenTelemetry الدلالية: الاستقرار وأثره على سماتك

Related Posts