SuperAPI AI 工具集

retrieving-mlflow-traces

编程与开发

查看项目

更新于 10-16 03:15

技能介绍

用途:该技能面向需要查询 MLflow 追踪(traces)的场景,提供命令行与 Python API 两种方式。当用户提出按 ID 获取追踪、查找追踪、或按状态、标签、元数据、执行时间过滤追踪时使用。

主要能力:一是单条获取,适用场景为已持有具体追踪 ID(例如来自 UI、日志或 API 响应),命令为 mlflow traces get --trace-id <id>;二是搜索,适用场景为按条件查找,命令为 mlflow traces search --experiment-id <id> --filter-string "..."。搜索支持按运行 ID(--run-id)、会话或用户(metadata.mlflow.trace.session、metadata.mlflow.trace.user)、状态(trace.status = 'ERROR' 或 'OK')、时间范围(trace.timestamp_ms,毫秒时间戳)、执行时间(trace.execution_time_ms > 1000)、标签与元数据(tag.<key>、metadata.<key>)、评估反馈(feedback.<name>)以及全文检索(trace.text LIKE '%error%')。还支持分页(--max-results、--page-token)、排序(--order-by)、输出格式(--output json)、包含跨度(--include-spans)。

使用方式与工作流:先运行 mlflow traces search --help 检查当前安装版本支持的参数,再按过滤语法构造查询,执行搜索,必要时再获取单条追踪详情。过滤语法支持 LIKE、ILIKE(不区分大小写)、RLIKE(正则)等模式操作符;键名含特殊字符时用反引号转义。

数据结构:TraceInfo 包含 trace_id、status(OK/ERROR)、timestamp_ms、execution_time_ms、tags、metadata、assessments;Spans 为带 name、type、attributes、start_time、end_time 的操作树。

限制:资料未提供 Python API mlflow.search_traces() 的具体用法,仅给出官方文档链接;其他环境差异、认证与权限等细节暂未提供。