用途:dag-execution-tracer 用于在 DAG 工作流中记录并分析完整执行路径,捕获所有节点的时间、输入、输出、状态转换与上下文,以支持调试、分析与学习。
主要能力:追踪记录(节点执行事件、状态转换、输入输出、上下文传播);追踪可视化(执行时间线、依赖关系、并行执行、关键路径);上下文捕获(决策点、环境上下文、工具调用、资源消耗);追踪分析(识别瓶颈、检测异常、支持调试与回放)。
核心模型:ExecutionTrace 含 traceId、dagId、起止时间、状态、rootSpan、spans、events、context、metadata;TraceSpan 记录 nodeId、operationName、startTime、endTime、duration、status、attributes、events、links;EventType 包括 node_started、node_completed、node_failed、state_transition、tool_called、context_received、output_produced、retry_initiated、child_spawned。
使用方式:通过 ExecutionTracer 类调用 startTrace、startSpan、endSpan、recordEvent、completeTrace 等方法埋点记录;可导出为 json、otlp、jaeger、yaml 格式,支持 sanitize 脱敏(api_key、password、secret、token、credential 等敏感字段替换为 [REDACTED]);输出追踪时间线与依赖图,并可生成 Trace Report。
集成点:向 dag-performance-profiler 与 dag-failure-analyzer 输出追踪,接收 dag-task-scheduler 状态变更事件,向 dag-pattern-learner 存储模式,可视化结果可输出到监控看板。
适用场景:DAG 工作流调试、性能瓶颈定位、异常与失败分析、执行回放、并行与关键路径分析。
限制:具体安装方式、配置项、平台支持范围与详细使用步骤暂未提供;上下文环境类型涉及 claude-code-cli、sdk、http-api,其余环境细节暂未提供。