hdds_viewer Network Analyzer
hdds_viewer is a military-grade observability tool for DDS/RTPS networks. It provides real-time capture, ML-powered anomaly detection, and visual debugging for robotics, defense, automotive, and medical applications.
Features
- Live capture - Record DDS traffic in real-time
- PCAP import - Analyze existing network captures
- ML anomaly detection - 15 automated detection rules
- QoS advisor - Detect DDS misconfigurations
- Visual topology - Interactive node graph
- Timeline analysis - Latency tracking with percentiles
- Multi-format export - JSON, CSV, YAML, Markdown
Quick Start
# Install
cargo install hdds-viewer
# Open a capture file (GUI mode)
hdds-viewer capture.hddscap
# Headless analysis with JSON output
hdds-viewer --analyze capture.hddscap --format json
# Live capture
hdds-viewer --live
CLI Options
hdds-viewer [OPTIONS] [FILE]
Arguments:
[FILE] Path to .hddscap file to analyze
Options:
-a, --analyze Run headless analysis (no GUI)
-f, --format <FMT> Output format: json, yaml, text (default: text)
--dump-features Dump ML features to CSV
-h, --help Print help
-V, --version Print version
Exit Codes
| Code | Meaning |
|---|---|
| 0 | No issues detected |
| 1 | Low severity anomalies |
| 2 | Medium severity anomalies |
| 3 | High severity anomalies |
| 4 | Critical issues or file errors |
Capture Formats
| Format | Extension | Description |
|---|---|---|
| HDDSCAP | .hddscap | Native format, optimized for ML analysis |
| PCAP | .pcap, .pcapng | Wireshark-compatible network capture |
ML Detection Rules
hdds_viewer implements 15 detection rules for DDS-specific anomalies:
| Rule | Description | Severity |
|---|---|---|
| GC Spike | Periodic latency from garbage collection | Medium-High |
| Cascade Failure | Downstream failures from upstream issues | Critical |
| Deadline Violation | DDS Deadline QoS not met | High |
| Resource Exhaustion | Memory/CPU depletion prediction | Critical |
| Periodic Pattern | Regular timing patterns (informational) | Low |
GUI Panels
| Panel | Purpose |
|---|---|
| Frame Table | Browse messages with filtering |
| Topology | Interactive node graph |
| Timeline | Latency analysis with p50/p95/p99 |
| QoS Advisor | Configuration issue detection |
| Metrics | Throughput and latency dashboards |
| Inspector | Payload hex/JSON view |
Performance
- Write throughput: 625 MB/s
- Message ingestion: 41M msg/s
- UI framerate: 60 FPS at all message rates
- Memory: Adaptive sampling for large captures
Themes
8 built-in themes including Dark Pro, Cyberpunk, High Contrast, and more.