跳到主要内容
跳到主要内容
编辑此页

trace_log

在 ClickHouse Cloud 中查询

此系统表中的数据本地存储在 ClickHouse Cloud 的每个节点上。 因此，要获得所有数据的完整视图，需要使用 clusterAllReplicas 函数。 有关更多详细信息，请参阅此处。

包含由 采样查询分析器 收集的堆栈跟踪信息。

当设置了 trace_log 服务器配置部分时，ClickHouse 会创建此表。 另请参阅以下设置：query_profiler_real_time_period_ns、query_profiler_cpu_time_period_ns、memory_profiler_step、memory_profiler_sample_probability、trace_profile_events。

要分析日志，请使用 addressToLine、addressToLineWithInlines、addressToSymbol 和 demangle 内省函数。

列

  • hostname (LowCardinality(String)) — 执行查询的服务器的主机名。

  • event_date (Date) — 采样时刻的日期。

  • event_time (DateTime) — 采样时刻的时间戳。

  • event_time_microseconds (DateTime64) — 采样时刻的时间戳，精度为微秒。

  • timestamp_ns (UInt64) — 采样时刻的时间戳，单位为纳秒。

  • revision (UInt32) — ClickHouse 服务器构建版本号。

    当通过 clickhouse-client 连接到服务器时，您会看到类似于 Connected to ClickHouse server version 19.18.1. 的字符串。 此字段包含服务器的 revision，而不是 version。

  • trace_type (Enum8) — 追踪类型

    • Real 表示按挂钟时间收集堆栈跟踪。
    • CPU 表示按 CPU 时间收集堆栈跟踪。
    • Memory 表示当内存分配超过后续水印时收集分配和释放。
    • MemorySample 表示收集随机分配和释放。
    • MemoryPeak 表示收集峰值内存使用量的更新。
    • ProfileEvent 表示收集 Profile 事件的增量。

  • thread_id (UInt64) — 线程标识符。

  • query_id (String) — 查询标识符，可用于从 query_log 系统表中获取有关正在运行的查询的详细信息。

  • trace (Array(UInt64)) — 采样时刻的堆栈跟踪。 每个元素都是 ClickHouse 服务器进程内的虚拟内存地址。

  • size (Int64) - 对于追踪类型 Memory、MemorySample 或 MemoryPeak，它是已分配的内存量；对于其他追踪类型，则为 0。

  • event (LowCardinality(String)) - 对于追踪类型 ProfileEvent，它是更新的 Profile 事件的名称；对于其他追踪类型，则为空字符串。

  • increment (UInt64) - 对于追踪类型 ProfileEvent，它是 Profile 事件的增量；对于其他追踪类型，则为 0。

  • symbols, (Array(LowCardinality(String))), 如果启用了符号化，则包含与 trace 对应的已反解的符号名称。

  • lines, (Array(LowCardinality(String))), 如果启用了符号化，则包含带有行号的文件名字符串，与 trace 对应。

可以在服务器配置文件中 trace_log 下的 symbolize 中启用或禁用符号化。

示例

SELECT * FROM system.trace_log LIMIT 1 \G
Row 1:
──────
hostname:                clickhouse.eu-central1.internal
event_date:              2020-09-10
event_time:              2020-09-10 11:23:09
event_time_microseconds: 2020-09-10 11:23:09.872924
timestamp_ns:            1599762189872924510
revision:                54440
trace_type:              Memory
thread_id:               564963
query_id:
trace:                   [371912858,371912789,371798468,371799717,371801313,371790250,624462773,566365041,566440261,566445834,566460071,566459914,566459842,566459580,566459469,566459389,566459341,566455774,371993941,371988245,372158848,372187428,372187309,372187093,372185478,140222123165193,140222122205443]
size:                    5244400