analyzing-mlflow-trace

Analyze MLflow trace JSON to diagnose failures and locate root causes.

Updated May 20, 2026
One-click install
npx skills add https://github.com/ice-droid-99/BI-Dashboard-Generation-Agent-in-Databricks- --skill analyzing-mlflow-trace-ice-droid-99
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: analyzing-mlflow-trace
Source: https://github.com/ice-droid-99/BI-Dashboard-Generation-Agent-in-Databricks-/tree/main/.gemini/skills/analyze-mlflow-trace
Command: npx skills add https://github.com/ice-droid-99/BI-Dashboard-Generation-Agent-in-Databricks- --skill analyzing-mlflow-trace-ice-droid-99

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Analyzes a single MLflow trace to help you debug failures, investigate unexpected behavior, and understand execution quality.

Core Features & Use Cases

  • Trace-first investigation: Guides analysis of trace state, span trees, inputs, outputs, timing, and status codes.
  • Assessment-aware interpretation: Helps interpret MLflow assessments (including confusing “OK” states) by emphasizing rationales and distinguishing scorer errors from trace errors.
  • Root-cause targeting: Helps correlate span names and parent/child structure to application functions so issues can be narrowed to the correct tool, retrieval step, or model call.
  • Practical debugging flow: Provides health-check queries and recommended CLI handling for large trace payloads to avoid empty/partial output issues.

Quick Start

Use the analyzing-mlflow-trace skill to analyze trace ID 123 by running mlflow traces get --trace-id 123 and then asking what caused the failure and where in the span tree it happened.

Frequently Asked Questions about analyzing-mlflow-trace

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug a failed MLflow trace using a trace ID?

To debug a failed MLflow trace, retrieve the payload using the trace ID via the CLI. Analyze the span tree and status codes to locate the fault, correlating parent and child spans to application steps for precise root-cause identification.

What is the best way to interpret MLflow assessments that show an OK status but indicate a failure?

Interpreting MLflow assessments requires examining the rationale field to distinguish scorer errors from actual trace errors. An OK status may mask underlying issues, so focus on the assessment rationale and span status codes to understand execution quality.

How do I inspect MLflow span trees to find which tool or retrieval step caused an error?

Inspect MLflow span trees by correlating span names and parent-child structure to your application functions. This maps individual spans to specific tools, retrieval steps, or model calls, allowing you to narrow down the root cause of the failure.

Why does my MLflow trace analysis return empty or partial output for large payloads?

Large MLflow trace payloads can result in empty or partial output during analysis. To avoid this, use recommended CLI handling techniques to manage payload size, ensuring the full trace JSON structure is processed for accurate debugging.

Can I perform root-cause analysis on a single MLflow execution without setting up extra dependencies?

Yes, you can perform root-cause analysis on a single MLflow execution without extra dependencies. The Skill requires only the trace ID and analyzes the trace JSON structure, including span trees and status codes, to explain behavior and locate faults.