### 1. تنبيهات البحث
تتيح لك تنبيهات البحث تشغيل الإشعارات استنادًا إلى نتائج بحث محفوظ. وهي تساعدك على اكتشاف الحالات التي تتكرر فيها أحداث أو أنماط معيّنة بمعدل أعلى (أو أقل) من المتوقع.
يتم تشغيل التنبيه عندما يتجاوز عدد النتائج المطابقة ضمن نافذة زمنية محددة عتبة معيّنة أو ينخفض عنه.
لإنشاء تنبيه بحث:
لكي تتمكن من إنشاء تنبيه لبحث ما، يجب أولًا حفظ هذا البحث. يمكنك إما إنشاء التنبيه لبحث محفوظ موجود، أو حفظ البحث أثناء عملية إنشاء التنبيه. في المثال أدناه، نفترض أن البحث غير محفوظ.
### 2. تنبيهات مخططات لوحة المعلومات
توسّع تنبيهات لوحة المعلومات إمكانات التنبيه لتشمل المخططات.
يمكنك إنشاء تنبيه يستند إلى مخطط مباشرةً من لوحة معلومات محفوظة، بالاستفادة من عمليات التجميع الكاملة في SQL ودوال ClickHouse لإجراء حسابات متقدمة.
عندما يتجاوز مقياس حدًا محددًا، يتم تشغيل تنبيه تلقائيًا، مما يتيح لك مراقبة مؤشرات الأداء الرئيسية أو فترات الاستجابة أو غيرها من المقاييس المهمة بمرور الوقت.
`. راجع [وثائق Slack](https://docs.slack.dev/messaging/sending-messages-using-incoming-webhooks/) لمزيد من التفاصيل.
**Slack (API)**
* رمز bot الخاص بـ Slack. راجع [وثائق Slack](https://docs.slack.dev/authentication/tokens/#bot/) لمزيد من التفاصيل.
**PagerDuty API**
* مفتاح التكامل الخاص بـ PagerDuty. راجع [وثائق PagerDuty](https://support.pagerduty.com/main/docs/api-access-keys) لمزيد من التفاصيل.
**Generic**
* عنوان URL الخاص بـ Webhook
* رؤوس Webhook (اختياري)
* محتوى Webhook (اختياري). يدعم المحتوى حاليًا متغيرات القالب `{{title}}` و`{{body}}` و`{{link}}`.
## إدارة التنبيهات
يمكن إدارة التنبيهات مركزيًا من خلال لوحة التنبيهات على الجانب الأيسر من HyperDX.
من هذا العرض، يمكنك رؤية جميع التنبيهات التي تم إنشاؤها والمفعّلة حاليًا في ClickStack.
يعرض هذا العرض أيضًا سجل تقييم التنبيهات. تُقيَّم التنبيهات على فاصل زمني متكرر (يُحدَّد بحسب الفترة/المدة التي ضُبطت عند إنشاء التنبيه). وأثناء كل تقييم، يستعلم HyperDX عن بياناتك للتحقق مما إذا كان شرط التنبيه قد تحقق:
* **الشريط الأحمر**: تحقق شرط العتبة خلال هذا التقييم وتم تفعيل التنبيه (أُرسل الإشعار)
* **الشريط الأخضر**: تم تقييم التنبيه، لكن شرط العتبة لم يتحقق (لم يُرسل أي إشعار)
كل تقييم مستقل؛ إذ يفحص التنبيه البيانات ضمن تلك النافذة الزمنية، ولا يتم تفعيله إلا إذا كان الشرط `true` في تلك اللحظة.
في المثال أعلاه، تم تفعيل التنبيه الأول في كل تقييم، ما يشير إلى وجود مشكلة مستمرة. أما التنبيه الثاني فيُظهر مشكلة جرى حلها؛ إذ تم تفعيله مرتين في البداية (أشرطة حمراء)، ثم في التقييمات اللاحقة لم يعد شرط العتبة متحققًا (أشرطة خضراء).
يؤدي النقر على تنبيه إلى نقلك إلى المخطط أو صفحة Search المرتبط بها التنبيه.
### حذف تنبيه
لإزالة تنبيه، افتح مربع حوار التعديل لصفحة البحث أو المخطط المرتبط، ثم اختر **إزالة التنبيه**.
في المثال أدناه، سيؤدي الزر `Remove Alert` إلى إزالة التنبيه من المخطط.
## تنبيهات المخططات المستندة إلى SQL
تتيح لك تنبيهات المخططات المستندة إلى SQL كتابة استعلامات ClickHouse SQL مخصّصة لتحديد شروط التنبيه. ويمنحك ذلك تحكمًا كاملًا في التصفية والتجميع والعمليات الحسابية — فأي شيء يمكنك التعبير عنه في SQL يمكن أن يتحول إلى تنبيه.
### أنواع المخططات المدعومة
تدعم التنبيهات المستندة إلى SQL ثلاثة أنواع من عرض المخططات:
| نوع المخطط | السلوك |
| --------------- | --------------------------------------------------------------------------------------------------------------------------- |
| **خطي** | تنبيه سلسلة زمنية. يجب أن يُنتج الاستعلام صفوفًا مُجمَّعة ضمن فترات زمنية. ويُقيَّم كل جزء زمني بشكل مستقل مقارنةً بالعتبة. |
| **شريط متراكم** | تنبيه سلسلة زمنية. له السلوك نفسه كما في المخطط الخطي. |
| **رقم** | تنبيه لقيمة واحدة. يُرجع الاستعلام نتيجة رقمية واحدة تُقارَن بالعتبة مرة واحدة في كل عملية تقييم. |
أما أنواع المخططات الأخرى المستندة إلى SQL (جدول، مخطط دائري، خريطة حرارية، إلخ) فلا تدعم التنبيهات.
### إنشاء تنبيه SQL
لإنشاء تنبيه لمخطط يستند إلى SQL:
#### أنشئ مخططًا يستند إلى SQL على لوحة معلومات أو افتحه
من لوحة معلومات محفوظة، يمكنك إما [إنشاء مخطط جديد باستخدام وضع مخطط **SQL**](/ar/clickstack/features/dashboards/sql-visualizations)، أو فتح مخطط حالي يستند إلى SQL لتحريره.
اختر **Line** أو **Stacked Bar** أو **Number** كنوع العرض.
#### أضف التنبيه
حدِّد **Add Alert** من قسم التنبيه في محرر المخطط. اضبط ما يلي:
* **نوع العتبة**: `>=` (أكبر من أو يساوي)، `>` (أكبر من)، `<=` (أقل من أو يساوي)، `<` (أقل من)، `=` (يساوي)، `!=` (لا يساوي)، `<= x >=` (بين)، أو `> or <` (خارج النطاق)
* **قيمة العتبة**: القيمة الرقمية المطلوب المقارنة بها
* **Interval**: عدد مرات تقييم التنبيه (1m أو 5m أو 15m أو 30m أو 1h أو 6h أو 12h أو 1d). ويحدِّد هذا أيضًا النافذة الزمنية لكل تقييم.
* **Webhook**: قناة الإشعارات التي تُستخدم عند إطلاق التنبيه. راجع [إضافة webhook](#add-webhook).
**النطاق الزمني للتنبيه**
عادةً ما تُنفَّذ استعلامات التنبيه مرة واحدة لكل فاصل زمني. ومع ذلك، إذا تم تخطي فاصل زمني واحد أو أكثر بسبب أخطاء أو بطء الاستعلامات، فسيستخدم التنفيذ التالي نطاقًا زمنيًا يشمل الفواصل الزمنية الفائتة. في هذه الحالة، ستظل معلمات الفاصل الزمني للاستعلام مضبوطة على الفترة المكوَّنة للتنبيه، لكن معلمات النطاق الزمني ستعكس النطاق الزمني الأطول.
#### احفظ لوحة المعلومات
احفظ لوحة المعلومات لتفعيل التنبيه. سيبدأ التنبيه بالتقييم وفقًا للفاصل الزمني المُعدّ.
### كيفية تفسير نتائج الاستعلام
يفحص نظام التنبيهات الأعمدة التي يعيدها استعلام SQL لتحديد ما يجب مقارنته بالعتبة.
* **عمود القيمة**: يُستخدم **آخر عمود رقمي** في عبارة `SELECT` باعتباره قيمة التنبيه. إذا أعاد استعلامك عدة أعمدة رقمية (مثلًا، `count, avg_latency, p99_latency`)، فلن تُقارَن بالعتبة إلا الأخيرة منها (`p99_latency`).
* **عمود الطابع الزمني**: بالنسبة إلى مخططات السلاسل الزمنية (Line وStacked Bar)، يحدِّد النظام عمود Date/DateTime في النتائج باعتباره الفترة الزمنية (أي المحور x في مخطط السلاسل الزمنية). وتُقيَّم قيمة كل فترة زمنية في عمود القيمة مقابل العتبة بشكل مستقل، وإذا تجاوزت قيمة أي فترة زمنية العتبة المُعدَّة، فسيتم إطلاق التنبيه.
* **أعمدة التجميع**: تُعامَل أي أعمدة غير رقمية وغير خاصة بالطابع الزمني (مثلًا، `ServiceName` و`Environment`) على أنها أبعاد تجميع. وعند وجود مجموعات، يُتتبَّع كل تركيب فريد من قيم المجموعات ويُرسَل له تنبيه بشكل منفصل. سيرسل ClickStack تنبيهًا لكل مجموعة تحتوي على قيمة تتجاوز العتبة المُعدَّة. لا تتوفر المجموعات إلا لمخططات السلاسل الزمنية.
### معلمات الاستعلام ووحدات الماكرو
تدعم استعلامات تنبيهات SQL معلمات القوالب ووحدات الماكرو التي تُستبدل تلقائيًا عند التقييم. وهذه هي نفس المعلمات ووحدات الماكرو المتاحة عند [إنشاء مخطط مستند إلى SQL](/ar/clickstack/features/dashboards/sql-visualizations).
#### المعلمات المطلوبة والموصى بها
الاستعلامات المستخدمة لتنبيهات المخططات الخطية أو مخططات الأعمدة المتراكمة **يجب** أن تتضمن معلمة الفاصل الزمني أو macro (`{intervalSeconds:Int64}` أو `{intervalMilliseconds:Int64}` أو `$__timeInterval(col)` أو `$__timeInterval_ms(col)`). أثناء تنفيذ التنبيه، سيُستبدل بها الفترة المُعدّة للتنبيه.
الاستعلامات المستخدمة للتنبيهات **ينبغي** أن تتضمن عامل تصفية للنطاق الزمني (`{startDateMilliseconds:Int64}` و`{endDateMilliseconds:Int64}`، أو `$__timeFilter(col)`، وما إلى ذلك). وبغض النظر عمّا إذا كان عامل تصفية للنطاق الزمني موجودًا في الاستعلام أم لا، فسيُشغَّل استعلام التنبيه وفقًا للفترة المُعدّة للتنبيه. وإذا لم يكن هناك عامل تصفية للنطاق الزمني، فسيقرأ الاستعلام كامل النطاق الزمني المتاح في الجدول المصدر عند كل تنفيذ.
**النطاق الزمني للتنبيه**
عادةً ما تُنفَّذ استعلامات التنبيه مرة واحدة لكل فاصل زمني. ومع ذلك، إذا تم تخطي فاصل زمني واحد أو أكثر بسبب أخطاء أو بطء الاستعلامات، فسيستخدم التنفيذ التالي نطاقًا زمنيًا يشمل الـ intervals الفائتة. في هذه الحالة، ستظل معلمات الفاصل الزمني في الاستعلام مضبوطة على الفترة المُعدّة للتنبيه، لكن معلمات النطاق الزمني ستعكس النطاق الزمني الأطول.
### أمثلة على استعلامات التنبيهات
#### معدل الأخطاء لكل خدمة (زمنيًا)
أرسل تنبيهًا إذا تجاوز معدل الأخطاء في أي خدمة 5%، بشرط وجود ما لا يقل عن 10 طلبات خلال فترة التنبيه لتفادي التنبيهات المزعجة للخدمات منخفضة الزيارات.
```sql theme={null}
WITH error_rates AS (
SELECT
$__timeInterval(Timestamp) as ts,
ServiceName,
countIf (SpanKind = 'Server') as request_count,
countIf (
SpanKind = 'Server'
and StatusCode = 'Error'
) as error_count,
error_count / request_count * 100 AS error_percent
FROM $__sourceTable
WHERE $__timeFilter(Timestamp)
GROUP BY ts, ServiceName
)
SELECT ts, ServiceName, error_percent
FROM error_rates
WHERE request_count > 10
```
**نوع العرض**: خطي أو شريط مكدّس
**العتبة**: `>= 5` (يُطلق التنبيه عند وصول معدل الأخطاء إلى 5%)
في هذا الاستعلام، يُعدّ `ServiceName` عمودًا غير رقمي وليس عمود طابع زمني، لذا تُتَابَع كل خدمة بوصفها مجموعة تنبيه منفصلة. ويُطلق التنبيه بشكل مستقل لكل خدمة.
#### كشف الشذوذ باستخدام المتوسط المتأخر (السلاسل الزمنية)
أنشئ تنبيهًا عند زيادة عدد الأخطاء بما يتجاوز متوسطًا متحركًا بأكثر من انحرافين معياريين. يلتقط هذا الارتفاعات المفاجئة مقارنةً بالسلوك المعتاد مؤخرًا بدلًا من الاعتماد على عتبة ثابتة.
```sql theme={null}
WITH buckets AS (
SELECT
$__timeInterval(Timestamp) AS ts,
count() AS bucket_count
FROM $__sourceTable
WHERE TimestampTime >= fromUnixTimestamp64Milli({startDateMilliseconds:Int64})
- toIntervalSecond($__interval_s * 30) -- Fetch 30 intervals back
AND TimestampTime < fromUnixTimestamp64Milli({endDateMilliseconds:Int64})
AND SeverityText = 'error'
GROUP BY ts
ORDER BY ts
WITH FILL
FROM toDateTime(fromUnixTimestamp64Milli({startDateMilliseconds:Int64}))
TO toDateTime(fromUnixTimestamp64Milli({endDateMilliseconds:Int64}))
STEP toIntervalSecond($__interval_s)
),
anomaly_detection AS (
SELECT
ts,
bucket_count,
avg(bucket_count) OVER (
ORDER BY ts ROWS BETWEEN 30 PRECEDING AND 1 PRECEDING
) AS previous_30_avg,
stddevPop(bucket_count) OVER (
ORDER BY ts ROWS BETWEEN 30 PRECEDING AND 1 PRECEDING
) AS previous_30_stddev,
greatest(
bucket_count - (previous_30_avg + 2 * previous_30_stddev), 0
) AS excess_error_count
FROM buckets
)
SELECT ts, excess_error_count
FROM anomaly_detection
WHERE ts >= fromUnixTimestamp64Milli({startDateMilliseconds:Int64})
AND ts < fromUnixTimestamp64Milli({endDateMilliseconds:Int64})
```
**نوع العرض**: خطّي
**العتبة**: `> 0` (يُفعَّل التنبيه عند رصد أخطاء تتجاوز خط الأساس المتحرك)
لاحظ أن الاستعلام يجلب 30 فترة *قبل* بداية نطاق التاريخ لتهيئة حسابات النافذة المتحركة، ثم يُصفّي الناتج النهائي ليقتصر على نافذة التقييم.
## سيناريوهات التنبيهات الشائعة
فيما يلي بعض سيناريوهات التنبيهات الشائعة التي يمكنك استخدام HyperDX فيها:
**الأخطاء:** نوصي بإعداد تنبيهات لعمليتَي البحث المحفوظتين الافتراضيتين
`All Error Events` و`HTTP Status >= 400` لتتلقى إشعارًا عند
ارتفاع عدد الأخطاء بشكل مفرط.
**العمليات البطيئة:** يمكنك إعداد بحث عن العمليات البطيئة (على سبيل المثال،
`duration:>5000`) ثم إنشاء تنبيه عند حدوث عدد كبير جدًا من العمليات البطيئة.
**أحداث المستخدمين:** يمكنك أيضًا إعداد تنبيهات للفرق التي تتعامل مباشرةً مع العملاء
لتتلقى إشعارًا عند تسجيل مستخدمين جدد أو عند تنفيذ إجراء حرج من إجراءات المستخدم.