EZMON Agent Setup

The EZMON Agent is a lightweight, statically compiled Go binary (CGO_ENABLED=0) running in the background of your Linux hosts. It monitors system performance metrics and pushes heartbeat payloads to the Hub every 30 seconds.

⚡ Quick Setup (Recommended)

Generate a One-Time Registration Token

Go to EZMON Dashboard → Agents → click Add Agent. Copy the temporary One-Time Registration Token (formatted as reg_...).

Registration tokens expire in 5 minutes to ensure high security and prevent token exposure in terminal command logs (.bash_history).

Run the Installation Script

Execute the following command on your target Linux machine (supports Alpine, Ubuntu, Debian, CentOS, AlmaLinux, RHEL, Arch Linux):

Interactive Mode (Secure)


curl -fsSL https://ezmon.web.id/install.sh | bash

The installer interactively prompts for your One-Time Registration Token (reg_...).

The install.sh script automatically:

Detects host architecture (amd64 or arm64)
Fetches official SHA-256 checksums from GitHub Releases and verifies binary integrity
Gracefully stops and replaces binary at /usr/local/bin/ezmon-agent
Configures and enables the systemd unit service (ezmon-agent.service)

Verify Service Status


systemctl status ezmon-agent

Your server will show up as ONLINE in the dashboard within a few seconds.

🔄 Upgrading Agents

When a new Hub version is released, the dashboard displays an Update Available badge and an Update Agent button on outdated nodes.

Method 1: Via Dashboard Upgrade Dialog

Click Update Agent on the agent detail toolbar in your dashboard.
Copy the fresh One-Time Registration Token auto-generated inside the dialog.
Re-run install.sh in your host terminal. The dialog automatically detects version sync and closes upon successful upgrade.

Method 2: Via Manual Terminal Command

Re-run the install.sh script with a fresh registration token. The script stops the old daemon, executes daemon-reload, and restarts the service with the updated binary.

📦 Manual Setup (Without Script)

If you prefer downloading static binaries manually:

amd64


wget https://github.com/efzynx/ez-mon/releases/latest/download/ezmon-agent-linux-amd64
chmod +x ezmon-agent-linux-amd64
sudo mv ezmon-agent-linux-amd64 /usr/local/bin/ezmon-agent
 
EZMON_SERVER_URL=https://your-hub.vercel.app \
EZMON_AGENT_TOKEN=YOUR_AGENT_TOKEN \
ezmon-agent

📊 Collected Metrics

Metric	Provider	Data
CPU	`gopsutil/cpu`	Total usage %, per-core CPU array
Memory	`gopsutil/mem`	Used MB, Total MB, Usage %
Disk	`gopsutil/disk`	Used GB, Total GB, Usage % (root `/`)
Load Average	`gopsutil/load`	Load 1m, 5m, 15m
Network	`gopsutil/net`	Bytes sent & bytes received
Docker	Docker Socket / CLI	Count of active Docker containers

Agent binaries are statically compiled without glibc dependencies (CGO_ENABLED=0), ensuring total compatibility across all Linux distributions.