Changelog

All notable changes to EZMON are documented here, following Keep a Changelog format.

🟢

This changelog is sourced from the official EZMON repository on the main branch.

v0.1.3 — Latest

Notification Target Type — Alert channels now support a targetType field (all | agent | monitor) to eliminate duplicate cross-source notifications
Target Type UI — Three-option selector (”🌐 All”, ”💻 Agents”, “☁️ Monitors”) in the Add/Edit Channel modal under Dashboard Settings → Alert Channels
Worker /debug Monitor Info — The /debug endpoint now includes a cloud_monitors section with last_status, next_check_at, due_now, and time_until_check
Worker /reset-monitors Endpoint — New POST /reset-monitors development endpoint to force re-evaluation of all monitors on the next trigger

Agent recovery double notification — lib/notify.ts was missing targetType filtering; added sourceType parameter and filter logic to dispatchNotification()
config_json JSONB read as string — Cloudflare Worker now wraps all config_json access with a JSON.parse() guard in dispatchNotifications()
Monitor notifications never firing — isTransition logic now also accepts unknown → down as a valid state change trigger
Duplicate notifications for all channels — dispatchNotifications() now filters by config_json.targetType matching the event sourceType
Monitor incidents failing silently — agent_id is now nullable in the incidents table; a metadata JSONB column was added for monitor context
DashboardIncident type mismatch — Changed innerJoin to leftJoin on agents; updated type to allow agentId: string | null
Worker beta deploy targeting production — Added explicit deploy:beta script (wrangler deploy --env beta) to apps/worker/package.json

Check Now button no longer updates lastStatus or nextCheckAt — only records a new row in cloud_check_results for the history graph

Custom Status Page Slug — Users can configure custom URLs (e.g. /status/my-server) from Dashboard Settings via a new custom_slug column in status_pages
Cloud Monitors on Status Page — Public Status Page now displays Cloud Monitors (HTTP/TLS/Keyword) alongside Agents, including latency data
Beta Worker Environment — [env.beta] configured in apps/worker/wrangler.toml for separate secrets and deployment (ezmon-evaluator-beta)
Notification Test Buttons — “Test Offline” and “Test Online” buttons in the Add/Edit Channel modal for live template preview
Test API Endpoint — POST /api/dashboard/notifications/test for dummy notification dispatch
Template Placeholder Resolution — dispatchNotification() now resolves {project}, {agent}, {monitor}, {status}, {time} placeholders

customOnlineMessage not applying — lib/notify.ts was missing template parsing logic on agent recovery; placeholder resolution now added
Zod schemas stripping unknown fields — customOfflineMessage and customOnlineMessage were silently discarded; fixed by adding .passthrough() to all config schemas

Heartbeat recovery handler now passes templateVars when dispatching online recovery notifications
Test endpoint uses distinct dummy values: {agent} → test-agent-1, {monitor} → test-monitor-1

Cloud Monitors — HTTP, TLS, and Keyword checks running on Cloudflare Worker Cron
Cloud check history — Results stored 30 days with automatic retention cleanup
GlobalAgentMap — Agent distribution map by country on the overview dashboard
Settings Hub — Alert Channels and Cloud Monitors moved to a unified Settings page
Docker monitoring — Agent reports running Docker container count
Tags & Grouping — Agents can be tagged for grouping
Public Status Page — Per-project configurable public status page
Metrics history charts — CPU/RAM/Disk/Network charts from 5-minute aggregated buckets
GitHub Actions CI/CD — Automated static Go binary builds for linux/amd64 and linux/arm64
Incidents UI — Filter open/resolved/all with pagination
targetType — Notification channels can be scoped to: agent, monitor, or all

Agent metrics now use gopsutil (CPU, RAM, Disk, Load, Network) — no more placeholders
Logo and branding updated
Turborepo upgraded to v2.9.10
middleware.ts replaced with proxy.ts convention (Next.js 16)
Versioning synchronized between root package.json, UI, and agent binary
Agent Version changed from const to var to allow linker injection via -ldflags at build time
Delete agent modal text translated from Indonesian to English
install.sh registration call now reads from EZMON_AGENT_VERSION env var

203/EXEC systemd error — binary now compiled statically (CGO_ENABLED=0) via GitHub Actions
Notification channels missing DELETE and PATCH toggle
JSONB parsing issue in Neon HTTP SQL API (config fields read as strings)
React import bug on notifications page
GlobalProjectSwitcher not syncing in beta environment
Sidebar version badge showing stale version — now reads dynamically from apps/web/package.json
Agent binary in GitHub Releases had no version in the filename
Infinite loading bug on /dashboard/status-page configuration view
forceMount prop warning in sidebar layout

Granular CPU Monitoring — Per-core CPU charts render dynamically based on actual agent hardware. Supports 64+ cores using HSL color generation
IP-based Agent Geolocation — Agent detects its public IP via ipify.org and resolves location (city, country, lat/lon) via ip-api.com
Interactive World Map — AgentLocationMap component with zoom/pan, country hover tooltip, animated agent pin, and full ISO 3166-1 numeric mapping (220+ countries)
Extended Time Range Selector — Metric charts support 5m, 10m, 30m, 1h, and custom range (min 5m, max 7d)
Automated Release Workflow — Single GitHub Actions workflow that auto-tags, builds agent binaries, and publishes versioned releases
Initial MVP — Authentication (NextAuth), Project management, Agent onboarding, Push-based heartbeat monitoring, Offline detection, Incident creation, Notification channels (Telegram, Discord, Webhook), Dashboard UI, and install.sh public installer script

Agent CPU collection switched from non-blocking to blocking cpu.Percent(1s, true) for accurate per-core real-time data
Heartbeat payload now includes publicIp field
cpuCoresAvg persisted as JSON array in metric_buckets for frontend parsing

Country map hover showing “Unknown (undefined)” for territories without geo ID
Country hover tooltip clipped at top/right edge of map
Missing ISO numeric codes for Serbia, Montenegro, Iceland, South Sudan, Oman, and others