prometheusQuery

يُنفِّذ استعلام 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 DateTime64(S, TZ), value Float64	prometheusQuery(mytable, ‘up’)
matrix	tags Array(Tuple(String, String)), samples Array(Tuple(DateTime64(S, TZ), Float64))	prometheusQuery(mytable, ‘up[1m]‘)
scalar	timestamp DateTime64(S, TZ), value Float64	prometheusQuery(mytable, ‘1h30m’)
string	timestamp DateTime64(S, TZ), value String	prometheusQuery(mytable, ‘“abc”’)

تكون القيم دائمًا من النوع Float64 بغض النظر عن نوع القيم في جدول TimeSeries. وتساوي دقة S للطوابع الزمنية دقتها في الجدول، على ألا تقل عن 3 (مللي ثانية). وتكون المنطقة الزمنية TZ هي المنطقة الزمنية لـevaluation_time إذا كان نوعه DateTime أو DateTime64 مع منطقة زمنية، وإلا فهي المنطقة الزمنية للطوابع الزمنية في الجدول. يُسمّى العمود samples بالاسم time_series إذا كان الجدول TimeSeries من version 2 أو أقدم.

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

المُحدِّدات

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

الدوال

الفئة	الدوال
النطاق	`rate`, `irate`, `delta`, `idelta`, `increase`, `last_over_time`, `first_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`, `ts_of_last_over_time`, `ts_of_first_over_time`, `deriv`, `changes`, `resets`, `present_over_time`, `absent_over_time`, `quantile_over_time`, `stddev_over_time`, `stdvar_over_time`, `mad_over_time`, `predict_linear`
الرياضيات	`abs`, `sgn`, `floor`, `ceil`, `sqrt`, `exp`, `ln`, `log2`, `log10`, `rad`, `deg`, `round`, `clamp`, `clamp_min`, `clamp_max`, `min_of`, `max_of`
المثلثات	`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`, `timestamp`

ملاحظة: تستخدم histogram_quantile الاستيفاء الخطي على حاويات المُدرَّج التكراري التقليدي (التي يحدّدها تسمية le). لا يتم دعم المُدرَّجات التكرارية الأصلية. يجب أن تكون قيمة وسيطة phi (مستوى quantile) scalar ثابتًا. وتُرفض التعبيرات التي تتغيّر في كل خطوة، مثل histogram_quantile(time() / 1000, ...)، مع استثناء NOT_IMPLEMENTED. ملاحظة: تُرجع min_of(a, b) وmax_of(a, b) القيمة الأصغر والأكبر، على الترتيب، من بين قيمتين من النوع scalar. ويجب أن تكون كلتا الوسيطتين من النوع scalar. ملاحظة: تُعدّ min_of وmax_of وts_of_min_over_time وts_of_max_over_time وts_of_last_over_time وfirst_over_time وts_of_first_over_time وmad_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().

مثال

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

مرجع SQL

أنواع البيانات

المحركات

الدوال

الصيغ

الإعدادات

جداول النظام

بحيرات البيانات

البنية

الوسيطات

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

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

المُحدِّدات

الدوال

العوامل

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

مثال

​البنية

​الوسيطات

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

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

​المُحدِّدات

​الدوال

​العوامل

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

​مثال

البنية

الوسيطات

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

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

المُحدِّدات

الدوال

العوامل

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

مثال