Help & guides ›
LAN agents (internal network)
› Create first LAN monitor
Create first LAN monitor
4 min read · LAN agents (internal network)
In short: After installing the agent you create a LAN monitor via the "Add new monitor" button. In the type dropdown choose lan_ping, lan_tcp or lan_http, fill in the target and select the agent from the list.
Step by step
- In the dashboard click + Add new monitor.
- Enter a name (e.g. "NAS Synology - backups" or "Reception printer").
- In the Monitor type field choose one of the LAN types - see the table below.
- In the URL/hostname/host:port field enter the target.
- In the LAN agent field select the agent that should perform the check.
- Set the Interval (minimum depends on the plan).
- Press Create monitor.
Types and target format
| Type | Target format | Example |
|---|---|---|
| lan_ping | IP or hostname | 192.168.1.10 nas.local |
| lan_tcp | host:port |
10.0.0.50:5432 192.168.1.20:22 |
| lan_http | full URL | http://nas.local http://192.168.1.50:3000/healthz |
Tip - what to choose for a specific device:
- Router, switch, AP, printer, camera -
lan_pingis enough. Detects a power outage or a network error. - Database, SSH, SMTP, RDP, VPN gateway -
lan_tcpon a specific port. Detects even when the host is running but the service crashed. - NAS GUI, internal web, local API -
lan_http. Calls HTTP GET, accepts both 2xx and 3xx.
Sub-millisecond measurements
For LAN targets the RTT is typically less than 1 millisecond (e.g. 0.05 ms on local ethernet). ePulz.io stores response_ms as a float with precision to 3 decimal places. In charts and the dashboard you see exact values instead of rounding to whole milliseconds.
What happens during the first check
- The monitor is saved with
last_status = pending. - The agent at the next pull cycle (within 30 s) receives the task.
- It performs a local ping/TCP/HTTP check.
- Sends the result back via HTTPS. In the dashboard you will see
upordownwith response time.
Troubleshooting
- The monitor stays in the "pending" state - check that the agent is running (
journalctl -u epulzio-agent -fordocker logs epulzio-agent). - ping returns DOWN from the agent, but ping from the host works - in the Docker variant
--network hostis missing; the container is in an isolated network. - lan_http returns DOWN with an SSL error - the target has a self-signed cert. Use
http://instead ofhttps://for internal web applications. - I am getting a lot of false-positive alerts - increase
notify_after_failuresin the monitor detail (e.g. 3 = alert only after 3 consecutive failures).
Related:
Email and Telegram alerts for LAN monitors work the same as for cloud monitors.
Notifications ->