timeSeriesRateToGrid
متاحة بدءًا من: v25.6.0 دالة تجميع تأخذ بيانات السلاسل الزمنية على هيئة أزواج من الطوابع الزمنية والقيم، وتحسب معدلًا بأسلوب PromQL من هذه البيانات على شبكة زمنية منتظمة يحددها الطابع الزمني للبداية والطابع الزمني للنهاية والخطوة. ولكل نقطة على الشبكة، تُؤخذ العينات اللازمة لحسابrate ضمن النافذة الزمنية المحددة.
يمكن تمرير العينات بإحدى ثلاث صور:
- كوسيطتين
timestampوvalue، حيث يحمل كل صف عينة واحدة؛ - كمصفوفتين من الطوابع الزمنية والقيم، حيث يحمل كل صف سلسلة زمنية كاملة؛
- كمصفوفة واحدة من Tuples على هيئة
(timestamp, value)، حيث يحمل كل صف سلسلة زمنية كاملة.
start_timestamp— يحدد بداية الشبكة. مع وسيطة طابع زمني من النوعDateTime64، يمكن أن يكون أيضًا رقمًا كسريًا، أو سلسلة تحتوي على رقم أو نص تاريخ-ووقت.UInt32أوDateTimeأوDateTime64أوFloat*أوDecimal*أوStringend_timestamp— يحدد نهاية الشبكة. مع وسيطة طابع زمني من النوعDateTime64، يمكن أن يكون أيضًا رقمًا كسريًا، أو سلسلة تحتوي على رقم أو نص تاريخ-ووقت.UInt32أوDateTimeأوDateTime64أوFloat*أوDecimal*أوStringgrid_step— يحدد خطوة الشبكة بالثواني. مع وسيطة طابع زمني من النوعDateTime64، يمكن أن يكون أيضًا رقمًا كسريًا، أو سلسلة تحتوي على رقم أو مدة مثل ’15s’ أو ‘1m’.UInt32أوFloat*أوDecimal*أوStringstaleness— يحدد الحد الأقصى للتقادم، بالثواني، للعينات المأخوذة في الاعتبار. نافذة التقادم هي فترة مفتوحة من اليسار ومغلقة من اليمين. مع وسيطة طابع زمني من النوعDateTime64، يمكن أن يكون أيضًا رقمًا كسريًا، أو سلسلة تحتوي على رقم أو مدة مثل ’15s’ أو ‘1m’.UInt32أوFloat*أوDecimal*أوString
timestamp— الطابع الزمني للعينة. يمكن أن يكون قيمًا فردية أو Array.UInt32أوDateTimeأوDateTime64أوArray(UInt32)أوArray(DateTime)أوArray(DateTime64)value— قيمة السلسلة الزمنية المقابلة للطابع الزمني. يمكن أن تكون قيمًا فردية أو Array.Float*أوArray(Float*)samples— عينات السلسلة الزمنية المُمرَّرة على هيئة Array من Tuples بالشكل(timestamp, value)، حيث تكون عناصر Tuple من أنواع الطابع الزمني والقيمة المذكورة أعلاه. وهو بديل عن تمرير الطوابع الزمنية والقيم كوسيطتين منفصلتين.Array(Tuple(T1, T2))
Array(Nullable(Float64))
أمثلة
الاستخدام الأساسي مع أزواج فردية من الطابع الزمني والقيمة
Query
Response
Query
Response