Skip to content

The dashboard ​

The page you land on, tile by tile.

The tiles ​

You get a system dashboard by default — Kiwire creates one automatically the first time a tenant has none — and you can build your own on top of it: create additional dashboards, lay out your own set of tiles, and share one with specific roles or keep it private. Each tile is fetched independently rather than the page loading everything in one request; each tile asks for its own widget type, and there are something like forty different tiles — live counters, daily-cached totals, top-N ranking tables, charts, and a handful of one-off cards like the tenant profile summary, a portal/enterprise page gallery, network status, a sign-in-methods breakdown, a media gallery, storage usage, an audit trail, a log tail, and a session lookup box. A few widgets (AI findings, marketing proposals, consent coverage) only render anything if the tenant is entitled to those features.

Live sessions and today's logins ​

The "active users" and "live connected" tiles count the live session list directly — not a report table — falling back to counting accounts flagged online if that list comes back empty. That makes them genuinely real-time: a guest connecting or disconnecting shows up on the next tile refresh, not on the next hourly aggregation.

"Sessions today" and "failed logins today", by contrast, sum columns out of the current month's hourly report table for everything between the tenant's local midnight and now. That table is only populated once an hour, when the aggregation job processes the previous completed hour — so the hour that's currently in progress has no row there yet. In practice this means the "today" totals on these tiles always lag by however much of the current hour has elapsed; a guest who logged in five minutes ago is already counted in "live connected" but won't show up in "sessions today" until the next aggregation run catches that hour up.

Bandwidth ​

The bandwidth tile's headline numbers — download, upload, total — are live too: summed straight off the same live session list's running counters, so they reflect what's actually flowing right now. Its twelve-hour trend sparkline and its day-over-day percentage change, though, both read the hourly report table instead, which means they carry the same lag as the login totals above — the most recent hour on the sparkline will read low or zero until the aggregation job has processed it.

What refreshes when ​

Widgets fall into a few different refresh tiers, and it's worth knowing which tier a given tile is in before treating a stale-looking number as a bug. Live KPIs — active users, live connected, bandwidth, new users/vouchers, failed logins, online devices — hit the tenant database on every request and are never cached. A second group of mostly-static totals — controller, zone, journey, campaign, voucher and profile counts, licence days remaining, accounts by type — is cached per tenant for a day at a time, since these change slowly. The "Refresh Data" button in the dashboard UI clears that entire cached group (plus the separate storage-usage figure) for the current tenant in one go, so if one of those totals looks wrong after a change elsewhere in the admin, that button — not a page reload — is what actually forces it to be recalculated.

Managing dashboards ​

The dashboards you can see sit in an icon-tab strip at the top of the page, and the ⋮ menu beside it acts on whichever tab is selected. New Dashboard and Rename ask for a name (and a tab icon and colour); Duplicate copies the current layout into a new personal dashboard of your own; Set as Default picks which dashboard the page opens on — one default per tenant, not per admin. Share / Visibility only appears on a dashboard you own, and offers three levels: Personal (only you), Shared — All Admins, or Shared — Selected Roles with a checklist of the tenant's roles. Export Layout downloads the widget layout as a JSON file and Import Layout replaces the current layout with one from such a file. Refresh Widgets just re-fetches every tile; Refresh Data is the cache-clearing action described above. Delete Dashboard removes the dashboard, except the last one.

Unless a custom icon was chosen, the tab icon says what kind of dashboard it is: a layout-dashboard icon is the system dashboard (also badged "System" next to the page title), a globe is shared with all admins, a people icon is shared with selected roles, and a grid is personal. The system dashboard can't be renamed, deleted or given a different visibility — those items are locked in its menu — and in their place it gains Reset to Default Layout, which restores the built-in tile set. Edit Layout switches the page into drag-and-drop mode, where tiles are added from the widget library, resized and rearranged, then saved.

Last updated:

Kiwire platform documentation