跳到主要内容
返回时间线
mastra.ai来源发表:

Mastra把生产指标开放成查询接口:成本、延迟、错误率可按模型和会话自己拼

核心概要

Mastra平台上线Metrics API,让开发者用客户端SDK、命令行或可观测性端点查询生产项目的token用量、模型成本、延迟和错误率。此前这些指标只能在平台和Studio里查看,无法自行构造查询。现在可以按时间范围、状态过滤和分组维度组合出总量、明细、时间序列与百分位数据,用于自定义报表、仪表盘、下游数据投递和成本或错误率上升时的告警。

Source-provided article image: Introducing the Metrics API for Mastra Platform
mastra.ai

深度剖析

生产环境里的模型成本、延迟和错误率现在可以按自己的问题去查,而不是只看平台预置的几张图。 此前这些指标只能在Mastra平台和Studio中查看,用户无法自行构造查询。 查询结果覆盖总量、按维度拆分、时间序列和百分位四类形态,并可与时间范围和状态过滤组合。

查询走的是聚合口径:单次运行的轨迹记录一次执行里发生了什么,指标则把每一次运行汇总起来。 因此可以定位哪个模型、哪段对话或哪次工具调用最贵、最慢或失败最多。 示例查询包括按token类型看成本、按threadId给会话成本排序、按模型或按agent与workflow分组、按天取用量、取p50与p95运行时长,以及按状态标签统计失败运行。

接入方式是带平台访问令牌和项目ID的请求,按项目所在区域选择可观测性基础地址。 美国区域使用observability.mastra.ai,欧洲区域使用observability.eu.mastra.ai。 客户端SDK、命令行和可观测性端点三种入口执行同一类查询,返回均为JSON;时间戳过滤可选,省略起止时间则返回全部可用数据。

启示与展望

这则报道面向使用Mastra平台的生产项目开发者与运维人员,覆盖的查询对象是token用量、模型成本、延迟和错误率,入口为客户端SDK、命令行和可观测性端点,返回JSON。材料未说明该接口是否适用于自托管或非Mastra部署。

材料说明时间戳过滤是可选的,省略起止时间会返回全部可用数据,因此查询范围由调用方自行约束。材料未给出指标数据的保留期限或采样方式。