SwiftServer
Troubleshooting

Monitoring Issues

When a status card is missing or a value is blank — check the data at its source and send us the output.

SwiftServer computes every metric from commands it runs on your server. When a card is missing or a value looks wrong, running the same command yourself shows immediately whether the data exists at the source — and its output is exactly what a useful bug report contains.

First, the expected gaps

Some absences are by design, not bugs:

  • GPU appears only when nvidia-smi exists; Docker only when Docker is found; CPU Load is hidden on Windows (no load average there).
  • CPU temperature is unavailable on macOS and Windows, and on Linux machines without a thermal sensor.
  • Disk I/O rates are Linux and Windows only. Swap shows N/A when the server has none.
  • Cards can also be manually hidden — check Settings → Dashboard → Status Detail Layout.
  • The free plan shows live status for 3 servers; see Premium.

Platform-by-platform coverage is on the platform notes page.

Check the data at its source

Open a terminal session on the affected machine and run the command for the card that misbehaves. If the command errors or prints nothing, the fix is on the server (install the tool, check permissions). If it prints sensible data but SwiftServer shows none — send us that output.

Linux

CardRun this
CPU Usagecat /proc/stat
CPU Loadcat /proc/loadavg
Memory / Swapcat /proc/meminfo
Processesps -eo pid,%cpu,rss,user,comm --sort=-%cpu | head -15
Networkcat /proc/net/dev and ip addr
Storagedf and cat /proc/diskstats
Temperaturecat /sys/class/hwmon/hwmon*/temp1_input
GPUnvidia-smi
System infocat /etc/os-release

Minimal container images often lack ps or ip — install procps and iproute2 and the Processes and Network cards fill in.

macOS

CardRun this
CPU Usagetop -l 1 -n 0 | grep "CPU usage"
CPU Loadsysctl -n vm.loadavg
Memoryvm_stat and sysctl -n vm.swapusage
Processesps -Aco pid,%cpu,rss,user,comm | head -15
Networknetstat -ibn
Storagedf -k -P
System infosw_vers

Windows (PowerShell)

CardRun this
System infoGet-CimInstance Win32_OperatingSystem | Select Caption,Version,BuildNumber
CPUGet-CimInstance Win32_Processor | Select Name,NumberOfLogicalProcessors
MemoryGet-CimInstance Win32_OperatingSystem | Select TotalVisibleMemorySize,FreePhysicalMemory
StorageGet-CimInstance Win32_LogicalDisk -Filter 'DriveType=3'
NetworkGet-NetAdapterStatistics
GPUnvidia-smi

If PowerShell itself errors over SSH, that is the lead — include the error.

vnStat history

If the Network card's history says vnStat is not installed, install it from humdi.net/vnstat — SwiftServer also detects vnStat running in a Docker container. Fresh installs need time to collect data before charts appear. To verify: vnstat --json f 12 (or docker exec -it vnstat vnstat --json f 12).

What to send

The card name, the machine's OS, the command output from above, and a screenshot of the card. If the whole machine shows Error instead, send the Event Log / SSH Diagnostics from its dialog — that is a connection issue.

On this page