timeSeries*() مثل
timeSeriesInstantRateToGrid,
timeSeriesLastToGrid,
وغيرها.
seriesDecomposeSTL
استُحدث في: v24.1.0 يفكّك بيانات السلاسل الزمنية باستخدام STL (إجراء تفكيك الاتجاه الموسمي المعتمد على Loess) إلى مكوّن موسمي واتجاه ومكوّن متبقٍّ. الصيغةseries— مصفوفة من القيم الرقميةArray((U)Int8/16/32/64)أوArray(Float*)period— عدد صحيح موجبUInt8/16/32/64
Array(Array(Float32), Array(Float32), Array(Float32), Array(Float32))
أمثلة
تفكيك بيانات السلاسل الزمنية باستخدام STL
Query
Response
seriesOutliersDetectTukey
أُضيفت في: v24.2.0 تكتشف القيم الشاذة في بيانات السلاسل الزمنية باستخدام Tukey Fences. الصيغةseries— مصفوفة من القيم الرقمية.Array((UInt8/16/32/64))أوArray(Float*)min_percentile— اختياري. الحد الأدنى للمئين المُستخدَم لحساب المدى بين الربيعين (IQR). يجب أن تكون القيمة ضمن النطاق [0.02,0.98]. القيمة الافتراضية هي 0.25.Float*max_percentile— اختياري. الحد الأقصى للمئين المُستخدَم لحساب المدى بين الربيعين (IQR). يجب أن تكون القيمة ضمن النطاق [0.02,0.98]. القيمة الافتراضية هي 0.75.Float*K— اختياري. قيمة ثابتة غير سالبة لاكتشاف القيم الشاذة الطفيفة أو الأشد. القيمة الافتراضية هي 1.5.Float*
Array(Float32)
أمثلة
الاكتشاف الأساسي للقيم الشاذة
Query
Response
Query
Response
seriesPeriodDetectFFT
أُضيف في: v23.12.0 يحدّد فترة بيانات السلاسل الزمنية المعطاة باستخدام FFT - تحويل فورييه السريع الصيغةseries— مصفوفة من القيم العددية.Array((U)Int8/16/32/64)أوArray(Float*)
series. وتكون NaN عندما يكون عدد نقاط البيانات أقل من أربع. Float64
أمثلة
اكتشاف الفترة باستخدام نمط بسيط
Query
Response
Query
Response
timeSeriesCopyTag
أُضيفت في: v26.1.0 تنسخ وسمًا محددًا من مجموعة وسوم (src_group) إلى مجموعة أخرى (dest_group).
وتستبدل الدالة أي قيم سابقة للوسم المنسوخ في dest_group.
إذا لم يكن الوسم المنسوخ موجودًا في src_group، فستزيله الدالة من dest_group أيضًا.
وتحاكي الدالة منطق النسخ في مُعدِّلات Prometheus
group left/group right.
هذه الدالة غير حتمية: قد تُرجع نتائج مختلفة للوسيطات نفسها.
dest_group— مجموعة الوسوم الوجهة.UInt64src_group— مجموعة الوسوم المصدر.UInt64tag_to_copy— اسم الوسم المراد نسخه.String
dest_group بالإضافة إلى الوسوم المنسوخة من src_group. UInt64
أمثلة
مثال
Query
Response
timeSeriesCopyTags
أُضيف في: v26.1.0 ينسخ الوسوم المحددة من مجموعة وسوم (src_group) إلى مجموعة أخرى (dest_group).
تستبدل الدالة أي قيم سابقة للوسوم المنسوخة في dest_group.
إذا كان بعض الوسوم المنسوخة غير موجود في src_group، فستحذفه الدالة من dest_group أيضًا.
تحاكي الدالة منطق النسخ في مُعدِّلات prometheus
group left/group right.
هذه الدالة غير حتمية: يمكن أن تُعيد نتائج مختلفة للمعاملات نفسها.
dest_group— مجموعة الوسوم الوجهة.UInt64src_group— مجموعة الوسوم المصدر.UInt64tags_to_copy— أسماء الوسوم المراد نسخها.Array(String)
dest_group بالإضافة إلى الوسوم المنسوخة من src_group. UInt64
أمثلة
مثال
Query
Response
timeSeriesExtractTag
قُدِّمت في: v26.1.0 تستخرج قيمة وسم محدد من المجموعة. وتُرجِع NULL إذا لم يُعثر عليه. انظر أيضًا الدالة timeSeriesGroupToTags().هذه الدالة غير حتمية: يمكن أن تُرجِع نتائج مختلفة للوسيطات نفسها.
Nullable(String)
أمثلة
مثال
Query
Response
timeSeriesFromGrid
أُضيف في: v25.8.0 يحوّل مصفوفة من القيم[x1, x2, x3, ...] إلى مصفوفة من Tuples
[(start_timestamp, x1), (start_timestamp + step, x2), (start_timestamp + 2 * step, x3), ...].
يُزاد الطابع الزمني الحالي بمقدار step حتى يصبح أكبر من end_timestamp
إذا لم يتطابق عدد القيم مع عدد الطوابع الزمنية، فإن الدالة تُطلق استثناءً.
يتم تخطي قيم NULL في [x1, x2, x3, ...]، ولكن يستمر مع ذلك زيادة الطابع الزمني الحالي.
على سبيل المثال، بالنسبة إلى [value1, NULL, x2] تُرجع الدالة [(start_timestamp, x1), (start_timestamp + 2 * step, x2)].
البنية
start_timestamp— بداية الشبكة.DateTime64أوDateTimeأوUInt32end_timestamp— نهاية الشبكة.DateTime64أوDateTimeأوUInt32step— خطوة الشبكة بالثوانيDecimal64أوDecimal32أوUInt32/64values— مصفوفة من القيمArray(Float*)أوArray(Nullable(Float*))
start_timestamp وstep. Array(Tuple(DateTime64, Float64))
أمثلة
مثال على الاستخدام
Query
Response
timeSeriesGroupToSamplingKey
تم تقديمه في: v26.4.0 يعيد مفتاح أخذ عيناتUInt64 ثابتًا مشتقًا من وسوم مجموعة محددة.
القيمة حتمية: فالوسوم المدخلة المتطابقة تُنتج دائمًا المفتاح نفسه.
وهو مخصّص ليكون مفتاح ترتيب لعمليات أخذ العينات مثل limitk وlimit_ratio.
هذه الدالة غير حتمية: قد تُرجع نتائج مختلفة للوسائط نفسها.
group— مجموعة من الوسوم.UInt64
UInt64 ثابتة مشتقة من الوسوم المرتبطة بالمجموعة. UInt64
أمثلة
مثال
Query
Response
timeSeriesGroupToTags
أُضيفت في: v26.1.0 تعيد أسماء الوسوم وقيمها المرتبطة بمجموعة محددة. راجع أيضًا الدالة timeSeriesTagsToGroup().هذه الدالة غير حتمية: قد تُرجع نتائج مختلفة للوسيطات نفسها.
timeSeriesTagsGroupToTags
الوسائط
group— مجموعة من الوسوم.UInt64
(tag_name, tag_value).
تكون المصفوفة المُعادة مرتبة دائمًا حسب tag_name، ولا تتضمن أبدًا tag_name نفسه أكثر من مرة.
Array(Tuple(String, String))
أمثلة
مثال
Query
Response
timeSeriesIdToGroup
قُدِّمت في: v26.1.0 تعيد أسماء الوسوم وقيمها المرتبطة بمُعرّف محدد لسلسلة زمنية. انظر أيضًا الدالة timeSeriesStoreTags().هذه الدالة غير حتمية: قد تُرجع نتائج مختلفة للوسائط نفسها.
timeSeriesIdToTagsGroup
الوسائط
id— معرّف سلسلة زمنية. يجب أن يكون من النوع نفسه الذي استُخدم عند استدعاء timeSeriesStoreTags().Any
id لسلسلة زمنية. UInt64
أمثلة
مثال
Query
Response
timeSeriesIdToTags
أُضيف في: v25.8.0 يعيد الوسوم المرتبطة بمُعرّف محدد لسلسلة زمنية. راجع أيضًا الدالة timeSeriesStoreTags().هذه الدالة غير حتمية: قد تُرجِع نتائج مختلفة للوسيطات نفسها.
id— معرّف سلسلة زمنية. يجب أن يكون من النوع نفسه المستخدم عند استدعاء timeSeriesStoreTags().Any
(tag_name, tag_value).
تكون المصفوفة المعادة مرتبة دائمًا حسب tag_name، ولا تحتوي أبدًا على tag_name نفسه أكثر من مرة.
Array(Tuple(String, String))
أمثلة
مثال
Query
Response
timeSeriesJoinTags
أُضيفت في: v26.1.0 تجمع هذه الدالة قيم الوسوم المحددة والمستخرجة من مجموعة وسوم. وتُدرِج فاصلاً بين القيم المجمّعة وتُرجع مجموعة وسوم جديدة يُضبط فيها الوسمdest_tag على القيمة المجمّعة.
وتحاكي هذه الدالة منطق دالة Prometheus
label_join().
هذه الدالة غير حتمية: فقد تُرجع نتائج مختلفة للوسائط نفسها.
group— مجموعة من الوسوم.UInt64dest_tag— اسم وسم لنتيجة الربط، وسيُضاف إلىgroup.Stringseparator— فاصل يُدرج بين القيم المربوطة.Stringsrc_tags— أسماء وسوم المصدر التي تحتوي على القيم التي سيجري ربطها.Array(String)
dest_tag إلى نتيجة الربط. UInt64
أمثلة
مثال
Query
Response
timeSeriesMetricTypeToSuffixes
أُضيف في: v26.8.0 يعيد لواحق أسماء المقاييس لعائلة مقاييس من نوع Prometheus معيّن. بنيةtype— نوع مقياس Prometheus (counter،gauge،histogram،summary، …).String
Array(String)
أمثلة
مثال
Query
Response
timeSeriesPrometheusValueToString
أُضيف في: v26.8.0 ينسّق قيمة عيّنة من نوع floating-point وفق دلالات قيم الـ label في Prometheus. تُكتب القيم المنتهية (finite) بالصيغة الثابتة مع أقصر تمثيل عشري يعود إلى القيمة نفسها عند التحويل العكسي (round-trip) إلىFloat64.
ويُحافَظ على الصفر السالب. أما القيم الخاصة فتُعاد على هيئة NaN و+Inf و-Inf.
البنية
value بصيغة متوافقة مع Prometheus. String
Examples
الترميز الثابت
Query
Response
timeSeriesRange
أُضيف في: v25.8.0 يُنشئ نطاقًا من الطوابع الزمنية [start_timestamp, start_timestamp + step, start_timestamp + 2 * step, …, end_timestamp]. إذا كانstart_timestamp مساويًا لـ end_timestamp، فستُرجِع الدالة مصفوفة من عنصر واحد تحتوي على [start_timestamp].
الدالة timeSeriesRange() مشابهة للدالة range.
البنية
start_timestamp— بداية النطاق.DateTime64أوDateTimeأوUInt32end_timestamp— نهاية النطاق.DateTime64أوDateTimeأوUInt32step— خطوة النطاق بالثواني.UInt32/64أوDecimal32/64
Array(DateTime64)
أمثلة
مثال على الاستخدام
Query
Response
timeSeriesRemoveAllTagsExcept
أُضيفت في: v26.1.0 يزيل كل الوسوم من مجموعة وسوم باستثناء الوسوم المحددة. راجع أيضًا الدالة timeSeriesRemoveTag(), timeSeriesRemoveTags().هذه الدالة غير حتمية: قد تُرجِع نتائج مختلفة للوسيطات نفسها.
group— مجموعة من الوسوم.UInt64tags_to_keep— أسماء الوسوم المطلوب الاحتفاظ بها في المجموعة.Array(String)
UInt64
أمثلة
مثال
Query
Response
timeSeriesRemoveTag
أُضيف في: v26.1.0 يزيل وسمًا محددًا من مجموعة من الوسوم. إذا لم يكن هذا الوسم موجودًا في المجموعة، فستُعاد المجموعة كما هي. انظر أيضًا الدالة timeSeriesRemoveTags()، timeSeriesRemoveAllTagsExcept().هذه الدالة غير حتمية: يمكن أن تُرجع نتائج مختلفة للوسيطات نفسها.
UInt64
أمثلة
مثال
Query
Response
timeSeriesRemoveTags
أُضيفت في: v26.1.0 تزيل الوسوم المحددة من مجموعة وسوم. إذا لم تكن بعض الوسوم المحددة موجودة في مجموعة الوسوم، فستتجاهلها الدالة. راجع أيضًا الدالة timeSeriesRemoveTag(), timeSeriesRemoveAllTagsExcept().هذه الدالة غير حتمية: قد تُرجع نتائج مختلفة للوسيطات نفسها.
group— مجموعة من الوسوم.UInt64tags_to_remove— أسماء الوسوم المطلوب إزالتها من المجموعة.Array(String)
UInt64
أمثلة
مثال
Query
Response
timeSeriesReplaceTag
أُضيف في: v26.1.0 يطابق التعبير النمطيregex قيمة الوسم src_tag.
إذا تحقق تطابق، فستكون قيمة الوسم dest_tag في المجموعة المُعادة هي الناتج عن توسيع replacement،
إلى جانب الوسوم الأصلية في الإدخال.
تحاكي هذه الدالة منطق دالة prometheus
label_replace().
هذه الدالة غير حتمية: يمكن أن تُرجِع نتائج مختلفة للوسيطات نفسها.
group— مجموعة من الوسوم.UInt64dest_tag— اسم وسم الوجهة الذي ستُحفَظ فيه المجموعة الناتجة.Stringreplacement— نمط استبدال، ويمكن أن يحتوي على 2 أو $name للإشارة إلى المجموعات الملتقطة في التعبير النمطي ‘regex’.Stringsrc_tag— اسم وسم تُستخدم قيمته لمطابقة التعبير النمطي ‘regex’.Stringregex— تعبير نمطي.String
dest_tag. UInt64
أمثلة
مثال
Query
Response
timeSeriesStoreTags
أُضيف في: v25.8.0 يخزّن في سياق الاستعلام تعيينًا بين معرّف محدد لسلسلة زمنية ومجموعة من الوسوم. يمكن استخدام الدالتين timeSeriesIdToTags() وtimeSeriesIdToGroup() للوصول إلى هذا التعيين لاحقًا أثناء تنفيذ الاستعلام. بنيةid— معرّف سلسلة زمنية. يمكن أن يكون من أي نوع قابل للمقارنة. يتم تخطي الصفوف ذات المعرّفات NULL.Anytags_array— مصفوفة من الأزواج (tag_name, tag_value).Array(Tuple(String, String))أوNULLseparate_tag_name_i— اسم وسم.StringأوFixedStringseparate_tag_value_i— قيمة وسم.StringأوFixedStringأوNullable(String)
Query
Response
timeSeriesTagsToGroup
قُدِّمت في: v26.1.0 تُرجع مجموعة من الوسوم المرتبطة بالوسوم المحددة. إذا عُثر على مجموعة الوسوم نفسها عدة مرات أثناء تنفيذ الاستعلام، فستُرجع الدالة المجموعة نفسها. إذا كانت مجموعة الوسوم فارغة، فستُرجع الدالة دائمًا 0. انظر أيضًا الدالة timeSeriesGroupToTags().هذه الدالة غير حتمية: قد تُرجع نتائج مختلفة للوسيطات نفسها.
tags_array— مصفوفة من الأزواج (tag_name, tag_value).Array(Tuple(String, String))أوNULLtag_name_i— اسم وسم.StringأوFixedStringtag_value_i— قيمة الوسم.StringأوFixedStringأوNullable(String)
UInt64
أمثلة
مثال
Query
Response
timeSeriesTagsToMap
أُضيف في: v26.8.0 يدمج مصفوفة من أزواج(tag_name, tag_value) مع وسيطات منفصلة لأسماء العلامات وقيمها في خريطة واحدة.
تُفرَز النتيجة حسب اسم العلامة، وتُزال أسماء العلامات المكررة والعلامات ذات القيم الفارغة.
البنية
tags_array— مصفوفة من الأزواج (tag_name، tag_value).Array(Tuple(String, String))أوMap(String, String)أوNULLtag_name_i— اسم وسم.StringأوFixedStringtag_value_i— قيمة وسم.StringأوFixedStringأوNullable(String)
Map(String, String)
أمثلة
مثال
Query
Response
timeSeriesThrowDuplicateSeriesIf
أُضيفت في: v26.2.0 تتحقق الدالة منcondition، وإذا كانت true فإنها تطرح استثناءً بالرسالة التالية
Multiple series have the same tags <tags>, duplicate series in the same result set are not allowed.
إذا كانت condition هي false، فتعيد الدالة 0.
تشبه هذه الدالة throwIf()،
لكنها تستخدم رمز خطأ مختلفًا وتنسّق رسالة الخطأ بطريقة مختلفة.
هذه الدالة غير حتمية: يمكن أن تعيد نتائج مختلفة للوسيطات نفسها.
condition— الشرط المراد التحقق منه، ويحتوي عادةً على الدالة count()UInt8group— مجموعة وسوم.UInt64
0. UInt8
أمثلة
سلسلة واحدة لكل مجموعة
Query
Response
Query
Response