Agent Setup

The EZMON agent is a statically-compiled Go binary that runs on your server and pushes heartbeat and metrics to the hub every 30 seconds.

Quick Install (Recommended)

Get your agent token

Go to your EZMON dashboard → Agents → Add Agent. Copy the token shown.

Run the installer


curl -fsSL https://ezmon.web.id/install.sh | bash -s -- \
  --token YOUR_AGENT_TOKEN \
  --name my-server-name

The installer will:

Detect your architecture (amd64 or arm64)
Download the latest static binary from GitHub Releases
Install to /usr/local/bin/ezmon-agent
Create and enable a systemd service

Verify it’s running


systemctl status ezmon-agent

Your agent should appear as Online in the dashboard within 30 seconds.

Manual Install

amd64


# Download the binary
wget https://github.com/efzynx/ez-mon/releases/latest/download/ezmon-agent-linux-amd64
 
# Make executable and move to PATH
chmod +x ezmon-agent-linux-amd64
sudo mv ezmon-agent-linux-amd64 /usr/local/bin/ezmon-agent
 
# Run with environment variables
EZMON_SERVER_URL=https://ezmon.web.id \
EZMON_AGENT_TOKEN=YOUR_AGENT_TOKEN \
ezmon-agent

Agent Environment Variables

Variable	Required	Default	Description
`EZMON_SERVER_URL`	✅	—	Hub URL (no trailing slash)
`EZMON_AGENT_TOKEN`	✅	—	Token from EZMON dashboard
`EZMON_AGENT_NAME`	❌	hostname	Display name in dashboard
`EZMON_HEARTBEAT_INTERVAL`	❌	`30`	Heartbeat interval in seconds

What the Agent Collects

The agent uses gopsutil to collect real system metrics:

Metric	Source	Data
CPU	`cpu.Percent()`	Total usage %
Memory	`mem.VirtualMemory()`	Used, total, %
Disk	`disk.Usage("/")`	Used, total, % (root partition)
Load	`load.Avg()`	1m, 5m, 15m load average
Network	`net.IOCounters()`	Bytes sent/received
Docker	`docker ps -q`	Running container count

The agent binary is statically compiled with CGO_ENABLED=0 via GitHub Actions, so it has no glibc dependency and runs on any Linux distribution.