Skip to content

About

The System → About page is the central health-check view for a Watchgrid control plane. It rolls up version info, runtime statistics, and inventory counts into a single screen — handy for support, sizing, and answering "is the server fine?" without having to grep logs.

What you'll see

Versions

  • Server and Agent versions from /api/version.
  • Uptime of the server process (since the binary started, not since the container was created).
  • Platform — linux/amd64, linux/arm64, etc. — useful when reporting bugs.

Endpoints

Comes from /api/server/info:

  • Server URL — what the agent provisioning script sees as the control-plane address.
  • WireGuard endpoint — host:port advertised to new peers.
  • Magic DNS TLD — usually .wg.
  • Initialized — Yes once persistence is ready.

Control plane load

Live snapshot of the server container specifically — Postgres, registry, and frontend run in separate containers and aren't reflected here.

  • CPU — sampled from /sys/fs/cgroup/cpu.stat with a 150 ms delta. Normalized against the cgroup CPU quota if one is set (cpu.max), otherwise against the host core count. Sub-line shows raw "cores in use" so a 200 % spike on a multi-core box reads as 2.00 cores.
  • Memory — memory.current / memory.max from cgroup v2 (cgroup-v1 and host /proc/meminfo are used as fallbacks). When memory.max is unlimited, the host RAM is used as the denominator so the percentage stays meaningful.
  • Process row — Go heap allocation, live goroutine count, and host core count.

The card auto-refreshes every 5 seconds.

Database

Direct probe of the configured Postgres connection:

  • Up / Unreachable dot with ping latency in milliseconds.
  • Postgres version from SELECT version().
  • Server-side connections from pg_stat_activity (count of connections in current_database()).
  • Pool counters from db.Stats() — open / in-use / idle.

Inventory

Aggregate counts across the tenant:

  • Devices with online/offline breakdown.
  • Sites, Clusters.
  • Per-type split: physical / service / admin / other.

Identity

  • Users count.
  • Tenants count (super-admin only; tenant-admins see the current tenant name).

License

If a license is activated, shows tier, status, and expiry. Hidden when no license endpoint returns data.

Resources

Quick links to /api/docs (Swagger UI), docs.watchgrid.dev, and the provisioning URL of this control plane.

API

The page consumes:

Endpoint Purpose
GET /api/version Versions
GET /api/server/info URLs and endpoints
GET /api/system/stats Live CPU / memory / DB stats
GET /api/devices Device counts
GET /api/sites Site counts
GET /api/users User counts
GET /api/clusters Cluster counts
GET /api/tenants Tenant counts (super-admin)
GET /api/license/status License summary

All require an authenticated session.