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

> تصوّر بيانات system.query_log لتسهيل استكشاف أخطاء الاستعلامات وتحسين الأداء

# Query insights

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

تجعل ميزة **Query Insights** سجل الاستعلامات المضمّن في ClickHouse أسهل استخدامًا من خلال المرئيات والجداول. ويُعد جدول `system.query_log` في ClickHouse مصدرًا أساسيًا للمعلومات اللازمة لتحسين الاستعلامات، واستكشاف الأخطاء وإصلاحها، ومراقبة الحالة العامة للعنقود وأدائه.

<div id="query-overview">
  ## نظرة عامة على الاستعلامات
</div>

بعد تحديد خدمة، من المفترض أن يتوسّع عنصر التنقّل **Monitoring** في الشريط الجانبي الأيسر ليعرض عنصرًا فرعيًا جديدًا باسم **Query insights**. ويؤدي النقر على هذا الخيار إلى فتح صفحة Query insights الجديدة:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/YtLHbpLqKXQpx3d8/images/cloud/sqlconsole/insights_overview.png?fit=max&auto=format&n=YtLHbpLqKXQpx3d8&q=85&s=0d652d49bcb888193cd0ac6f2f2e32e1" size="md" alt="نظرة عامة على واجهة مستخدم Query Insights" border width="1712" height="790" data-path="images/cloud/sqlconsole/insights_overview.png" />

<div id="top-level-metrics">
  ## المقاييس عالية المستوى
</div>

تعرض مربعات الإحصاءات في الأعلى بعض المقاييس الأساسية عالية المستوى للاستعلامات خلال الفترة الزمنية المحددة. وتحتها، تظهر ثلاثة مخططات زمنية تمثل حجم الاستعلامات وزمن الاستجابة ومعدل الأخطاء، مقسّمة حسب نوع الاستعلام (select وinsert وغيرها) ضمن النافذة الزمنية المحددة. ويمكن أيضًا ضبط مخطط زمن الاستجابة لعرض قيم p50 وp90 وp99:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/YtLHbpLqKXQpx3d8/images/cloud/sqlconsole/insights_latency.png?fit=max&auto=format&n=YtLHbpLqKXQpx3d8&q=85&s=364b9601588d3ba628b68c26b964beeb" size="md" alt="مخطط زمن الاستجابة في واجهة Query Insights" border width="1456" height="384" data-path="images/cloud/sqlconsole/insights_latency.png" />

<div id="recent-queries">
  ## الاستعلامات الأخيرة
</div>

أسفل المقاييس عالية المستوى، يعرض جدول إدخالات سجل الاستعلامات (مجمّعة حسب قيمة تجزئة الاستعلام المُطبَّع والمستخدم) ضمن النافذة الزمنية المحددة:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/YtLHbpLqKXQpx3d8/images/cloud/sqlconsole/insights_recent.png?fit=max&auto=format&n=YtLHbpLqKXQpx3d8&q=85&s=a029b38784d333cb62c2a9fbe1cfb474" size="md" alt="واجهة Query Insights لجدول Recent queries" border width="1625" height="736" data-path="images/cloud/sqlconsole/insights_recent.png" />

يمكن تصفية الاستعلامات الأخيرة وفرزها حسب أي حقل متاح. ويمكن أيضًا تهيئة الجدول لإظهار حقول إضافية أو إخفائها، مثل الجداول وزمن الاستجابة p90 وp99.

<div id="query-drill-down">
  ## التعمّق في الاستعلام
</div>

سيؤدي اختيار استعلام من جدول استعلامات أخيرة إلى فتح لوحة جانبية تحتوي على مقاييس ومعلومات خاصة بالاستعلام المحدد:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/YtLHbpLqKXQpx3d8/images/cloud/sqlconsole/insights_drilldown.png?fit=max&auto=format&n=YtLHbpLqKXQpx3d8&q=85&s=3371e463e4ec089807a443432cdada1f" size="md" alt="واجهة Query Insights للتعمّق في الاستعلام" border width="1889" height="963" data-path="images/cloud/sqlconsole/insights_drilldown.png" />

كما نرى من اللوحة الجانبية، جرى تشغيل هذا الاستعلام أكثر من 3000 مرة خلال آخر 24 ساعة. جميع المقاييس في علامة التبويب **Query info** هي مقاييس مُجمّعة، ولكن يمكننا أيضًا عرض مقاييس عمليات التشغيل الفردية باختيار علامة التبويب **Query history**:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/YtLHbpLqKXQpx3d8/images/cloud/sqlconsole/insights_query_info.png?fit=max&auto=format&n=YtLHbpLqKXQpx3d8&q=85&s=4629def1dbb76a6646c02097e3ee5be4" size="sm" alt="واجهة Query Insights لمعلومات الاستعلام" border width="591" height="961" data-path="images/cloud/sqlconsole/insights_query_info.png" />

<br />

من هذه اللوحة، يمكن توسيع العنصرين `Settings` و`Profile Events` لكل عملية تشغيل استعلام لإظهار معلومات إضافية.