> ## 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.instrumentation

<Info>
  **الاستعلام في ClickHouse Cloud**

  تُخزَّن بيانات جدول النظام هذا محليًا على كل عقدة في ClickHouse Cloud. لذلك، يتطلب الحصول على رؤية كاملة لجميع البيانات استخدام الدالة `clusterAllReplicas`. راجع [هنا](/ar/reference/system-tables/overview#system-tables-in-clickhouse-cloud) لمزيد من التفاصيل.
</Info>

<div id="description">
  ## الوصف
</div>

يتضمن نقاط التتبّع باستخدام ميزة XRay في LLVM.

<div id="columns">
  ## الأعمدة
</div>

* `id` ([UInt32](/ar/reference/data-types/int-uint)) — معرّف نقطة التتبّع البرمجي
* `function_id` ([Int32](/ar/reference/data-types/int-uint)) — المعرّف المُخصَّص للدالة في قسم xray\_instr\_map من الملف التنفيذي ELF.
* `function_name` ([LowCardinality(String)](/ar/reference/data-types/lowcardinality)) — الاسم المستخدم لقياس الدالة.
* `handler` ([LowCardinality(String)](/ar/reference/data-types/lowcardinality)) — المعالج الذي جرى ترقيعه في نقاط التتبّع البرمجي الخاصة بالدالة.
* `entry_type` ([Enum8('Entry' = 0, 'Exit' = 1, 'EntryAndExit' = 2)](/ar/reference/data-types/enum)) — نوع الإدخال الخاص بالترقيعة.
* `symbol` ([LowCardinality(String)](/ar/reference/data-types/lowcardinality)) — اسم الرمز الكامل بعد إزالة تشويه الاسم.
* `arguments` ([Array(Dynamic)](/ar/reference/data-types/array)) — الوسيطات الخاصة باستدعاء المعالج.

<div id="example">
  ## مثال
</div>

```sql theme={null}
SELECT * FROM system.instrumentation FORMAT Vertical;
```

```text theme={null}
Row 1:
──────
id:            0
function_id:   231280
function_name: QueryMetricLog::startQuery
handler:       log
entry_type:    Entry
symbol:        DB::QueryMetricLog::startQuery(std::__1::basic_string<char, std::__1::char_traits<char>, std::__1::allocator<char>> const&, std::__1::chrono::time_point<std::__1::chrono::system_clock, std::__1::chrono::duration<long long, std::__1::ratio<1l, 1000000l>>>, unsigned long)
arguments:     ['test']

Row 2:
──────
id:            1
function_id:   231280
function_name: QueryMetricLog::startQuery
handler:       profile
entry_type:    EntryAndExit
symbol:        DB::QueryMetricLog::startQuery(std::__1::basic_string<char, std::__1::char_traits<char>, std::__1::allocator<char>> const&, std::__1::chrono::time_point<std::__1::chrono::system_clock, std::__1::chrono::duration<long long, std::__1::ratio<1l, 1000000l>>>, unsigned long)
arguments:     []

Row 3:
──────
id:            2
function_id:   231280
function_name: QueryMetricLog::startQuery
handler:       sleep
entry_type:    Exit
symbol:        DB::QueryMetricLog::startQuery(std::__1::basic_string<char, std::__1::char_traits<char>, std::__1::allocator<char>> const&, std::__1::chrono::time_point<std::__1::chrono::system_clock, std::__1::chrono::duration<long long, std::__1::ratio<1l, 1000000l>>>, unsigned long)
arguments:     [0.3]

3 rows in set. Elapsed: 0.302 sec.
```

<div id="see-also">
  ## انظر أيضًا
</div>

* [SYSTEM INSTRUMENT](/ar/reference/statements/system#instrument) — أضِف نقاط التتبّع البرمجي أو أزلها.
* [system.trace\_log](/ar/reference/system-tables/trace_log) — اطّلع على سجل تحليل الأداء.
* [system.symbols](/ar/reference/system-tables/symbols) — اطّلع على الرموز لإضافة نقاط التتبّع البرمجي.
