Skip to content

Trace capture

Trace Capture

Trace Capture leverages a station config to capture data from devices attached to your station.

Example Random Config

Select the default 'Example Random Config' in the trace, click play, and start plotting some example data!

Random Config
Click the "Start trace capture" (Play) button!

Creating a Station Config

Navigate to the settings tab in the bottom left corner.

Trace Capture Settings
Navigate to Trace Capture Settings

The Zelos App looks for TOML station config files in the Configuration Folder.

Open/Create a station config file with your favorite editor and insert the config that describes your station!

See example station configs here: station config examples

Open/Create a station config file via VS Code (replace <user> with your username): 

code <Configuration Folder Path>/station.toml

Open/Create a station config file via Vim (replace <user> with your username): 

vim <Configuration Folder Path>/station.toml

Selecting a Station Config

After creating one or more station configs, specify the config that you want the application to utilize in the dropdown

Trace Capture Station Selector
Click the "Choose a config" dropdown

After selecting a specific config, click the trace capture start/stop button to start streaming data!

Troubleshooting

Station Config

Windows + WSL

This step assumes: - Zelos App is running in Windows - Application(s) generating data are running in WSL - Trace Data must be "forwarded" from WSL to Windows

First, grant Zelos tools firewall permissions:

Navigate to the Windows Firewall Inbound Rules and grant the Zelos app inbound connections:

Firewall
Select "Allow the connection", "Apply", and "OK"
Windows 11

In an administrator powershell window: 

Set-NetFirewallHyperVVMSetting -Name '{40E0AC32-46A5-438A-A0B2-2B479E8F2E90}' -DefaultInboundAction Allow

Windows 10

In an administrator powershell window: 

import-module -name netsecurity
New-NetFirewallRule -DisplayName "Zelos Server" -Direction Inbound -Action Allow -Protocol TCP -LocalPort 2300
Enable-NetFirewallRule -DisplayName "Zelos Server"

Forward Data

Finally, inside WSL, point the zelos-trace tool to push data at your Windows Zelos App: 

ZELOS_TRACE_FORWARD_URL=http://"$(hostname).local":2300/write zelos-trace --no-ws <your arguments here>
More examples for zelos-trace and ZELOS_TRACE_FORWARD_URL

Additional context for networking applications in WSL: https://learn.microsoft.com/en-us/windows/wsl/networking