采样查询分析器
ClickHouse 运行采样分析器,允许分析查询执行。使用分析器,您可以找到在查询执行期间最常使用的源代码例程。您可以追踪 CPU 时间和墙钟时间,包括空闲时间。
查询分析器在 ClickHouse Cloud 中自动启用,您可以按如下方式运行示例查询:
FROM system.trace_log
更改为 FROM clusterAllReplicas(default, system.trace_log)
以从集群的所有节点选择。在自管理部署中,要使用查询分析器:
-
设置服务器配置的 trace_log 部分。
该部分配置 trace_log 系统表,该表包含分析器功能的结果。默认情况下,它已配置。请记住,此表中的数据仅在服务器运行时有效。服务器重启后,ClickHouse 不会清理该表,所有存储的虚拟内存地址可能变得无效。
-
设置 query_profiler_cpu_time_period_ns 或 query_profiler_real_time_period_ns 设置。两个设置可以同时使用。
这些设置允许您配置分析器定时器。由于这些是会话设置,您可以为整个服务器、单个用户或用户配置、您的交互式会话以及每个单独查询获得不同的采样频率。
默认的采样频率为每秒一个样本,并且启用了 CPU 和真实定时器。此频率允许收集有关 ClickHouse 集群的足够信息。同时,在此频率下工作,分析器不会影响 ClickHouse 服务器的性能。如果您需要分析每个单独的查询,请尝试使用更高的采样频率。
要分析 trace_log
系统表:
-
安装
clickhouse-common-static-dbg
包。请参见 从 DEB 包安装。 -
通过 allow_introspection_functions 设置允许分析函数。
出于安全原因,分析函数默认情况下是禁用的。
-
使用
addressToLine
、addressToLineWithInlines
、addressToSymbol
和demangle
分析函数 获取 ClickHouse 代码中的函数名称和它们的位置。要获取某个查询的分析报告,您需要从trace_log
表中汇总数据。您可以按单个函数或整个堆栈跟踪汇总数据。
如果您需要可视化 trace_log
信息,请尝试 flamegraph 和 speedscope。
示例
在此示例中,我们:
-
按查询标识符和当前日期过滤
trace_log
数据。 -
按堆栈跟踪进行汇总。
-
使用分析函数,我们将获得如下报告:
- 符号名称及其相应的源代码函数。
- 这些函数的源代码位置。