Mastra平台上线trace导入：换可观测性供应商，历史调用链不再留在原地
核心概要
Mastra平台新增trace导入功能，可把第三方可观测性供应商中已有的调用链记录搬进Mastra，与Mastra自身生成的trace并列显示，便于调试、筛选和对比。此前Mastra的可观测性数据只能导出到第三方供应商，切换供应商往往意味着把历史数据留在原处。首批支持Langfuse，导入保留span类型（如agent_run、model_generation、tool_call）、父子结构、时间戳、输入输出、用量与成本，但只导入trace观测，评分、反馈、数据集、附件和日志不在导入范围内。
深度剖析
Mastra平台现在可以把第三方可观测性供应商里已有的调用链记录导入进来，导入后的trace与Mastra自身生成的trace并列显示在Mastra平台和已部署的Studio中，调试、筛选和跨历史对比可以在同一处完成。 在此之前，Mastra的可观测性数据只能导出到第三方供应商，方向是单向的；切换供应商通常意味着把已有的trace历史留在原供应商那里。 导入保留的细节包括span类型（如agent_run、model_generation和tool_call）、父子结构、时间戳、输入、输出、用量和成本；首批支持的供应商是Langfuse，官方表示后续会加入更多供应商。
导入通过Mastra CLI执行，先升级CLI和@mastra/core依赖，再为Langfuse项目创建API密钥并写入环境变量，然后指定目标项目名运行导入命令。 命令默认先做预览，用--dry-run只显示与正式导入相同的汇总信息而不上传，去掉该标志后才真正导入，CLI会显示汇总、请求确认、上传并校验。 导入面向已部署到Mastra平台的项目，其访问令牌和项目ID需已写入.env；LANGFUSE_BASE_URL默认指向欧盟区域，可改为其他区域或自托管地址，并可用--since和--until按ISO 8601时间范围导入，用--resume配合导入ID续传被中断或预览过的导入。
启示与展望
该功能面向已部署到Mastra平台的项目，导入的trace会出现在Mastra平台和已部署的Studio中，与Mastra自身生成的trace并列。首批支持Langfuse，官方表示后续会加入更多供应商。导入只覆盖trace观测，评分、反馈、数据集、附件和日志不在导入范围内。
导入保留span类型、父子结构、时间戳、输入、输出、用量和成本，但评分、反馈、数据集、附件和日志被明确排除，因此依赖这些字段的历史信息不会随trace一起迁移。LANGFUSE_BASE_URL默认指向欧盟区域，其他区域或自托管部署需要手动设置。