SWAM – Help & User Guide

What is SWAM?

SWAM (Secure Windows Asset Monitor) is a lightweight monitoring and asset visibility platform designed for MSP environments.

It provides centralised insight into Windows systems without the complexity or overhead of traditional RMM platforms.
In addition, it allows for the extraction of CPU utilisation, CPU temperature and Memory utilisation over a targeted period of time.

• Low resource usage on endpoints
• Explicit operator-driven actions
• Clear audit trails
• No silent background commands

Running Diagnostics

To start diagnostics on a system:

• Select the system in the left hand console
• Click Run Diagnostics in the right hand console
• Leave the time at the default of 45 minutes or increase/decrease as needed (0.15 or 3:00 for example) and click the START button

How Diagnostics Work

Diagnostics are agent-driven, not pushed in real time.

• A request file is published immediately to the web server
• The agent detects it on its next scheduled run (there is no way to accelerate this without manual intervention or a reboot).
• Diagnostics begin on the endpoint
• The first data packet typically arrives ~2 minutes later
• Additional packets follow every 2 minutes until the run completes.
• Diagnostics will run whether the user is signed in or not.

Resetting & Clearing Diagnostics

Reset Diagnostics

The Reset Diagnostic button removes all diagnostic results and returns the panel to a clean state.
This is useful for clearing stale data from the console.
Note that this will not work if a diagnostic run is currently in progress (see Clear Diagnostics).

Clear Diagnostics

If a run is interrupted the diagnostics will not resume (this is by design).
This may occur if a computer is shutdown or restarted mid run.
As the server has not received the final packet, it gets 'stuck' waiting for this to arrive.
In these cases, use the Clear Diagnostics button to reset the Diagnostic state.

Remote Agent Uninstall

This button is located at the very bottom of the details pane and schedules removal of the agent from the endpoint.

• There is a two minute cool off period, where in you may cancel the uninstall request.
• Then the uninstall request is published to the server.
• Agent executes uninstall on next run.
• Scheduled tasks and files are removed from the endpoint.
• The endpoint is then removed from the console.

Deleting a System

Use Edit → Delete System to remove the record from the console only.

Editing System Details

Select the system in the left hand menu, then select the Edit Button in the right hand pane.

Click the SAVE button to apply changes or the CANCEL button to discard changes.

Editable fields include:

• Company
• Description
• Notes
• Tags

Metric Configuration

Metric thresholds are configured in Settings.

You can adjust warning and critical thresholds and control overall health calculation.

User Management

Admins can add, remove, and promote users via Admin Settings → Users.

SMTP Settings

SMTP settings control alert and system emails.

Theme - Controls the default theme (light or dark) when opening the SWAM console.

Multi-Column Threshold - Sets how many cards are in a single column before they flow into a second column (Card View Only).

Refresh Interval - Sets the time that the console refreshes at.

Offline - sets an alert if the computer is offline for the specified amount of days.

CPU - Sets alert levels for CPU uitilisation.

RAM - Sets alert levels for memory utilisation.

Disk - Sets alert levels for disk usage.

Email/SMTP - Admin settings to modify mail server configuration.

Manage Users - Admin setting to add/remove technicians to the console, reset passwords etc.

Password Reset

Use Reset Password on the login screen to receive a reset link via email.

Searching Systems

Search supports:

• Hostname
• Company
• User
• Tags
• Notes

Generating Reports

Filter by company (or another criteria) and click the Reports button located top right to:

Download a CSV of system specs for all visible systems in the console.

Download a CSV by status (Red, Amber, Green).

Download a CSV list of systems by date last serviced.

All systems selected in the left pane will be included in the export.

Publishing Agent Scripts

Every PowerShell Script that touches an endpoint must be correctly signed.

On the AI Server:

• Drop to an elevated PowerShell prompt.
• Navigate to C:\projects\swam\
• Run the relevant signing script for the PowerShell that you have modified, it will be uploaded as part of the process.

• publish-swam-agent.ps1
• publish-swam-diagnostics.ps1
• publish-swam-uninstall.ps1

Operational Notes

• Agents only act on explicit server instructions
• All actions are logged and timestamped
• Failures can always be safely reset