zakura-trace-plots

Generate SVG plots and diagnostic summaries from Zebra Zakura performance trace directories.

42|10|Updated Jun 12, 2026
One-click install
npx skills add https://github.com/zakura-core/zakura --skill zakura-trace-plots
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: zakura-trace-plots
Source: https://github.com/zakura-core/zakura/tree/main/.agents/skills/zakura-trace-plots
Command: npx skills add https://github.com/zakura-core/zakura --skill zakura-trace-plots

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill addresses the difficulty of diagnosing performance bottlenecks in Zakura full nodes by automating the generation of visual metrics from raw trace data.

Core Features & Use Cases

  • Performance Visualization: Automatically generates SVG plots for applying, reorder, and stall metrics from trace directories.
  • Stall Diagnosis: Identifies Head-of-Line (HoL) stalls and memory pressure signatures through automated summary reports.
  • Use Case: When a node experiences sync slowdowns, use this skill to generate time-series plots that correlate block sync states with throughput, allowing for rapid identification of the root cause.

Quick Start

Use the zakura-trace-plots skill to generate performance plots and a summary for the trace directory located at path/to/trace_dir.

Frequently Asked Questions about zakura-trace-plots

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

FAQPage Schema
How do I visualize Zebra Zakura node performance trace data?

You can diagnose Zakura sync slowdowns by generating time-series plots that correlate block sync states with throughput. This skill automates the creation of visual metrics from raw trace data to help identify the root cause of node performance degradation.

What is the best way to identify Head-of-Line stalls in blockchain tracing data?

You can identify Head-of-Line stalls in Zakura tracing data by running this skill to generate automated diagnostic summary reports. It analyzes feedrun CSV files to detect HoL stalls and commit phase memory pressure signatures directly from the trace directory.

Do I need Python 3 to generate performance plots from JSONL and CSV data?

Yes, you need Python 3 installed to generate performance plots from JSONL and CSV data. This skill relies on Python 3 standard library modules to process block_sync.jsonl and feedrun CSV files for performance visualization.

How do I diagnose throughput bottlenecks from block_sync.jsonl files?

You diagnose throughput bottlenecks from block_sync.jsonl files by parsing the trace data to generate metrics-aware SVG plots. This skill analyzes applying and reorder metrics within the JSONL data to pinpoint the exact sync slowdowns.

Can I analyze commit phase memory pressure from Zakura trace directories without external dependencies?

Yes, you can analyze commit phase memory pressure from Zakura trace directories without external dependencies. This skill requires only Python 3 standard library modules to process JSONL and CSV data, requiring no external packages to generate diagnostic summaries.

Why does my Zakura node experience sync slowdowns during block processing?

Zakura node sync slowdowns during block processing often stem from throughput bottlenecks, HoL stalls, or commit phase memory pressure. This skill helps identify the root cause by generating time-series plots that correlate block sync states with throughput metrics.