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

> 包含插桩点的系统表

# system.instrumentation

<Info>
  **在 ClickHouse Cloud 中查询**

  此系统表中的数据分别保存在 ClickHouse Cloud 各节点的本地。因此，如需查看所有数据的完整情况，需要使用 `clusterAllReplicas` 函数。更多详情请参见[此处](/zh/reference/system-tables/overview#system-tables-in-clickhouse-cloud)。
</Info>

<div id="description">
  ## 描述
</div>

包含通过 LLVM 的 XRay 功能插入的插桩点。

<div id="columns">
  ## 列
</div>

* `id` ([UInt32](/zh/reference/data-types/int-uint)) — 插桩点的 ID
* `function_id` ([Int32](/zh/reference/data-types/int-uint)) — 在 elf-binary 的 xray\_instr\_map 节中分配给该函数的 ID。
* `function_name` ([LowCardinality(String)](/zh/reference/data-types/lowcardinality)) — 用于为该函数插桩的名称。
* `handler` ([LowCardinality(String)](/zh/reference/data-types/lowcardinality)) — 被打补丁到该函数插桩点中的处理程序。
* `entry_type` ([Enum8('Entry' = 0, 'Exit' = 1, 'EntryAndExit' = 2)](/zh/reference/data-types/enum)) — 该补丁的入口类型。
* `symbol` ([LowCardinality(String)](/zh/reference/data-types/lowcardinality)) — 完整且经过去修饰的符号名称。
* `parameters` ([Array(Dynamic)](/zh/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)
parameters:    ['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)
parameters:    []

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)
parameters:    [0.3]

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

<div id="see-also">
  ## 另请参阅
</div>

* [SYSTEM INSTRUMENT](/zh/reference/statements/system#instrument) — 添加或移除插桩点。
* [system.trace\_log](/zh/reference/system-tables/trace_log) — 查看性能分析日志。
* [system.symbols](/zh/reference/system-tables/symbols) — 查看符号以添加插桩点。