Skip to main content

Logs and Diagnostics

Monitor VPN activity and troubleshoot issues using Vylos built-in logging, bandwidth tracking, and version information.

Logs

The Logs screen is accessible from Settings and contains two tabs:

  • App — Application-level action logs covering UI interactions, lifecycle events, sync operations, migration events, tunnel creation, and settings changes.
  • WireGuard — Network extension diagnostic logs from the WireGuard tunnel provider running in the background.
Logs tab on the App segment showing recent action entries Logs tab on the WireGuard segment showing daemon diagnostic entries

Log Files

Each tab corresponds to a pair of log files:

TabCurrent Session FilePrevious Session File
Appapp-actions.logapp-actions-prev.log
WireGuardnetwork-extension.lognetwork-extension-prev.log

When a new session starts, the current log file is rotated to the previous session file. This gives you access to logs from both the current and most recent prior session.

Log files are parsed off the main thread to avoid affecting app responsiveness.

Exporting Logs

Each tab can be exported separately. Tap the export button to generate a text file with a timestamped filename:

  • App logs export as vylos-app-TIMESTAMP.txt
  • WireGuard logs export as vylos-wireguard-TIMESTAMP.txt

The export uses the system Share sheet, allowing you to save the file, send it via email, AirDrop it, or share it through any other available method.

Bandwidth Statistics

Vylos tracks receive (Rx) and transmit (Tx) data for each tunnel individually. You can view bandwidth statistics from the tunnel detail screen.

Time Ranges

Two time ranges are available:

RangeIntervalDescription
Last 24 HoursHourlyOne data point per hour for the past day.
Last 30 DaysDailyOne data point per day for the past month.

Chart Visualization

Bandwidth data is displayed as a bar chart. The chart requires iOS 16.0 or later, macOS 13.0 or later, or visionOS 1.0 or later. On devices running earlier OS versions, the chart area shows an unavailable message instead.

Below the chart, cumulative Rx and Tx totals are shown for the selected time range. The chart refreshes automatically every 30 seconds.

Bandwidth chart with bar visualization and cumulative Rx / Tx totals

Tunnel List Summary

When a tunnel is connected, the tunnel list on the home screen displays a summary row showing total Rx and Tx values for that session.

How Bandwidth Data Works

Bandwidth statistics are built from snapshots. Each snapshot records a timestamp along with cumulative receive and transmit byte counts. The intervals shown in the chart are calculated as deltas between consecutive snapshots, giving you the amount of data transferred during each time period.

Version Information

The Settings screen displays version details at the bottom:

  • App version and build number — Shown in the format X.Y.Z (build), where X.Y.Z is the marketing version and build is the internal build number.
  • WireGuard Go version — The version of the WireGuard Go backend used by the network extension.