使用 OpenTelemetry 跟踪 ClickHouse
OpenTelemetry 是一个用于从分布式应用程序收集跟踪和度量的开放标准。 ClickHouse 对 OpenTelemetry 有一定的支持。
向 ClickHouse 提供跟踪上下文
ClickHouse 接受跟踪上下文 HTTP 头，具体说明见 W3C 推荐。它还接受通过用于 ClickHouse 服务器之间或客户端与服务器之间通信的原生协议传递的跟踪上下文。对于手动测试，可以使用 --opentelemetry-traceparent 和 --opentelemetry-tracestate 标志向 clickhouse-client 提供符合跟踪上下文推荐的头信息。
如果未提供父跟踪上下文或提供的跟踪上下文不符合上述 W3C 标准，ClickHouse 可以以受 opentelemetry_start_trace_probability 设置控制的概率开始一个新的跟踪。
传播跟踪上下文
在以下情况下，跟踪上下文会传播到下游服务：
-
对远程 ClickHouse 服务器的查询，例如使用 Distributed 表引擎时。
-
url 表函数。跟踪上下文信息通过 HTTP 头发送。
跟踪 ClickHouse 本身
ClickHouse 为每个查询及某些查询执行阶段（例如查询计划或分布式查询）创建 trace spans。
为了有用，跟踪信息必须导出到支持 OpenTelemetry 的监控系统，例如 Jaeger 或 Prometheus。ClickHouse 避免对特定监控系统的依赖，而是仅通过系统表提供跟踪数据。根据 标准 要求的 OpenTelemetry 跟踪跨度信息存储在 system.opentelemetry_span_log 表中。
该表必须在服务器配置中启用，见默认配置文件 config.xml 中的 opentelemetry_span_log 元素。默认情况下启用。
标签或属性作为两个并行数组保存，包含键和值。使用 ARRAY JOIN 来处理它们。
日志查询设置
设置 log_query_settings 允许在查询执行期间记录查询设置的更改。当启用时，对查询设置所做的任何修改都将在 OpenTelemetry 段日志中记录。此功能在生产环境中特别有用，用于跟踪可能影响查询性能的配置更改。
与监控系统的集成
目前没有现成的工具可以将 ClickHouse 的跟踪数据导出到监控系统。
为了测试，可以使用使用 URL 引擎的物化视图设置导出，以便通过 system.opentelemetry_span_log 表将到达的日志数据推送到跟踪收集器的 HTTP 端点。例如，要将最小跨度数据推送到运行在 http://localhost:9411 的 Zipkin 实例，以 Zipkin v2 JSON 格式：
如果发生任何错误，发生错误的日志数据部分将被默默丢失。如果数据未到达，请检查服务器日志中的错误消息。