用途:把 Mastra 智能体与工作流的执行追踪导出到 Maple,让每个对话成为一个 Maple Agent Session,每次 agent.generate()、agent.stream() 或工作流 run.start() 作为一轮(一个 trace),展示对话记录、模型调用、工具调用、失败工具与子智能体。
主要能力:通过 @mastra/otel-exporter 的 OtelExporter 使用自定义 provider,需在代码中显式传入 endpoint、protocol(必须为 http/protobuf)与 Authorization 头;支持 US 与 EU 两个区域端点。会话键为 gen_ai.conversation.id,由 span 元数据的 threadId 写入,threadId 需在每次对话调用中保持稳定。聊天 span 带模型、provider、输入输出 token;execute_tool span 记录工具参数与结果。
必要用法:需 @mastra/core 1.x(1.71 及以上)与 Node >= 22.13;安装 @mastra/observability@latest 与 @mastra/otel-exporter@latest。必须添加 mapleSpanProcessor,用于统一根 threadId、补全 chat span 的输入消息、移除 step span 中原始 provider 响应头与 body。建议保留 excludeSpanTypes: [SpanType.MODEL_CHUNK],并避免开启 includeInternalSpans。脚本、CLI、一次性任务退出前需 await mastra.shutdown();无服务器按请求需 await mastra.observability.flush()。
限制:Mastra 0.x 不适用;@mastra/core、@mastra/observability、@mastra/otel-exporter 版本需匹配;OtelExporter 不读取 OTEL 环境变量;无 key 可先用 MAPLE_TEST 占位,私有 key 不得放入浏览器代码;敏感信息按键名过滤,不覆盖自由文本。具体收费与更多平台细节暂未提供。