الانتقال إلى المحتوى الرئيسي
يُنفِّذ استعلام Prometheus باستخدام بيانات من جدول TimeSeries.

البنية

الوسيطات

  • db_name - اسم قاعدة البيانات التي يوجد فيها جدول TimeSeries.
  • time_series_table - اسم جدول TimeSeries.
  • promql_query - استعلام مكتوب بصيغة PromQL.
  • evaluation_time - الطابع الزمني للتقييم. لتقييم استعلام في الوقت الحالي، استخدم now()باعتبارهevaluation_time`.

القيمة المُعادة

يمكن أن تُرجع الدالة أعمدة مختلفة بحسب نوع نتيجة الاستعلام المُمرَّر إلى المعامل promql_query:

الميزات المدعومة في PromQL

المُحدِّدات

المُحدِّدات الآنية، ومُحدِّدات النطاق، ومطابقات التسميات (=, !=, =~, !~)، ومُعدِّلات الإزاحة، ومُعدِّلات الطابع الزمني @، والاستعلامات الفرعية.

الدوال

ملاحظة: تستخدم histogram_quantile الاستيفاء الخطي على حاويات المُدرَّج التكراري التقليدي (التي يحدّدها الوسم le). لا يزال دعم المُدرَّجات التكرارية الأصلية غير متاح، ويجب أن تكون قيمة المعامل phi (مستوى quantile) حاليًا scalar ثابتًا — وتُرفض التعبيرات التي تتغيّر في كل خطوة، مثل histogram_quantile(time() / 1000, ...)، مع الخطأ NOT_IMPLEMENTED.

المعاملات

جميع المعاملات الثنائية: الحسابية (+, -, *, /, %, ^)، ومعاملات المقارنة (==, !=, <, >, <=, >= مع bool اختياري)، والمعاملات المنطقية (and, or, unless)، مع مُعدِّلات on()/ignoring() وgroup_left()/group_right(). والمعاملات الأحادية + و-.

معاملات التجميع

sum, avg, min, max, count, stddev, stdvar, group, quantile, topk, bottomk, limitk — مع مُعدِّلات اختيارية من نوع by() أو without(). غير مدعوم حتى الآن: count_values.

مثال

آخر تعديل في ٢ يوليو ٢٠٢٦