> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# البحث في ClickStack

> البحث في ClickStack

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

يتيح لك ClickStack إجراء بحث نصي كامل ضمن أحداثك (السجلات والتتبعات). يمكنك البدء في البحث بمجرد كتابة كلمات مفتاحية تطابق أحداثك. على سبيل المثال، إذا كان السجل يحتوي على "Error"، فيمكنك العثور عليه بمجرد كتابة "Error" في شريط البحث.

تُستخدم صيغة البحث نفسها أيضًا
لتصفية الأحداث في لوحات المعلومات والمخططات.

<div id="search-features">
  ## ميزات Search
</div>

<div id="natural-language-syntax">
  ### صيغة البحث باللغة الطبيعية
</div>

* لا تراعي عمليات البحث حالة الأحرف
* تطابق عمليات البحث الكلمات الكاملة افتراضيًا (مثلًا، سيطابق `Error` ‎`Error here`
  لكن ليس ‎`Errors here`). يمكنك إحاطة الكلمة بمحارف البدل لمطابقة أجزاء من
  الكلمات (مثلًا، سيطابق `*Error*` كلًا من `AnyError` و`AnyErrors`)
* يُبحث في مصطلحات البحث بأي ترتيب (مثلًا، سيطابق `Hello World` السجلات التي
  تحتوي على `Hello World` و`World Hello`)
* يمكنك استبعاد الكلمات المفتاحية باستخدام `NOT` أو `-` (مثلًا، `Error NOT Exception` أو
  `Error -Exception`)
* يمكنك استخدام `AND` و`OR` لدمج عدة كلمات مفتاحية (مثلًا،
  `Error OR Exception`)
* يمكن إجراء المطابقات التامة باستخدام علامات الاقتباس المزدوجة (مثلًا، `"Error tests not found"`)

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/RhEK5rhPj_7m6pWY/images/use-cases/observability/hyperdx-27.png?fit=max&auto=format&n=RhEK5rhPj_7m6pWY&q=85&s=3d907e04cdfe58779fff47a9bb84e210" alt="Search" size="md" width="3430" height="2340" data-path="images/use-cases/observability/hyperdx-27.png" />

<div id="column-search">
  #### البحث في الأعمدة/الخصائص
</div>

* يمكنك البحث في الأعمدة وخصائص JSON/map باستخدام `column:value` (على سبيل المثال: `level:Error`,
  `service:app`)
* يمكنك البحث عن نطاق من القيم باستخدام معاملات المقارنة (`>`, `<`,
  `>=`, `<=`) (على سبيل المثال: `Duration:>1000`)
* يمكنك البحث عن وجود خاصية باستخدام `property:*` (على سبيل المثال:
  `duration:*`)

<div id="time-input">
  ### إدخال الوقت
</div>

* يقبل إدخال الوقت مُدخلات باللغة الطبيعية (مثل `1 hour ago`, `yesterday`,
  `last week`)
* سيؤدي تحديد نقطة زمنية واحدة إلى البحث بدءًا من تلك النقطة الزمنية
  وحتى الآن.
* سيُحوَّل النطاق الزمني دائمًا عند البحث إلى النطاق الزمني المُحلَّل، لتسهيل
  استكشاف الأخطاء وإصلاحها في الاستعلامات الزمنية.
* يمكنك أيضًا تمييز شريط في المدرج التكراري للتكبير إلى نطاق زمني محدد.

<div id="sql-syntax">
  ### صياغة بحث SQL
</div>

يمكنك، اختياريًا، تبديل حقول إدخال البحث إلى وضع SQL. سيؤدي ذلك إلى قبول أي
عبارة `WHERE` صالحة في SQL للبحث. وهذا مفيد للاستعلامات المعقدة التي لا يمكن
التعبير عنها باستخدام صياغة Lucene.

<div id="select-statement">
  ### عبارة SELECT
</div>

لتحديد الأعمدة التي ستُعرض في نتائج البحث، يمكنك استخدام حقل الإدخال `SELECT`.
وهو تعبير SQL من نوع SELECT لتحديد الأعمدة التي ستظهر في صفحة البحث.
الأسماء المستعارة غير مدعومة حاليًا (على سبيل المثال، لا يمكنك استخدام `column as "alias"`).

<div id="saved-searches">
  ## عملية البحث المحفوظة
</div>

يمكنك حفظ عمليات البحث للوصول إليها بسرعة لاحقًا. وبمجرد حفظها، ستظهر في صفحة `عملية البحث المحفوظة`، مما يسهّل عليك الرجوع إلى استعلامات البحث المستخدمة كثيرًا من دون الحاجة إلى إعادة إنشائها.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/brNmKxVjpyGdH7Ao/images/use-cases/observability/clickstack-saved-search-listing.png?fit=max&auto=format&n=brNmKxVjpyGdH7Ao&q=85&s=26f76de22a8aece4310abb9bff9c70e8" alt="صفحة قائمة عمليات البحث المحفوظة" size="lg" width="1468" height="614" data-path="images/use-cases/observability/clickstack-saved-search-listing.png" />

لحفظ عملية بحث، ما عليك سوى تهيئة استعلام البحث ثم النقر على زر الحفظ. ويمكنك منح عملية البحث المحفوظة اسمًا وصفيًا ليسهل التعرّف عليها لاحقًا.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/brNmKxVjpyGdH7Ao/images/use-cases/observability/clickstack-saved-search.png?fit=max&auto=format&n=brNmKxVjpyGdH7Ao&q=85&s=7b95059b76dbf9ce403a76d5bee8c33d" alt="حفظ عملية بحث" size="md" width="912" height="711" data-path="images/use-cases/observability/clickstack-saved-search.png" />

<div id="alerts-on-saved-searches">
  ### إضافة تنبيهات إلى عمليات البحث المحفوظة
</div>

يمكن مراقبة عمليات البحث المحفوظة باستخدام التنبيهات لإخطارك عند استيفاء شروط معيّنة. يمكنك إعداد التنبيهات بحيث يتم تشغيلها عندما يتجاوز عدد الأحداث المطابقة لعملية البحث المحفوظة لديك حدًا معيّنًا أو ينخفض عنه.

لمزيد من المعلومات حول إعداد التنبيهات وتهيئتها، راجع [وثائق التنبيهات](/ar/clickstack/features/alerts).

<div id="tagging">
  ### إضافة الوسوم
</div>

يمكنك إضافة وسوم إلى لوحات المعلومات وعمليات البحث المحفوظة للمساعدة في تنظيمها.
وتوفّر الوسوم طريقة مرنة للتصنيف والتصفية بما يناسب احتياجاتك.

<div id="how-tags-work">
  #### كيف تعمل الوسوم
</div>

* **التنظيم**: تظهر الوسوم في الشريط الجانبي الأيسر، حيث تُجمَّع لوحات المعلومات وعمليات البحث المحفوظة وفقًا للوسوم المخصَّصة لها
* **وسوم متعددة**: يمكنك إضافة وسم واحد أو أكثر إلى العنصر نفسه لتحسين التصنيف
* **الإنشاء التلقائي**: إذا أضفت وسمًا غير موجود بعد، فسيُنشأ تلقائيًا
* **سهولة الإدارة**: يمكنك إضافة الوسوم أو إزالتها في أي وقت لتعديل بنية التنظيم لديك

يسهّل ذلك العثور على العناصر ذات الصلة والحفاظ على مساحة عمل منظَّمة مع ازدياد مجموعتك.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/brNmKxVjpyGdH7Ao/images/use-cases/observability/clickstack-tags-search.png?fit=max&auto=format&n=brNmKxVjpyGdH7Ao&q=85&s=de4939b1a5e424b97ce950fe39a6587f" alt="الوسوم في البحث المحفوظ" size="md" border width="743" height="230" data-path="images/use-cases/observability/clickstack-tags-search.png" />

يمكنك أيضًا تحديد عدة وسوم لتصفية العناصر وعرضها عبر فئات مختلفة:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/brNmKxVjpyGdH7Ao/images/use-cases/observability/clickstack-tags-dashboard.png?fit=max&auto=format&n=brNmKxVjpyGdH7Ao&q=85&s=e028f0222150880f753ba65d4bdfc326" alt="تحديد عدة وسوم في لوحة المعلومات" size="md" border width="529" height="252" data-path="images/use-cases/observability/clickstack-tags-dashboard.png" />