مقاييس ES|QL في Elasticsearch: الأمر TS في Discover

مقاييس ES|QL في Elasticsearch: الأمر TS ودالتا RATE وAVG_OVER_TIME وحالته الحالية والأمر PROMQL، مع استعلام قابل للتكييف مع بيئتك.
ES|QL métriques Elasticsearch : la commande TS dans Discover

مقاييس ES|QL في Elasticsearch: أصبحت الاستعلامات على المقاييس تمرّ الآن عبر أمر مخصص هو TS. يقرأ هذا الأمر فهارس السلاسل الزمنية ويتيح حساب المعدلات والمتوسطات من دون كتابة تجميعات Query DSL. قدّمته Elastic في أكتوبر 2025 في مقال في Observability Labs التابع لها (الإصدار Elastic Observability 9.2، بحالة «tech preview»)، مع استكشاف للمقاييس في Discover.

تقدّم هذه المقالة حصيلة لفريق SRE أو فريق المنصة: ما الذي يفعله TS، وما حالته اليوم، وكيف تكتب أول استعلام، وماذا يغيّر الأمر PROMQL في ES|QL لمن يأتي من Prometheus. الوقائع مأخوذة من صفحات Elastic الرسمية التي روجعت في 30 أكتوبر 2026. وهي تخص Elasticsearch لا Dynatrace؛ أما العلاقة بـ Dynatrace فتُعالج لاحقًا.

باختصار

  • TS أمر مصدر، قريب من FROM، لا يقرأ إلا الفهارس ذات الوضع time_series.
  • بحسب الوثائق، هو متاح للعموم (disponibilité générale) على Elastic Cloud Serverless، وبالنسبة إلى Elastic Stack متاح للعموم منذ الإصدار 9.4 (معاينة من 9.2 إلى 9.3). فمقال أكتوبر 2025 متأخر إذن عن الحالة الراهنة.
  • للاستعلام مستويان: دالة داخلية لكل سلسلة (RATE أو AVG_OVER_TIME)، ثم دالة خارجية (SUM أو AVG) تجمّع النتائج.
  • بالنسبة إلى العدّادات، توصي الوثائق باستخدام TS بدل FROM | STATS.

مقاييس ES|QL في Elasticsearch: ما الذي يفعله الأمر TS

المقياس سلسلة من النقاط الموسومة بالوقت. عدّاد طلبات HTTP لا يزداد إلا، ما لم يُعاد إلى الصفر عند إعادة تشغيل عملية. لذلك لا معنى يُذكر لجمع قيمه الخام. توضح صفحة المرجع الخاصة بالأمر أن RATE() أو INCREASE() تحسبان أولًا التغيّرات لكل سلسلة، مع معالجة إعادات الضبط إلى الصفر، قبل أي تجميع.

المبدأ هو مبدأ المستويين. تُنفَّذ الدالة الداخلية لكل سلسلة زمنية، وغالبًا لكل شريحة زمنية. ثم تدمج الدالة الخارجية النتائج حسب المجموعة. إذا أهملت الدالة الداخلية، تُطبَّق LAST_OVER_TIME() ضمنيًا على الحقول الرقمية. وهذا التكافؤ مذكور في مقال Elastic.

ثلاثة أسطر ES|QL: TS metrics مع STATS AVG، والاستعلام نفسه مع LAST_OVER_TIME صريحة، وSUM(RATE) لكل TBUCKET مدته ساعة ولكل host

الفائدة الثانية تخص المقاييس المنشورة على فترات غير منتظمة. فعند اختزال كل سلسلة أولًا إلى قيمة واحدة لكل شريحة، لا يعود host كثير الإرسال يهيمن على المتوسط، بحسب وثائق Elastic.

الحالة والإصدار: أين وصلت الميزة

يتحدث عنوان المقال عن «tech preview». وهو يعود إلى أكتوبر 2025 ويستهدف الإصدار 9.2. أما صفحة المرجع الحالية فتذكر أمرًا آخر: إتاحة للعموم منذ 9.4 لـ Elastic Stack، ومعاينة من 9.2 إلى 9.3، وإتاحة للعموم على Serverless. تحقق إذن من إصدارك قبل بناء runbook على هذا الأمر.

تختلف التفاصيل بحسب الدوال. وفقًا لصفحة دوال تجميع السلاسل الزمنية، فإن RATE وINCREASE وAVG_OVER_TIME وLAST_OVER_TIME متاحة للعموم منذ 9.4. أما PERCENTILE_OVER_TIME وSTDDEV_OVER_TIME وDERIV فتظهر بوصفها معاينة في 9.3، وتُذكر CHANGES على أنها مخطط لها. أعد قراءة هذا الجدول عند كل ترقية للإصدار.

مقتطف من وثائق ES|QL: الدوال RATE وINCREASE وIRATE وAVG_OVER_TIME وMAX_OVER_TIME وLAST_OVER_TIME وDELTA مع نوع المقياس لكل منها

كتابة أول استعلام باستخدام TS

المتطلبات: فهرس أو data stream بالوضع time_series (TSDS)، في إصدار من Elasticsearch يوفّر TS. أسماء الحقول أدناه أمثلة عليك استبدالها بأسماء حقولك.

  1. استهدف فهارس المقاييس. بحسب الوثائق، لا تطابق أحرف البدل (wildcards) إلا فهارس السلاسل الزمنية وتتجاهل الباقي بصمت.
  2. حدّد النطاق الزمني. تنصح الوثائق بمرشّح على @timestamp.
  3. اختر الدالة الداخلية بحسب نوع المقياس: RATE للعدّاد، وAVG_OVER_TIME للمقياس القياسي (gauge).
  4. اختر الدالة الخارجية والتجميع، مثلًا حسب الشريحة الزمنية بـ TBUCKET وحسب الخدمة.
TS metrics-*
| WHERE @timestamp >= NOW() - 1 hour
| STATS requetes_par_seconde = SUM(RATE(http_requests_total))
        BY TBUCKET(5 minutes), service.name
| SORT requetes_par_seconde DESC

هذا الاستعلام مثال مكتوب انطلاقًا من صياغة الوثائق، وليس لقطة من بيئة إنتاج. نقطة تستحق الانتباه: توضح الوثائق أنه لا يمكن وضع SORT وFORK بين TS وأول STATS. هنا يأتي SORT بعده، وهذا مسموح.

الفخاخ الموثّقة

  • تضمين دالة سلسلة زمنية داخل أخرى يسبب خطأ.
  • تتحقق الدوال من metric_type للحقل: RATE يتطلب عدّادًا.
  • بعد أول STATS، يحسب COUNT(*) الصفوف لكل سلسلة لا المستندات. استخدم COUNT(champ) أو COUNT_OVER_TIME.
  • افتراضيًا، تُقتطع النتيجة عند 10000 صف.
  • خلط مقاييس ذات أبعاد بكاردينالية مختلفة في تعبير واحد ينشر قيمًا فارغة.

Discover ومستكشف المقاييس

يصف المقال أيضًا عرضًا شبكيًا في Discover. ينطلق من TS metrics-*، ويختار تجميعًا بحسب النوع (rate للعدّادات وavg للمقاييس القياسية)، ويتيح البحث عن مقياس بالاسم والتجميع حسب البعد. يعرض كل مقياس استعلام ES|QL الخاص به، المولَّد تلقائيًا والقابل للإضافة إلى dashboard. وفائدة ذلك عملية لمهندس SRE: ينطلق من الاستعلام الذي تنتجه الواجهة ثم يصقله يدويًا.

ويذكر المقال نفسه نقطة دخول OTLP أصلية للمقاييس، موجّهة خصوصًا إلى عمليات النشر المستضافة ذاتيًا، مع مكاسب في الإنتاجية أعلنتها Elastic (حتى 60 % عبر _otlp و25 % عبر _bulk). هذه أرقام من المورّد، ولم تتحقق منها span.observer.

ES|QL أم PromQL: الأمر PROMQL

إذا كان فريقك قادمًا من Prometheus، فإن ES|QL يقدّم طريقًا ثانيًا. بحسب صفحة الأمر، يعمل PROMQL مثل TS لكنه يقبل تعبير PromQL. وهو متاح للعموم منذ 9.5 وفي المعاينة في 9.4.

صياغة الأمر PROMQL في ES|QL ومثال باستخدام sum(rate(http_requests_total)) على فهارس metrics-generic.prometheus

توضح الصفحة أن PROMQL «يدعم معظم» PromQL لكن لا يدعمه كله. فالمعاملان and وunless، ومعدّلات المجموعات (on وignoring وgroup_left)، والمعامل @، والاستعلامات الفرعية، كلها تُرجع خطأ من جهة العميل. اختبر إذن قواعدك الحالية واحدة تلو الأخرى بدل افتراض توافق كامل. ولوضع PromQL مقابل OpenTelemetry، راجع OpenTelemetry وPrometheus: متكاملان.

ماذا يتغيّر لفريق SRE مع OpenTelemetry وDynatrace

بالنسبة إلى المقاييس المخزّنة في Elasticsearch، يقرّب TS حساب المعدلات مما تفعله الأدوات الموجّهة نحو المقاييس. وتصبح مؤشرات مستوى الخدمة (SLI) المبنية على العدّادات (معدل الأخطاء، الطلبات في الثانية) استعلامات مقروءة، مع ميزانية أخطاء قابلة للحساب. أما كلفة العملية فتبقى بحاجة إلى قياس: حدّد حجم فهارس السلاسل الزمنية والـ shards بحسب اختباراتك أنت.

أما من جهة OpenTelemetry، فيذكر المقال استقبال مقاييس OTLP؛ ونذكّر بأن التتبعات والمقاييس والسجلات إشارات مختلفة، وأن TS لا يعالج إلا المقاييس. وبالنسبة إلى مقاييس OpenTelemetry على Dynatrace، يوجد المكافئ المفاهيمي في الأمر timeseries من DQL، المعروض في دليلنا لأوامر DQL. هذا التقريب تشبيه وليس تكاملًا موثّقًا. يستغل Dynatrace SaaS لغة DQL فوق Grail؛ وبالنسبة إلى Managed، تحقق من الدوال المتاحة. وللمقارنة الأوسع بين المنصات، اقرأ مقارنتنا بين Dynatrace وDatadog.

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

  1. نفّذ TS metrics-* | LIMIT 5 في Discover بوضع ES|QL: ينبغي أن ترى صفوفًا مرتبة بحسب @timestamp تنازليًا. وعدم ظهور أي صف يشير غالبًا إلى فهارس ليست بالوضع time_series.
  2. نفّذ الاستعلام باستخدام RATE على عدّاد. أما الخطأ المتعلق بـ metric_type فيعني أن الحقل غير معرَّف كعدّاد في الـ mapping.
  3. قارن النتيجة برسم بياني موجود للفترة نفسها قبل ترحيل أي dashboard.

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

  • دوّن إصدار Elastic في الـ runbook: فحالة الدوال تتغير بين 9.2 و9.3 و9.4 و9.5.
  • استخدم RATE أو INCREASE للعدّادات، ولا تستخدم مجموعًا خامًا أبدًا.
  • رشّح @timestamp دائمًا قبل التجميع.
  • أبقِ الاستعلامات المولَّدة من Discover تحت التحكم في الإصدارات إذا كانت تغذّي تنبيهات.
  • تجنّب البحث عن مذنب: فالنتيجة المفاجئة تأتي في الغالب من الـ mapping لا من الفريق.

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

هل الأمر TS ما زال في tech preview؟

هكذا قدّمه مقال أكتوبر 2025. أما صفحة المرجع التي روجعت في 30 أكتوبر 2026 فتذكر إتاحة للعموم منذ 9.4 لـ Elastic Stack وعلى Serverless.

ما الفرق بين TS وFROM بالنسبة إلى المقاييس؟

لا يقرأ TS إلا فهارس السلاسل الزمنية ويفعّل دوالًا مثل RATE أو AVG_OVER_TIME داخل STATS. وبالنسبة إلى العدّادات، توصي به Elastic بدل FROM | STATS.

هل أستطيع إعادة استخدام استعلامات PromQL الخاصة بي؟

جزئيًا: يقبل الأمر PROMQL لغة PromQL، لكن ليس كل معاملاتها. اختبر كل قاعدة قبل الترحيل.

الخلاصة

يمنح الأمر TS لغة ES|QL مفردات للمقاييس: معدلات، وفروق، ومستويين من التجميع. تحقق من إصدارك، وابدأ باستعلام بسيط، وصادق على النتيجة بمقارنتها برسم بياني معروف. وللتعمق في جانب Prometheus، راجع Prometheus وDynatrace على Kubernetes.

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

Total
0
Shares
Leave a Reply

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

Previous Post
Coût Elastic Observability Serverless : dimensionner ingestion et rétention

تكلفة Elastic Observability Serverless: تحديد حجم الاستيعاب والاحتفاظ

Next Post
Sensitive Data Scanner Datadog : masquer les PII dans les logs

Datadog Sensitive Data Scanner: إخفاء البيانات الشخصية PII في السجلات

Related Posts