magic-trace

magic-trace collects and displays high-resolution traces of what a process is doing

22 articles 6k View on GitHub ↗
22 articles
Magic-Trace Collection Mode Auto-Detection and Fallback Behavior

Explore magic-trace's auto-detection of Intel Processor Trace (PT) and its fallback to stacktrace sampling. Discover how to override collection modes for efficient performance analysis.

deep-dive
May 24, 2026
How Magic-Trace Extracts OCaml Exception Information from Debug Symbols

Learn how Magic-Trace extracts OCaml exception information from debug symbols using ELF note sections and address lists to reconstruct exception control flow for effective tracing.

how-to-guide
May 24, 2026
How Magic-Trace Manages Multi-Snapshotting with Switch-Output Signals

Learn how Magic-Trace achieves multi-snapshotting using switch-output signals. Discover seamless output file rotation with SIGUSR2 without interrupting tracing.

internals
May 24, 2026
How to Attach magic-trace to a Running Process: PID vs. fzf Selection Methods

Learn to attach magic-trace to running processes using PID or fzf fuzzy selection. Explore efficient debugging methods for your applications.

how-to-guide
May 24, 2026
How to Trace Running Processes with magic-trace attach: A Complete Guide

Learn to trace running processes with magic trace attach command. Capture Intel Processor Trace data from live Linux processes with trigger options for in depth analysis.

how-to-guide
May 24, 2026
How Magic-Trace Controls perf Using ctlfd vs Signals: Implementation Deep Dive

Explore how Magic-Trace expertly manages perf control using ctlfd or signals. Discover the implementation details and benefits of its dynamic kernel version detection for reliable performance tracing.

deep-dive
May 24, 2026
magic-trace Debug Info and Symbol Table Requirements: A Complete Guide

Understand magic-trace debug info and symbol table needs. Learn how to configure your build for full source code tracing and symbol resolution to avoid raw addresses.

how-to-guide
May 24, 2026
How magic-trace Captures Kernel Traces with kcore Support

Learn how magic-trace captures kernel traces with kcore support by automatically enabling the --kcore flag for perf record in specific Intel Processor-Trace configurations. Optimize your kernel tracing.

how-to-guide
May 24, 2026
How magic-trace perf_dlfilter Resolves Symbols: The Dynamic Linker Filter Mechanism

Understand how magic-trace perf_dlfilter resolves symbols by intercepting perf events and utilizing dl_iterate_phdr for efficient symbol lookup and caching.

internals
May 24, 2026
How to Add Custom Events (branch-misses, cache-misses) to magic-trace Traces

Learn to add custom perf events like branch-misses and cache-misses to magic-trace traces using the --extra-events command-line option. Enhance your performance analysis today.

how-to-guide
May 24, 2026
Magic-Trace Full Execution Mode vs Snapshot Ring Buffer: Key Differences Explained

Understand the key differences between Magic-Trace full execution mode and the snapshot ring buffer. Learn when to use each for efficient system tracing.

deep-dive
May 24, 2026
How Magic‑Trace Handles ELF Files and Symbol Resolution

Learn how Magic-Trace processes ELF files and resolves symbols. Discover its advanced techniques for address translation and source symbol annotation for precise profiling.

how-to-guide
May 24, 2026

Have a question about this repo?

These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:

Share the following with your agent to get started:
curl -s "https://instagit.com/install.md"
Works with
Claude Codex Cursor VS Code OpenClaw Any MCP Client

Maintain an open-source project? Get it listed too →