Real-time monitoring dashboard for Proxmox VE, PBS, Docker, Kubernetes, TrueNAS and vSphere. Self-hosted, with alerts for failed backups, full disks, unhealthy containers and offline nodes.
Go aialertsdashboarddockerdocker-monitoringgohomelabinfrastructure-monitoringkubernetesmonitoringmspproxmoxproxmox-backup-serverproxmox-mail-gatewayproxmox-veself-hostedtruenastypescriptvspherewebhooks
Open Backups on Coverage and name health reasons plainly
rcourtman4e8c969c5e32
diff --git a/docs/release-control/v6/internal/subsystems/frontend-primitives.md b/docs/release-control/v6/internal/subsystems/frontend-primitives.mdindex 6e358dd7fc..323f130ce5 100644--- a/docs/release-control/v6/internal/subsystems/frontend-primitives.md+++ b/docs/release-control/v6/internal/subsystems/frontend-primitives.md@@ -604,6 +604,14 @@ the slot the compact layout already gives a job problem. Its label comes fromalert changes, the unreadable store, the cross-connection id collision and thejob-problem precedence.+### Backups view tabs lead with Coverage (3 November 2026)++The Backups view tabs now list Coverage before By date, because Coverage is the+default view. They keep the same route-backed links and `aria-current`. The+Backup health reasons "No backup history" and "Backup source reported a+failure" become "Backup status unknown" and "Last backup failed"; each still+shares one 32px row with its count and bar at phone width.+### Backup jobs card composes the overview primitives (2 November 2026)`ProxmoxBackupJobsCard` is a `TableCard` with a `TableCardHeader` strip, likediff --git a/docs/release-control/v6/internal/subsystems/storage-recovery.md b/docs/release-control/v6/internal/subsystems/storage-recovery.mdindex 2c092c5b65..50b60114f1 100644--- a/docs/release-control/v6/internal/subsystems/storage-recovery.md+++ b/docs/release-control/v6/internal/subsystems/storage-recovery.md@@ -5071,6 +5071,26 @@ observed daily growth. The page owns the live alert store and passes a lookupthrough `ProxmoxBackupsTable`'s `datastoreAlerts`, so the table renders withoutan alerts provider and shows no forecast when none is given.+### Backups opens on Coverage, with plainer health reasons (3 November 2026)++The Backups tab now opens Coverage, which answers whether each guest is backed+up; By date stays one click away for finding a particular restore point, and+Coverage leads the view tabs. `PROXMOX_BACKUPS_DEFAULT_VIEW` is `coverage`, so+the section link and a bare `/proxmox/backups` bookmark both land there at+once, without waiting for the first assessment. Explicit `date` routes and+legacy `?view=` links are unchanged.++Two Backup health reasons read plainer. "No backup history" (`no-history`)+sounded like "No successful backup" (`no-backup`) while meaning the opposite:+Pulse cannot read any history for that guest, so it cannot say either way. It+now reads "Backup status unknown". "Backup source reported a failure"+(`source-failed`) is now "Last backup failed": the newest attempt failed after+the last success, so an older backup still exists, which is why it sits under+Needs attention. "No successful backup" stays, because "No backup found" is+reserved: the inventory makes no all-time completeness claim. The empty+Coverage table reads "Nothing to check yet". Which workloads each reason+selects is unchanged.+### Backup health reason rows show they open Coverage (2 November 2026)Each Backup health reason row was already a button that filters Coverage to@@ -9270,6 +9290,10 @@ read cadence and guest operations are unchanged; this is not native recovery.### Bare Backups entry chooses a view once, not on each health poll+Historical since 3 November 2026: a bare entry now opens Coverage at once (see+"Backups opens on Coverage, with plainer health reasons"). The rules below on+keeping the workspace through later polls still apply.+An existing `/proxmox/backups` bookmark without a named or legacy-query viewchooses its health-based default after readable inventory and the firstworkload protection assessment settle. Attention, unprotected or unknowndiff --git a/docs/release-control/v6/internal/subsystems/unified-resources.md b/docs/release-control/v6/internal/subsystems/unified-resources.mdindex ac04eb74a2..caeedb6a33 100644--- a/docs/release-control/v6/internal/subsystems/unified-resources.md+++ b/docs/release-control/v6/internal/subsystems/unified-resources.md@@ -256,6 +256,14 @@ from the uniquely correlated host agent when one exists). Correlation,retention and History targets are unchanged. `ProxmoxBackupServersTable.test.ts`pins that the row resource still carries the host readings.+### Backups default route is Coverage (3 November 2026)++`PROXMOX_BACKUPS_DEFAULT_VIEW` in `routing/resourceLinks.ts` is now+`coverage`, so `buildProxmoxBackupsPath()` and the Proxmox section link point+at `/proxmox/backups/coverage`. A bare `/proxmox/backups` redirects there at+once instead of waiting for the first protection assessment to choose a view.+Explicit `date` paths and legacy `?view=` links are unchanged.+### PBS datastore alerts join by instance id, not display name (2 November 2026)The Backup servers table finds a datastore's capacity alert from the unifieddiff --git a/frontend-modern/browser-verification/76bfdca3af211f44.json b/frontend-modern/browser-verification/76bfdca3af211f44.jsonnew file mode 100644index 0000000000..11dfd45aa6--- /dev/null+++ b/frontend-modern/browser-verification/76bfdca3af211f44.json@@ -0,0 +1,43 @@+{+ "version": 1,+ "base_sha": "a315a4878070098435213143ea6587f15dbda12e",+ "verified_at": "2026-11-03T09:42:56Z",+ "result": "passed",+ "changed_paths": [+ "frontend-modern/src/features/proxmox/ProxmoxBackupsTable.tsx",+ "frontend-modern/src/features/proxmox/proxmoxBackupVerdict.ts",+ "frontend-modern/src/routing/resourceLinks.ts"+ ],+ "content_sha256": {+ "frontend-modern/src/features/proxmox/ProxmoxBackupsTable.tsx": "34e8518d04063bd0a4631f3d714b061616ac0b4d17f01700e33ad939f280374c",+ "frontend-modern/src/features/proxmox/proxmoxBackupVerdict.ts": "37c55708e4097c9a3a478159b7b1a914e09c747fa9e2e4fd644470cd805db448",+ "frontend-modern/src/routing/resourceLinks.ts": "7c92daf521b4842b44a8fe4d7831537c5ece251c09e62772b3cedf525febb084"+ },+ "routes": [+ "/proxmox/overview",+ "/proxmox/backups",+ "/proxmox/backups/coverage",+ "/proxmox/backups/date"+ ],+ "viewports": [+ {+ "width": 1024,+ "height": 607+ },+ {+ "width": 375,+ "height": 812+ }+ ],+ "states": [+ "mock mode built from this change on pulse-dev: 929 guests with every Backup health reason present",+ "desktop and phone layouts, dark theme"+ ],+ "interactions": [+ "from Proxmox Overview clicked the Backups section link: it points at /proxmox/backups/coverage and opens Coverage, listed first in the view tabs",+ "opened the bare /proxmox/backups route: it redirects to /proxmox/backups/coverage at once",+ "Backup health reads No successful backup, Snapshots only, no backup, No backup in 7 days, Last backup failed and Backup status unknown, each on one 32-33px row",+ "clicked By date: the route is /proxmox/backups/date; clicked Last backup failed from there: Coverage opens filtered to reason=source-failed",+ "at 375x812 the health rows stay single-line with no clipped labels and no horizontal page overflow"+ ]+}diff --git a/frontend-modern/src/features/proxmox/ProxmoxBackupsTable.tsx b/frontend-modern/src/features/proxmox/ProxmoxBackupsTable.tsxindex ab1200b357..705e2a5fa4 100644--- a/frontend-modern/src/features/proxmox/ProxmoxBackupsTable.tsx+++ b/frontend-modern/src/features/proxmox/ProxmoxBackupsTable.tsx@@ -89,9 +89,10 @@ import {type BackupView = ProxmoxBackupsView;+// Coverage leads: "are my guests backed up?" is the question most visits ask.const BACKUP_VIEW_TABS: readonly { id: BackupView; label: string }[] = [- { id: 'date', label: 'By date' },{ id: 'coverage', label: 'Coverage' },+ { id: 'date', label: 'By date' },];const BACKUP_INVENTORY_POLL_MS = 30_000;@@ -515,13 +516,7 @@ export const ProxmoxBackupsTable: Component<{const backupVerdict = createMemo(() =>buildBackupVerdict(recoveryModel().coverageRows, protectionPostures.policy()),);- const view = (): BackupView =>- routeView() ??- legacyQueryView() ??- // A saved exception filter keeps Coverage even once that group is empty.- (exceptionFilter() !== null || backupVerdict().exceptions.length > 0- ? 'coverage'- : PROXMOX_BACKUPS_DEFAULT_VIEW);+ const view = (): BackupView => routeView() ?? legacyQueryView() ?? PROXMOX_BACKUPS_DEFAULT_VIEW;const backupViewPath = (next: BackupView): string => {const params = new URLSearchParams(location.search);@@ -539,16 +534,10 @@ export const ProxmoxBackupsTable: Component<{// Each exception group in the health strip toggles a Coverage filter to its// workloads. From the date view a group opens Coverage already filtered.const navigate = useNavigate();- // Old bookmarks can enter without a view segment. Pick their useful default- // only after the first assessment settles, then let the existing URL own it.- // A later poll must update health, not replace the workspace under inspection.+ // Old bookmarks can enter without a view segment; give them the default+ // view's route so the URL names what the page shows.createEffect(() => {- if (- location.pathname.replace(/\/+$/, '') !== PROXMOX_BACKUPS_PATH ||- legacyQueryView() ||- !hasReadableInventory() ||- ((props.workloads?.length ?? 0) > 0 && !protectionPostures.resolvedOnce())- ) {+ if (location.pathname.replace(/\/+$/, '') !== PROXMOX_BACKUPS_PATH || legacyQueryView()) {return;}navigate(`${backupViewPath(view())}${location.hash}`, { replace: true, scroll: false });@@ -582,8 +571,8 @@ export const ProxmoxBackupsTable: Component<{);return;}- // By date, or Coverage chosen only by the health fallback: land on the- // Coverage route so the view cannot flip back when the exceptions clear.+ // By date, or the bare path before its redirect: land on the Coverage+ // route with the group applied.const target = new URL(backupViewPath('coverage'), 'https://pulse.invalid');target.searchParams.delete(PROXMOX_BACKUPS_QUERY_PARAMS.posture);if (next) target.searchParams.set(PROXMOX_BACKUPS_QUERY_PARAMS.reason, next);@@ -992,8 +981,8 @@ export const ProxmoxBackupsTable: Component<{rows={liveCoverageRows()}hasAnyRows={liveTotalCount() > 0}emptyIcon={props.emptyIcon}- emptyTitle="No backup target coverage"- emptyDescription="VM, container, and host restore posture will appear here once backup data exists."+ emptyTitle="Nothing to check yet"+ emptyDescription="Each VM, container, and host appears here with its backup status."sortKey={coverageSortKey}sortDirection={coverageSortDirection}onSort={handleCoverageSort}diff --git a/frontend-modern/src/features/proxmox/__tests__/ProxmoxBackupsTable.test.tsx b/frontend-modern/src/features/proxmox/__tests__/ProxmoxBackupsTable.test.tsxindex d777343958..dc1558340e 100644--- a/frontend-modern/src/features/proxmox/__tests__/ProxmoxBackupsTable.test.tsx+++ b/frontend-modern/src/features/proxmox/__tests__/ProxmoxBackupsTable.test.tsx@@ -307,6 +307,7 @@ describe('ProxmoxBackupsTable', () => {it('keeps successful backup inventory independent of unavailable datastore capacity', async () => {mockBackupAPIs();+ window.history.replaceState({}, '', '/proxmox/backups/date');const failed = {...pbsServerResource,pbs: {@@ -685,6 +686,7 @@ describe('ProxmoxBackupsTable', () => {});it('filters restore points and coverage by PBS server and datastore', async () => {+ window.history.replaceState({}, '', '/proxmox/backups/date');const offsitePayload = {...pbsPayload,data: {@@ -783,8 +785,8 @@ describe('ProxmoxBackupsTable', () => {});expect(verdict).toHaveAttribute('data-backup-verdict', 'attention');const exceptions = within(screen.getByRole('list', { name: 'Backups that are not protected' }));- const group = exceptions.getByRole('button', { name: '1 backup source reported a failure' });- expect(group).toHaveTextContent('Backup source reported a failure');+ const group = exceptions.getByRole('button', { name: '1 last backup failed' });+ expect(group).toHaveTextContent('Last backup failed');// The hover title says where a click goes and previews the names; the// filtered Coverage table lists them all.expect(group).toHaveAttribute('title', 'Show in Coverage: pbs-docker (LXC 112)');@@ -870,7 +872,7 @@ describe('ProxmoxBackupsTable', () => {const group = () =>within(screen.getByRole('list', { name: 'Backups that are not protected' })).getByRole('button',- { name: '1 backup source reported a failure' },+ { name: '1 last backup failed' },);const reason = () => new URLSearchParams(window.location.search).get('reason');const settle = async () => {@@ -932,7 +934,7 @@ describe('ProxmoxBackupsTable', () => {await screen.findByRole('list', { name: 'Backups that are not protected' }),);const group = await exceptions.findByRole('button', {- name: '1 backup source reported a failure',+ name: '1 last backup failed',});expect(group).toHaveAttribute('aria-pressed', 'false');// Health bars fill with the metric bar colours every other Pulse bar uses.@@ -944,14 +946,15 @@ describe('ProxmoxBackupsTable', () => {expect(new URLSearchParams(window.location.search).get('reason')).toBe('source-failed');});expect(new URLSearchParams(window.location.search).get('posture')).toBeNull();- expect(- exceptions.getByRole('button', { name: '1 backup source reported a failure' }),- ).toHaveAttribute('aria-pressed', 'true');+ expect(exceptions.getByRole('button', { name: '1 last backup failed' })).toHaveAttribute(+ 'aria-pressed',+ 'true',+ );expect(group).toHaveAttribute('title', 'Clear this filter in Coverage');expect(screen.getAllByText('pbs-docker').length).toBeGreaterThan(0);// Toggling off keeps the same focused control rather than rebuilding it.- const pressed = exceptions.getByRole('button', { name: '1 backup source reported a failure' });+ const pressed = exceptions.getByRole('button', { name: '1 last backup failed' });expect(pressed).toBe(group);pressed.focus();await fireEvent.click(pressed);@@ -972,7 +975,7 @@ describe('ProxmoxBackupsTable', () => {));await screen.findByRole('button', {- name: '1 backup source reported a failure',+ name: '1 last backup failed',pressed: true,});await fireEvent.click(screen.getByRole('button', { name: /^protected$/i }));@@ -983,9 +986,7 @@ describe('ProxmoxBackupsTable', () => {});});- it('pins Coverage when an exception group is used on the bare Backups route', async () => {- // Coverage was chosen only because something needs attention; without the- // route segment the view would flip to By date once the exceptions cleared.+ it('applies an exception group from the bare Backups route on the Coverage route', async () => {mockBackupAPIs('attention');window.history.replaceState({}, '', '/proxmox/backups');@@ -993,9 +994,7 @@ describe('ProxmoxBackupsTable', () => {<ProxmoxBackupsTable emptyIcon={<span />} workloads={[workloadResource]} />));- await fireEvent.click(- await screen.findByRole('button', { name: '1 backup source reported a failure' }),- );+ await fireEvent.click(await screen.findByRole('button', { name: '1 last backup failed' }));await waitFor(() => {expect(window.location.pathname).toBe('/proxmox/backups/coverage');expect(new URLSearchParams(window.location.search).get('reason')).toBe('source-failed');@@ -3068,7 +3067,7 @@ describe('restore point list follows the consuming inventory scope', () => {);});-describe('bare Backups entry retains its assessed workspace', () => {+describe('bare Backups entry opens Coverage', () => {beforeEach(() => {vi.useFakeTimers({ toFake: ['setInterval', 'clearInterval'] });window.history.replaceState({}, '', '/proxmox/backups');@@ -3097,13 +3096,16 @@ describe('bare Backups entry retains its assessed workspace', () => {it.each([{ initial: 'attention', next: 'protected', view: 'coverage', table: 'coverage' },- { initial: 'protected', next: 'attention', view: 'date', table: 'recoverable' },+ { initial: 'protected', next: 'attention', view: 'coverage', table: 'coverage' },{ initial: 'unknown', next: 'protected', view: 'coverage', table: 'coverage' },+ // An explicit By date route holds its workspace through the same polls.+ { initial: 'protected', next: 'attention', view: 'date', table: 'recoverable' },] as const)('keeps $view, its open evidence and focus when $initial becomes $next',async ({ initial, next, view, table }) => {let state: 'protected' | 'attention' | 'unknown' = initial;apiFetchJSONMock.mockImplementation(() => Promise.resolve(responseFor(state)));+ if (view === 'date') window.history.replaceState({}, '', '/proxmox/backups/date');const historyLength = window.history.length;mountBackupReadState();await settleNavigation();@@ -3134,7 +3136,7 @@ describe('bare Backups entry retains its assessed workspace', () => {},);- it('waits for the initial assessment, preserves common filters/hash and replaces rather than pushes', async () => {+ it('does not wait for the assessment, preserves common filters/hash and replaces rather than pushes', async () => {const pending = deferred<ProtectionPosturesResponse>();apiFetchJSONMock.mockReturnValue(pending.promise);window.history.replaceState(@@ -3145,11 +3147,9 @@ describe('bare Backups entry retains its assessed workspace', () => {const historyLength = window.history.length;mountBackupReadState();await settleNavigation();- await screen.findByRole('link', { name: /by date/i });- expect(window.location.pathname).toBe('/proxmox/backups/');+ await waitFor(() => expect(window.location.pathname).toBe('/proxmox/backups/coverage'));pending.resolve(responseFor('attention'));await settleNavigation();- await waitFor(() => expect(window.location.pathname).toBe('/proxmox/backups/coverage'));expect(window.location.search).toBe('?q=pbs&node=pve-a&type=ct&operator=saved');expect(window.location.hash).toBe('#evidence');expect(window.history.length).toBe(historyLength);@@ -3214,27 +3214,15 @@ describe('bare Backups entry retains its assessed workspace', () => {expect(new URLSearchParams(window.location.search).get('reason')).toBe('stale');});- it('does not navigate after the pending entry is unmounted', async () => {- const pending = deferred<ProtectionPosturesResponse>();- apiFetchJSONMock.mockReturnValue(pending.promise);- const { unmount } = mountBackupReadState();- await screen.findByRole('link', { name: /by date/i });- unmount();- pending.resolve(responseFor('attention'));- await settleNavigation();- await Promise.resolve();- expect(window.location.pathname).toBe('/proxmox/backups');- });-- it('chooses By date after a readable empty inventory without requesting an unscoped assessment', async () => {+ it('opens Coverage for a readable empty inventory without requesting an unscoped assessment', async () => {apiFetchMock.mockImplementation((url: string) =>Promise.resolve(jsonResponse(url.endsWith('/pve') ? emptyPVE : emptyPBS)),);renderInRouter(() => <ProxmoxBackupsTable emptyIcon={<span />} workloads={[]} />);await settleNavigation();- await waitFor(() => expect(window.location.pathname).toBe('/proxmox/backups/date'));+ await waitFor(() => expect(window.location.pathname).toBe('/proxmox/backups/coverage'));expect(apiFetchJSONMock).not.toHaveBeenCalled();- await screen.findByText('No backups yet');+ await screen.findByText('Nothing to check yet');});});diff --git a/frontend-modern/src/features/proxmox/proxmoxBackupVerdict.ts b/frontend-modern/src/features/proxmox/proxmoxBackupVerdict.tsindex 454a5ae9af..c57c55add5 100644--- a/frontend-modern/src/features/proxmox/proxmoxBackupVerdict.ts+++ b/frontend-modern/src/features/proxmox/proxmoxBackupVerdict.ts@@ -31,7 +31,7 @@ export interface BackupVerdict {const reasonLabel = (reason: string, policy: ProtectionPosturePolicy | null): string | null => {switch (reason) {case 'source-failed':- return 'Backup source reported a failure';+ return 'Last backup failed';case 'backup-future-dated':return 'Backup dated in the future';case 'stale': {@@ -49,7 +49,7 @@ const reasonLabel = (reason: string, policy: ProtectionPosturePolicy | null): stcase 'history-unreadable':return 'Backup history unreadable';case 'no-history':- return 'No backup history';+ return 'Backup status unknown';case 'snapshots-only':return 'Snapshots only, no backup';case 'no-backup':diff --git a/frontend-modern/src/routing/__tests__/resourceLinks.test.ts b/frontend-modern/src/routing/__tests__/resourceLinks.test.tsindex 843513243d..8242083257 100644--- a/frontend-modern/src/routing/__tests__/resourceLinks.test.ts+++ b/frontend-modern/src/routing/__tests__/resourceLinks.test.ts@@ -166,7 +166,7 @@ describe('resource link routing contract', () => {expect(PROXMOX_PATH).toBe('/proxmox');expect(PROXMOX_DEFAULT_TAB).toBe('overview');expect(PROXMOX_BACKUPS_PATH).toBe('/proxmox/backups');- expect(PROXMOX_BACKUPS_DEFAULT_VIEW).toBe('date');+ expect(PROXMOX_BACKUPS_DEFAULT_VIEW).toBe('coverage');expect(PROXMOX_BACKUPS_QUERY_PARAMS).toEqual({query: 'q',view: 'view',@@ -181,7 +181,8 @@ describe('resource link routing contract', () => {expect(buildProxmoxPath()).toBe('/proxmox/overview');expect(buildProxmoxPath('/storage/')).toBe('/proxmox/storage');expect(buildProxmoxPath('')).toBe('/proxmox');- expect(buildProxmoxBackupsPath()).toBe('/proxmox/backups/date');+ expect(buildProxmoxBackupsPath()).toBe('/proxmox/backups/coverage');+ expect(buildProxmoxBackupsPath('date')).toBe('/proxmox/backups/date');expect(buildProxmoxBackupsPath('coverage')).toBe('/proxmox/backups/coverage');});diff --git a/frontend-modern/src/routing/resourceLinks.ts b/frontend-modern/src/routing/resourceLinks.tsindex 0d1df5277a..53968a5ece 100644--- a/frontend-modern/src/routing/resourceLinks.ts+++ b/frontend-modern/src/routing/resourceLinks.ts@@ -24,7 +24,7 @@ export const STANDALONE_QUERY_PARAMS = {export const PROXMOX_PATH = '/proxmox';export const PROXMOX_DEFAULT_TAB = 'overview';export const PROXMOX_BACKUPS_PATH = `${PROXMOX_PATH}/backups`;-export const PROXMOX_BACKUPS_DEFAULT_VIEW = 'date';+export const PROXMOX_BACKUPS_DEFAULT_VIEW = 'coverage';export type ProxmoxBackupsView = 'date' | 'coverage';export const PROXMOX_BACKUPS_QUERY_PARAMS = {query: 'q',diff --git a/tests/integration/tests/17-proxmox-backups-layout.spec.ts b/tests/integration/tests/17-proxmox-backups-layout.spec.tsindex f53db11afb..6a941f71a9 100644--- a/tests/integration/tests/17-proxmox-backups-layout.spec.ts+++ b/tests/integration/tests/17-proxmox-backups-layout.spec.ts@@ -41,11 +41,11 @@ async function openProxmoxBackups(page: Page) {});await expect(sections).toBeVisible({ timeout: 60_000 });await sections.getByRole("link", { name: "Backups", exact: true }).click();- await expect(page).toHaveURL(/\/proxmox\/backups\/date$/);+ await expect(page).toHaveURL(/\/proxmox\/backups\/coverage$/);// The route commits before the Proxmox snapshot finishes loading. CI can// take more than a minute while all E2E shards share the runner, so wait for// the destination surface rather than the URL alone.- await expect(page.getByText(/^\d+ backup entries$/).first()).toBeVisible({+ await expect(page.getByText(/^\d+ targets$/).first()).toBeVisible({timeout: 120_000,});}diff --git a/tests/integration/tests/90-operational-trust-protection-posture.spec.ts b/tests/integration/tests/90-operational-trust-protection-posture.spec.tsindex f7e9f11fd4..6fbafd1a80 100644--- a/tests/integration/tests/90-operational-trust-protection-posture.spec.ts+++ b/tests/integration/tests/90-operational-trust-protection-posture.spec.ts@@ -51,7 +51,7 @@ async function openDesktopProxmoxBackups(page: Page) {});await expect(sections).toBeVisible({ timeout: 60_000 });await sections.getByRole("link", { name: "Backups", exact: true }).click();- await expect(page).toHaveURL(/\/proxmox\/backups\/date$/);+ await expect(page).toHaveURL(/\/proxmox\/backups\/coverage$/);}test.describe("Operational trust protection posture", () => {