Visentry Monitor Agent
Download and install the monitoring agent on your remote sites
Windows Agent
Runs as a Windows Service with a system tray config tool. Supports Windows 10, 11, Server 2019, and Server 2022.
Download Windows Installer (.exe)Installation Steps
- Download and run the installer
- The installer will:
- Install the monitoring Windows Service (runs 24/7)
- Install the Config Tool with system tray icon
- Start the service automatically
- The Config Tool opens after installation
Configuration
- Set the Server URL to:
http://monitoring.visentry.us - Enter the API Key provided by your administrator
- Enter a Site Name (e.g., "Main Office - Building A")
- Click Scan to discover devices on the network, or add them manually
- Select devices and click Add to Monitoring List
- Click Save — the service picks up changes automatically
Notes
- The service monitors continuously, even when no user is logged in
- The tray icon shows live status — double-click to open config
- Check "Start with Windows" to launch the tray icon on login
- Requires .NET Framework 4.7.2 (pre-installed on Windows 10+)
Linux Agent (Ubuntu/Debian)
Runs as a systemd service with an interactive CLI config tool. Supports Ubuntu 18.04+, Debian 10+, and similar distributions.
One-Line Install
Run this command on the remote device:
curl -sSL https://monitoring.visentry.us/Agent/linux/install.sh | sudo bash
Configuration
After installation, run the interactive config tool:
sudo visentry-config
- Select 1) Set server URL → enter
http://monitoring.visentry.us - Select 2) Set API key → enter the key from your administrator
- Select 3) Set site info → enter the site name
- Select 7) Network scan to discover devices, or 6) Manage devices to add manually
- Select q) Save and exit
Start the Service
sudo systemctl start visentry-agent
sudo systemctl enable visentry-agent
Other Commands
sudo visentry-config | Interactive configuration |
sudo visentry-agent --status | Show current config |
sudo visentry-agent --once | Test single monitoring cycle |
sudo visentry-scan | Quick network scan |
sudo systemctl status visentry-agent | Check service status |
sudo journalctl -u visentry-agent -f | View live logs |
Notes
- Requires Python 3 (auto-installed if missing)
- Runs as a systemd service — starts on boot, restarts on failure
- Config file:
/opt/monitoringagent/agent.json - Logs:
journalctl -u visentry-agent - To upgrade, re-run the install command — existing config is preserved
Verify Installation
After installing and configuring the agent, verify it's working:
- Check this dashboard — the new site should appear within 1-2 minutes
- The site card will show green (all devices up) or yellow/red (some devices down)
- Click on the site card to see individual device statuses
Redundancy: You can install multiple agents at the same site (e.g., Windows server + Linux edge device).
Agents from the same public IP are automatically merged into a single site on the dashboard.