Skip to content

NodeVerdict: a browser-based viewer for TracingChannel diagnostic data #687

Description

@SnowLeopard-io

I've been working on a tool called NodeVerdict that might be of interest to this group.

Repo: https://github.com/SnowLeopard-io/NodeVerdict
Live demo: https://snowleopard-io.github.io/NodeVerdict/

It's a browser-based viewer for diagnostics_channel.TracingChannel events. You upload a JSON export of events (or OTel JSON, or a .ndv binary file), and it renders them as a timeline, waterfall chart, CPU flame graph, heap snapshot analysis, etc. All processing happens locally in the browser.

Image

Why I'm posting here

As more libraries add TracingChannel support (mysql2, ioredis, pg, Express — some merged, some in PR), there's a growing need for tools that can consume and visualize this data. NodeVerdict is an attempt to fill that gap on the "consumer" side.

The tool also happens to exercise the diagnostic APIs in ways that might surface rough edges or missing pieces. I've already run into a few things while building it that I plan to document separately.

What it supports

  • TracingChannel event timeline with channel filtering
  • Waterfall chart for async operation chains
  • CPU profile flame graph (.cpuprofile)
  • Heap snapshot analysis and diff (.heapsnapshot)
  • Live monitoring via WebSocket agent
  • OpenTelemetry JSON import
  • Large file streaming via Web Worker (no blocking)

What I'm looking for

  • Feedback from WG members on whether the direction is useful
  • Awareness of any WG roadmap items that NodeVerdict could align with
  • If there's interest, I'd be happy to contribute the tool to the WG's list of diagnostic projects

The repo has examples/ directory with sample data you can drop in to test.

Happy to answer questions or adapt the tool if it helps inform the WG's work.

Thanks.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions