Starrocks 关于 trace 命令的说明

关注

原创最新推荐文章于 2026-08-01 16:00:35 发布 412 阅读 AI 写同款· GEO 优化 ›

Linux环境变量与Shell变量本质区别及实战排错环境变量和Shell变量是Linux进程通信的基础机制，其核心差异在于作用域与导出状态的双重绑定：未export的Shell变量仅存在于当前Shell内存，而export后才写入内核分配的环境块，供子进程通过execve()继承。这种机制决定了PATH扩展、Python包加载、Docker容器变量传递、CI/CD脚本执行等关键场景的成败。掌握env（读环境块）、set（查Shell内存）、export -p（验导出状态）三命令的底层行为，能精准定位‘命令找不到’‘变量丢失’‘跨Shell失效’等高频问题。本阅读详情

背景

本文基于Starrocks 3.5.5

关于trace命令的话, 有如下使用方式：

TRACE { TIMES | VALUES | LOGS | ALL } [ <module> ] <query_statement>

module的选项有：BASE, MV, OPTIMIZER, SCHEDULE, EXTERNAL

这几个模块会在ConnectProcessor.handleQuery中Tracers.init(ctx, parsedStmt.getTraceMode(), parsedStmt.getTraceModule())
进行初始化，也就是说如果你选择了 OPTIMIZER模块，那就是Tracers 中初始化为OPTIMIZER,所有在SeriallyTaskScheduler类中的Tracers.Module.OPTIMIZER
想关的指标信息就会记录下来，如：

OptimizerTask task = tasks.pop();
context.getOptimizerContext().setTaskContext(context);
try (Timer ignore = Tracers.watchScope(Tracers.Module.OPTIMIZER, task.getClass().getSimpleName())) {
    task.execute();
}

这些在内存中需要保留的信息只是需要跟踪的信息，而不是包括所有的module，保证了FE端内存的使用率不至于太高，从而引发OOM

收录于