tsdb-diagnosis

Diagnose training incidents by querying per-job Prometheus TSDB metrics.

29|3|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/AMD-AGI/maxtext-slurm --skill tsdb-diagnosis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tsdb-diagnosis
Source: https://github.com/AMD-AGI/maxtext-slurm/tree/main/skills/tsdb-diagnosis
Command: npx skills add https://github.com/AMD-AGI/maxtext-slurm --skill tsdb-diagnosis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose training incidents and assess cluster health by querying per-job Prometheus TSDB to identify root causes and validate monitoring data.

Core Features & Use Cases

  • Real-time troubleshooting of live jobs and post-mortem analysis using per-job TSDB data.
  • Correlate GPU, network, and system metrics with training events to diagnose issues.
  • Triaged, step-aligned verification to map metrics to training steps (tb_step).

Quick Start

Run tsdb-diagnosis on a live or completed RAY=1 job to begin per-job TSDB analysis and triage.

Frequently Asked Questions about tsdb-diagnosis

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

FAQPage Schema
How do I diagnose training incidents using Prometheus TSDB metrics?

Diagnose training incidents by querying per-job Prometheus TSDB to identify root causes and health issues. The skill correlates GPU, network, and system metrics with training events to validate monitoring data for live or completed RAY=1 jobs.

Can I use tsdb-diagnosis for post-mortem analysis on completed Ray jobs?

Yes, tsdb-diagnosis supports post-mortem analysis for completed RAY=1 jobs. You can query the per-job TSDB directory to review historical Prometheus metrics, parse TensorBoard metrics, and align them with training steps to identify past root causes.

What metrics are correlated when troubleshooting Ray training jobs?

Troubleshooting Ray training jobs involves correlating GPU, network, and system metrics with training events. The skill aligns these Prometheus TSDB metrics with training steps via tb_step to provide triaged, step-aligned verification for accurate triage decisions.

Do I need access to the per-job TSDB directory to run tsdb-diagnosis?

Yes, you need access to the per-job TSDB directory to run tsdb-diagnosis. Requirements include the ability to read Prometheus metrics, parse TensorBoard metrics, and align metrics with training steps via tb_step to accurately diagnose training incidents.

Why does my training job health assessment require step-aligned metrics?

Training job health assessment requires step-aligned metrics to accurately map TSDB data to training steps via tb_step. This step-aligned verification validates monitoring data and ensures triage decisions are based on precise correlations between metrics and training events.

What's the best way to triage GPU and network issues during live Ray training?

The best way to triage GPU and network issues during live Ray training is to query per-job Prometheus TSDB data. This skill applies real-time troubleshooting to live RAY=1 jobs, using TSDB as the primary evidence source to identify root causes and health issues.