GitHub - SwiftLogic-Systems/swifttopology: A high-performance, hardware-aware system observability tool. Maps CPU topology (NUMA, Caches, Cores) with real-time performance metrics (IPC, Cache Misses) using Deep-System eBPF (CO-RE) and a Rust-based Ratatui TUI

GitHub

2 min read Original article ↗

swift-topomap

This Week in Rust: Crate of the Week License: Apache 2.0 SwiftLogic Systems Validation: Bare Metal

swift-topomap is a zero-dependency, high-performance TUI utility designed to visualize physical hardware topology while overlaying real-time microarchitectural metrics via eBPF.

Developed by SwiftLogic Systems, it bridges the gap between hardware layout and software execution, allowing SREs and Systems Engineers to see exactly how their code interacts with the physical silicon.

Architecture-Aware Monitoring

Unlike standard tools that simply show "CPU Usage," swift-topomap uses hardware performance counters and eBPF to reveal the quality of execution.

Silicon Validation Gallery (Intel® Xeon®)

1. System Discovery (Idle) 2. Compute-Bound Load 3. Mixed Workload Resolution
Idle State Compute Bound Mixed Workload
Accurate 31.2GB RAM mapping and 8-core Xeon topology. Core 0 at 100% usage with a healthy 1.39 IPC. High-efficiency cache stress hitting 2.58 IPC.

Why swift-topomap?

  • The IPC Truth: Distinguish between a core that is calculating efficiently (Green) and one that is stalled waiting for memory (Amber).
  • Deep Topology: Native Rust parser for sysfs groups cores by physical L3 cache boundaries without requiring libhwloc.
  • Process Attribution: Real-time process names and PIDs pinned to specific physical cores via eBPF sched_switch hooks.
  • Accurate Memory Metrics: Professional NUMA RAM bars that account for KReclaimable and Inactive states to show true available memory.
  • Zero-Friction: A single 3.5MB statically-linked binary. No dependencies, no installers.

Installation (Zero-Friction)

Run the latest release on any Linux server instantly via curl. No package manager required.

curl -L -o topomap https://github.com/swiftlogicsystems/swifttopology/releases/download/v0.2.3-beta/swift-topomap \
&& chmod +x topomap && sudo ./topomap

Tech Stack

  • Logic: Rust (100% Native Sysfs Parser)
  • Kernel: C / eBPF (CO-RE)
  • Interface: Ratatui TUI
  • Bridge: libbpf-rs (Direct FFI)

Credits

Architecture design and kernel-level eBPF C code developed via AI Pair Programming with Gemini.

SwiftLogic Systems specializes in deep-system observability and low-latency infrastructure. swift-topomap is our first open-source contribution toward making microarchitectural bottlenecks visible to every developer.

Visit us at swiftlogic.systems.