prometheusQuery

يُنفِّذ استعلام Prometheus باستخدام بيانات من جدول TimeSeries.

يُنفِّذ استعلام Prometheus باستخدام بيانات من جدول TimeSeries.

​

البنية

prometheusQuery('db_name', 'time_series_table', 'promql_query', evaluation_time)
prometheusQuery(db_name.time_series_table, 'promql_query', evaluation_time)
prometheusQuery('time_series_table', 'promql_query', evaluation_time)

​

الوسيطات

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

​

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

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

نوع النتيجة	أعمدة النتيجة	مثال
vector	tags Array(Tuple(String, String)), timestamp TimestampType, value ValueType	prometheusQuery(mytable, ‘up’)
matrix	tags Array(Tuple(String, String)), samples Array(Tuple(TimestampType, ValueType))	prometheusQuery(mytable, ‘up[1m]‘)
scalar	scalar ValueType	prometheusQuery(mytable, ‘1h30m’)
string	string String	prometheusQuery(mytable, ‘“abc”’)

يُسمّى العمود samples بالاسم time_series إذا كان الجدول TimeSeries من version 2 أو أقدم.

​

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

​

المُحدِّدات

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

​

الدوال

الفئة	الدوال
النطاق	rate, irate, delta, idelta, increase, last_over_time, sum_over_time, avg_over_time, count_over_time, max_over_time, min_over_time, ts_of_max_over_time, ts_of_min_over_time, deriv, changes, resets, present_over_time, absent_over_time, quantile_over_time, predict_linear
الرياضيات	abs, sgn, floor, ceil, sqrt, exp, ln, log2, log10, rad, deg, round, clamp, clamp_min, clamp_max
المثلثات	sin, cos, tan, asin, acos, atan, sinh, cosh, tanh, asinh, acosh, atanh
DateTime	day_of_week, day_of_month, days_in_month, day_of_year, minute, hour, month, year
تسمية	label_replace, label_join
النوع	scalar, vector
مُدرَّج تكراري	histogram_quantile
أخرى	time, pi, absent

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

ملاحظة: تُعدّ ts_of_min_over_time وts_of_max_over_time دالتين تجريبيتين في Prometheus (تُفعّلان فيه باستخدام --enable-feature=promql-experimental-functions)؛ ويقيّمهما ClickHouse دون اشتراط تلك العلامة.

​

العوامل

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

عوامل المجموعات المنطقية and وor وunless، مع مُعدِّلات on()/ignoring().

والعوامل الأحادية + و-.

​

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

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

​

غير مدعوم حاليًا

• دوال النطاق stddev_over_time، stdvar_over_time، mad_over_time، first_over_time، ts_of_last_over_time، ts_of_first_over_time

​

مثال

SELECT * FROM prometheusQuery(mytable, 'rate(http_requests{job="prometheus"}[10m])[1h:10m]', now())