Skip to content

Error Analytics

Simplified Implementation

The Error Analytics window is currently in a simplified state. Advanced features like filtering, charts, and detailed drill-down are planned for future releases.

Error Analytics helps you see what went wrong with your connections.

Opening Error Analytics

From the menu:

  1. Click StormTunnel in the top menu bar
  2. Select Windows → Error Analytics

From Settings:

  1. Open Settings (Cmd+,)
  2. Click Open Error Analytics button

Understanding Errors

When a connection fails, Error Analytics shows:

  • Error Type - What kind of problem occurred
  • Tunnel Name - Which tunnel had the issue
  • Timestamp - When it happened
  • Error Message - Details about what went wrong

Common Error Types

Error Meaning
Connection Refused Can't reach the host (may be offline or SSH is disabled)
Permission Denied Wrong SSH key or password
Host Unreachable Network or firewall is blocking the connection
Timeout Connection took too long to respond
Invalid Key The SSH key format isn't recognized
Port Already in Use Another app is using this local port

Finding Specific Errors

Search for a tunnel:

  1. Type the tunnel name in the search box
  2. Errors for that tunnel appear

Filter by time:

  1. Click the time filter dropdown
  2. Choose: Last 24 Hours, Last 7 Days, Last 30 Days, or All Time

Filter by type:

  1. Click the error type filter
  2. Select one type to focus on

Using Errors to Troubleshoot

Step 1: Find the error in Error Analytics

Step 2: Note the error message

Step 3: Check the Troubleshooting Guide for that error

Step 4: Make the recommended fix

Step 5: Try connecting again and check if the error reappears

Clearing Errors

To clean up old errors:

  1. Select errors you want to remove
  2. Click the delete button
  3. Errors are cleared

Tip: Clearing old errors makes it easier to focus on new problems.

Exporting Errors

To save error data for analysis or sharing:

  1. Click Export button
  2. Choose format (CSV or JSON)
  3. Select save location
  4. File is saved with all error details

This is useful for:

  • Sharing with support
  • Analyzing patterns over time
  • Creating records for your team