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
Say "snapshot" only for guest snapshots on Backups
rcourtman23aace4409f8
diff --git a/docs/release-control/v6/internal/subsystems/frontend-primitives.md b/docs/release-control/v6/internal/subsystems/frontend-primitives.mdindex 900ecee2e6..94c5e4161c 100644--- a/docs/release-control/v6/internal/subsystems/frontend-primitives.md+++ b/docs/release-control/v6/internal/subsystems/frontend-primitives.md@@ -587,6 +587,13 @@ its presentation module are deleted. Backup jobs is the page's one daily barchart, so two look-alike bar charts never stack on one page. Earlier notes hereabout the chart's tooltip portal and day-control focus are historical.+### Backups source labels keep "snapshot" for guest snapshots (3 November 2026)++`proxmoxBackupSourcePresentation` names PBS items "PBS backup(s)" in every+label (filter, detail, fallback, timeline) and gives a PBS item with no+verification result the state "Backup"; the guest snapshot source keeps+"Snapshot". One word, one meaning on the page.+### Backup view tabs head the restore points, not the page (2 November 2026)On the Backups page the shared `PlatformSectionTabs` ("Backup views": By date,diff --git a/docs/release-control/v6/internal/subsystems/storage-recovery.md b/docs/release-control/v6/internal/subsystems/storage-recovery.mdindex c59d327075..a94b696f32 100644--- a/docs/release-control/v6/internal/subsystems/storage-recovery.md+++ b/docs/release-control/v6/internal/subsystems/storage-recovery.md@@ -5141,6 +5141,22 @@ it read as the datastore and its backups being fine. Connection health is onthe server header; phones keep a State column for the datastore's job result,a job problem or a fill forecast.+### On Backups, "snapshot" means a guest snapshot (3 November 2026)++The page used "snapshot" for two opposite things: PBS restore points, which+are backups, and guest snapshots, which are not and never count as+protection. PBS items are now "PBS backups" everywhere the page names them:+the source filter, record details, the Backup health header ("N with PBS+backups"), the loading and empty copy, and the Coverage "No PBS backup or PVE+backup file" cell, whose hover now says "A guest snapshot is not a separate+backup". A PBS backup with no verification result shows "Backup", not+"Snapshot", in the By date state column. Guest snapshots keep "Snapshot",+the `snapshots-only` health reason reads "Only guest snapshots", and the empty+list says items appear "when available" rather than "once backups run",+since backup jobs do not make guest snapshots. The PBS filter's hover notes+that PBS itself calls these backup snapshots. Source kinds, filters, URLs and+what counts as protection are unchanged.+### Backup servers rows are named by their datastore (2 November 2026)The Backup servers table keeps one row per datastore, but each row is nowdiff --git a/docs/release-control/v6/internal/subsystems/unified-resources.md b/docs/release-control/v6/internal/subsystems/unified-resources.mdindex cad7f88543..cd90c5374a 100644--- a/docs/release-control/v6/internal/subsystems/unified-resources.md+++ b/docs/release-control/v6/internal/subsystems/unified-resources.md@@ -222,6 +222,14 @@ narrow browser proof exercises the same producer through the inventory consumerwith native interactions and inspected pixels. No API, provider, guest, polling,auth, resource identity or protection-policy change, nor installed recovery claim.+### Backups names PBS restore points as backups (3 November 2026)++The Backups source presentation reads PBS items from the same PBS resource+and backup inventory as before, and now labels them "PBS backup(s)" rather+than "PBS snapshot(s)", so "snapshot" on that page means only a Proxmox VE+guest snapshot. Source kinds (`pbs`, `archive`, `snapshot`), filter values,+URLs, resource identity and what counts as protection are unchanged.+### Storeless PBS task history is not an unread job family (2 November 2026)The Backups Jobs column reads `PBSJobHealthEvidence.evidenceScope`: adiff --git a/frontend-modern/browser-verification/54e13ddf74be7284.json b/frontend-modern/browser-verification/54e13ddf74be7284.jsonnew file mode 100644index 0000000000..8a04af14bc--- /dev/null+++ b/frontend-modern/browser-verification/54e13ddf74be7284.json@@ -0,0 +1,42 @@+{+ "version": 1,+ "base_sha": "080f051c28249d3a307436f30c4974001ee16785",+ "verified_at": "2026-11-03T15:59:34Z",+ "result": "passed",+ "changed_paths": [+ "frontend-modern/src/features/proxmox/ProxmoxBackupsTable.tsx",+ "frontend-modern/src/features/proxmox/ProxmoxCoverageTable.tsx",+ "frontend-modern/src/features/proxmox/proxmoxBackupSourcePresentation.ts",+ "frontend-modern/src/features/proxmox/proxmoxBackupVerdict.ts"+ ],+ "content_sha256": {+ "frontend-modern/src/features/proxmox/ProxmoxBackupsTable.tsx": "0e86cede8577b867c440615bb3b4a603ea553c105e313307a5b1e38ba2b234c0",+ "frontend-modern/src/features/proxmox/ProxmoxCoverageTable.tsx": "6aca2bf59422a4082d3d635426a141d5522d6459ddc6734b9ca28d9a8351cb13",+ "frontend-modern/src/features/proxmox/proxmoxBackupSourcePresentation.ts": "3cc651152904c596925536c9ca1fb27c639ecf195f04210ea0bdc9eaca1639e3",+ "frontend-modern/src/features/proxmox/proxmoxBackupVerdict.ts": "842ab130cfb57438ae5fa6b125e50da0dccad59fa2d9e2259e0c97ea131015fa"+ },+ "routes": [+ "/proxmox/backups/date",+ "/proxmox/backups/coverage"+ ],+ "viewports": [+ {+ "width": 1024,+ "height": 607+ },+ {+ "width": 375,+ "height": 812+ }+ ],+ "states": [+ "mock mode built from this change on pulse-dev: PBS backups, PVE backup files and guest snapshots across 929 guests",+ "desktop and phone layouts, dark theme"+ ],+ "interactions": [+ "Backup health header reads 360 with PBS backups; the health reasons read No successful backup, Only guest snapshots, No backup in 7 days, Last backup failed, Backup status unknown",+ "the source filter offers PBS backups from Proxmox Backup Server (hover: which calls these backup snapshots), PVE backup files and Guest snapshots; no PBS snapshot text remains on the page",+ "expanding a PBS row shows Source PBS backup and the summary PBS backup in primary-vault / root",+ "at 375x812 the health rows are 32-33px and unclipped, By date rows are 37px and the page has no horizontal overflow"+ ]+}diff --git a/frontend-modern/src/features/proxmox/ProxmoxBackupsTable.tsx b/frontend-modern/src/features/proxmox/ProxmoxBackupsTable.tsxindex 705e2a5fa4..570a84642b 100644--- a/frontend-modern/src/features/proxmox/ProxmoxBackupsTable.tsx+++ b/frontend-modern/src/features/proxmox/ProxmoxBackupsTable.tsx@@ -782,7 +782,7 @@ export const ProxmoxBackupsTable: Component<{fallback={<PlatformTableLoadingStatetitle="Loading Proxmox backup inventory"- description="Reading PBS snapshots, PVE backup files, guest snapshots, and recent backup tasks."+ description="Reading PBS backups, PVE backup files, guest snapshots, and recent backup tasks."/>}>@@ -950,7 +950,7 @@ export const ProxmoxBackupsTable: Component<{emptyDescription={inventoryIncomplete()? 'Some backup sources are still loading or unavailable. Missing restore points do not mean no backups exist.'- : 'PBS snapshots, PVE backup files, and guest snapshots will appear here once backups run.'+ : 'PBS backups, PVE backup files, and guest snapshots will appear here when available.'}sortKey={recoverableSortKey}sortDirection={recoverableSortDirection}diff --git a/frontend-modern/src/features/proxmox/ProxmoxCoverageTable.tsx b/frontend-modern/src/features/proxmox/ProxmoxCoverageTable.tsxindex d448139d0e..6bde994e22 100644--- a/frontend-modern/src/features/proxmox/ProxmoxCoverageTable.tsx+++ b/frontend-modern/src/features/proxmox/ProxmoxCoverageTable.tsx@@ -81,10 +81,10 @@ import { PlatformWindowedRows } from '@/features/platformPage/PlatformWindowedRo// "None" instead of restating the source ("No PVE backup file"). The long form// truncated at most widths and stays available as the hover title.const COVERAGE_EMPTY_LABEL = 'None';-const COVERAGE_NO_BACKUP_TITLE = 'No PBS snapshot or PVE backup file';+const COVERAGE_NO_BACKUP_TITLE = 'No PBS backup or PVE backup file';// Matches the posture engine's own wording for a snapshot-only subject.const COVERAGE_SNAPSHOT_ONLY_TITLE =- 'No PBS snapshot or PVE backup file. A snapshot is not a separate backup, so it does not count.';+ 'No PBS backup or PVE backup file. A guest snapshot is not a separate backup, so it does not count.';const COVERAGE_HISTORY_UNKNOWN_TITLE ='No completed backup is visible in the current list. Missing entries do not mean no backups exist. Expand this row to inspect the evidence.';diff --git a/frontend-modern/src/features/proxmox/__tests__/ProxmoxBackupsTable.test.tsx b/frontend-modern/src/features/proxmox/__tests__/ProxmoxBackupsTable.test.tsxindex 5c57604dd4..431f9969e0 100644--- a/frontend-modern/src/features/proxmox/__tests__/ProxmoxBackupsTable.test.tsx+++ b/frontend-modern/src/features/proxmox/__tests__/ProxmoxBackupsTable.test.tsx@@ -558,7 +558,7 @@ describe('ProxmoxBackupsTable', () => {expect(screen.getAllByText('LXC').length).toBeGreaterThan(0);expect(screen.getAllByText('PBS').length).toBeGreaterThan(0);expect(screen.getByText('2 PBS files')).toBeInTheDocument();- expect(screen.getByRole('button', { name: /pbs snapshots/i })).toBeInTheDocument();+ expect(screen.getByRole('button', { name: /pbs backups/i })).toBeInTheDocument();expect(screen.getByRole('button', { name: /pve backup files/i })).toBeInTheDocument();expect(screen.getByRole('button', { name: /guest snapshots/i })).toBeInTheDocument();expect(screen.queryByRole('button', { name: 'Archives' })).not.toBeInTheDocument();@@ -673,7 +673,7 @@ describe('ProxmoxBackupsTable', () => {await screen.findAllByText('pbs-docker');expect(screen.getByRole('link', { name: /by date/i })).toHaveAttribute('aria-current', 'page');expect(screen.getByPlaceholderText(/search backups by workload/i)).toHaveValue('pbs-docker');- expect(screen.getByRole('button', { name: /pbs snapshots/i })).toHaveAttribute(+ expect(screen.getByRole('button', { name: /pbs backups/i })).toHaveAttribute('aria-pressed','true',);@@ -1960,7 +1960,7 @@ describe('backup-date-evidence connected inventory', () => {window.history.replaceState({}, '', '/?view=date');supply('2026-10-04T11:59:00Z', true);mount();- const toggle = await screen.findByRole('button', { name: /Expand details.*PBS snapshot/ });+ const toggle = await screen.findByRole('button', { name: /Expand details.*PBS backup/ });await fireEvent.click(toggle);toggle.focus();const panel = screen.getByTestId('proxmox-recoverable-detail');@@ -2286,7 +2286,7 @@ describe('Coverage qualifies missing restore evidence through the consuming API'No restore-point details are visible in the current list. The posture above may use previously recorded evidence.',),);- expect(within(rowElement()).getByTitle('No PBS snapshot or PVE backup file')).toHaveTextContent(+ expect(within(rowElement()).getByTitle('No PBS backup or PVE backup file')).toHaveTextContent('None',);expect(sourceCalls('pve')).toHaveLength(1);@@ -2514,7 +2514,7 @@ describe('completed restore-point summary', () => {it('does not claim PBS restore coverage for an incomplete-only inventory', async () => {const { container } = mountInventory(true);const summary = await screen.findByText(/0 completed restore points · 1 running · 1 failed/);- expect(summary).not.toHaveTextContent('with PBS snapshots');+ expect(summary).not.toHaveTextContent('with PBS backups');expect(container.querySelectorAll('[data-proxmox-backup-row="recoverable"]')).toHaveLength(2);expect(screen.getByRole('cell', { name: `${getRecoveryFullDateLabel('2026-10-04')} 2 entries` }),@@ -3264,7 +3264,7 @@ describe('By-date restore-point scope', () => {/>));const toggle = await screen.findByRole('button', {- name: /^Expand details for east-100 \(VM 100\) · PVE connection: east · PBS snapshot/,+ name: /^Expand details for east-100 \(VM 100\) · PVE connection: east · PBS backup/,});// With one PVE connection and one reader the row stays a single line;// the disclosure still names both scopes before it is opened.@@ -3294,13 +3294,13 @@ describe('By date recovery evidence limits', () => {explanation: /shares the guest's storage.*not a separate backup/,},{- name: 'verified PBS snapshot',+ name: 'verified PBS backup',pve: emptyPVE.data,pbs: [identityPBS({ protected: true })],explanation: /Verified is the provider's reported backup check, not a tested restore/,},{- name: 'unverified PBS snapshot',+ name: 'unverified PBS backup',pve: emptyPVE.data,pbs: [identityPBS({ verified: false })],explanation: /not reported as verified.*does not establish a successful restore/,@@ -3321,19 +3321,19 @@ describe('By date recovery evidence limits', () => {explanation: /Verified is the provider's reported backup check, not a tested restore/,},{- name: 'running PBS snapshot',+ name: 'running PBS backup',pve: emptyPVE.data,pbs: [identityPBS({ inProgress: true, writeActivityObserved: true, writeActive: true })],explanation: /incomplete and may still be in progress.*not a completed restore point/,},{- name: 'incomplete PBS snapshot with unread write activity',+ name: 'incomplete PBS backup with unread write activity',pve: emptyPVE.data,pbs: [identityPBS({ inProgress: true })],explanation: /incomplete and may still be in progress.*not a completed restore point/,},{- name: 'failed PBS snapshot',+ name: 'failed PBS backup',pve: emptyPVE.data,pbs: [identityPBS({ inProgress: true, writeActivityObserved: true, writeActive: false })],explanation: /No current writer is reported.*not a completed restore point/,diff --git a/frontend-modern/src/features/proxmox/__tests__/ProxmoxCoverageTable.test.tsx b/frontend-modern/src/features/proxmox/__tests__/ProxmoxCoverageTable.test.tsxindex 7d4c73a350..c5b599e2c6 100644--- a/frontend-modern/src/features/proxmox/__tests__/ProxmoxCoverageTable.test.tsx+++ b/frontend-modern/src/features/proxmox/__tests__/ProxmoxCoverageTable.test.tsx@@ -298,7 +298,7 @@ describe('ProxmoxCoverageTable column visibility', () => {expect(headers).toContain('Posture▲');expect(headers).toContain('Last backup');// Per-source ages are expansion detail at every width.- expect(headers).not.toContain('PBS snapshot');+ expect(headers).not.toContain('PBS backup');expect(headers).not.toContain('Guest snapshot');expect(headers).not.toContain('PVE file');expect(headers).not.toContain('Task');@@ -726,9 +726,9 @@ describe('ProxmoxCoverageTable column visibility', () => {));// The cell says None and the full reason sits on hover, so it cannot- // truncate to "No PBS snapshot or PVE b…".+ // truncate to "No PBS backup or PVE b…".const empty = (title: string) => document.querySelector(`td span[title="${title}"]`);- for (const title of ['No PBS snapshot or PVE backup file', 'No recent task']) {+ for (const title of ['No PBS backup or PVE backup file', 'No recent task']) {expect(empty(title)).toHaveTextContent(/^None$/);}});@@ -758,7 +758,7 @@ describe('ProxmoxCoverageTable column visibility', () => {span.getAttribute('title'),);expect(titles).toContain(- 'No PBS snapshot or PVE backup file. A snapshot is not a separate backup, so it does not count.',+ 'No PBS backup or PVE backup file. A guest snapshot is not a separate backup, so it does not count.',);expect(titles).toContain('This backup does not match a guest Pulse currently monitors, so it is not rated.',@@ -967,7 +967,7 @@ describe('Coverage absence requires readable, complete history', () => {posture: 'unprotected',protectionPosture: { ...completePosture, state: 'unprotected', coverage: 'none' },});- expect(screen.getByTitle('No PBS snapshot or PVE backup file')).toHaveTextContent(/^None$/);+ expect(screen.getByTitle('No PBS backup or PVE backup file')).toHaveTextContent(/^None$/);expect(screen.getByRole('status')).toHaveTextContent('No restore-point details are visible in the current list. The posture above may use previously recorded evidence.',);@@ -996,7 +996,7 @@ describe('Coverage absence requires readable, complete history', () => {expect(screen.getByRole('status')).toHaveTextContent('No restore-point details are visible in the current list. The posture above may use previously recorded evidence.',);- expect(screen.getByTitle('No PBS snapshot or PVE backup file')).toHaveTextContent('None');+ expect(screen.getByTitle('No PBS backup or PVE backup file')).toHaveTextContent('None');// No lastSuccessfulPointAt is expected for a guest snapshot. Nor may the// notice synthesize a raw snapshot, date or completed backup from prose.expect(screen.queryByText('Restore evidence')).not.toBeInTheDocument();diff --git a/frontend-modern/src/features/proxmox/__tests__/ProxmoxRecoverableTable.test.tsx b/frontend-modern/src/features/proxmox/__tests__/ProxmoxRecoverableTable.test.tsxindex cea526a6dc..28a551bee5 100644--- a/frontend-modern/src/features/proxmox/__tests__/ProxmoxRecoverableTable.test.tsx+++ b/frontend-modern/src/features/proxmox/__tests__/ProxmoxRecoverableTable.test.tsx@@ -90,14 +90,14 @@ describe('ProxmoxRecoverableTable record drawer', () => {));const toggle = screen.getByRole('button', {- name: /^Expand details for web \(VM 100\) · PVE connection: Not reported · PBS snapshot/,+ name: /^Expand details for web \(VM 100\) · PVE connection: Not reported · PBS backup/,});expect(toggle).toHaveAttribute('aria-controls', 'proxmox-recoverable-detail-pbs:web:100');await fireEvent.click(toggle);const panel = screen.getByTestId('proxmox-recoverable-detail');expect(within(panel).getByRole('heading', { level: 2, name: /web/ })).toBeInTheDocument();- expect(within(panel).getByText('PBS snapshot in main / pve1')).toBeInTheDocument();+ expect(within(panel).getByText('PBS backup in main / pve1')).toBeInTheDocument();expect(within(panel).getByText('main / pve1', { selector: 'span' })).toBeInTheDocument();expect(within(panel).getAllByText('Verified')).toHaveLength(2);expect(within(panel).getByText('Prune protection')).toBeInTheDocument();@@ -118,7 +118,7 @@ describe('ProxmoxRecoverableTable record drawer', () => {// Opening another restore point closes the first.await fireEvent.click(screen.getByRole('button', {- name: /^Expand details for db \(VM 101\) · PVE connection: Not reported · PBS snapshot/,+ name: /^Expand details for db \(VM 101\) · PVE connection: Not reported · PBS backup/,}),);expect(screen.getAllByTestId('proxmox-recoverable-detail')).toHaveLength(1);diff --git a/frontend-modern/src/features/proxmox/__tests__/backupWorkloadIdentity.test.tsx b/frontend-modern/src/features/proxmox/__tests__/backupWorkloadIdentity.test.tsxindex 0b801b4f32..2aaeb26136 100644--- a/frontend-modern/src/features/proxmox/__tests__/backupWorkloadIdentity.test.tsx+++ b/frontend-modern/src/features/proxmox/__tests__/backupWorkloadIdentity.test.tsx@@ -183,7 +183,7 @@ describe('backup workload identity in real inventory consumers', () => {);await fireEvent.click(screen.getByRole('link', { name: /by date/i }));const point = await screen.findByRole('button', {- name: /^Expand details for same-name \(VM 100\) · PVE connection: east · PBS snapshot/,+ name: /^Expand details for same-name \(VM 100\) · PVE connection: east · PBS backup/,});fireEvent.click(point);detail = screen.getByTestId('proxmox-recoverable-detail');@@ -228,7 +228,7 @@ describe('backup workload identity in real inventory consumers', () => {await fireEvent.click(screen.getByRole('link', { name: /by date/i }));fireEvent.click(await screen.findByRole('button', {- name: /^Expand details for VM 100 · PVE connection: Not reported · PBS snapshot/,+ name: /^Expand details for VM 100 · PVE connection: Not reported · PBS backup/,}),);expect(connectionRow(screen.getByTestId('proxmox-recoverable-detail'))).toHaveTextContent(diff --git a/frontend-modern/src/features/proxmox/__tests__/proxmoxBackupSourcePresentation.test.ts b/frontend-modern/src/features/proxmox/__tests__/proxmoxBackupSourcePresentation.test.tsindex a21e0d617c..4e10aa2b64 100644--- a/frontend-modern/src/features/proxmox/__tests__/proxmoxBackupSourcePresentation.test.ts+++ b/frontend-modern/src/features/proxmox/__tests__/proxmoxBackupSourcePresentation.test.ts@@ -14,8 +14,8 @@ describe('proxmoxBackupSourcePresentation', () => {badgeTone: 'sky',badgeLabel: 'PBS',coverageColumnLabel: 'Latest PBS',- filterLabel: 'PBS snapshots',- timelineLabel: 'PBS snapshots',+ filterLabel: 'PBS backups',+ timelineLabel: 'PBS backups',});expect(getProxmoxBackupSourcePresentation('archive')).toMatchObject({badgeTone: 'info',diff --git a/frontend-modern/src/features/proxmox/proxmoxBackupSourcePresentation.ts b/frontend-modern/src/features/proxmox/proxmoxBackupSourcePresentation.tsindex fbcc73ce95..baabb0ba9e 100644--- a/frontend-modern/src/features/proxmox/proxmoxBackupSourcePresentation.ts+++ b/frontend-modern/src/features/proxmox/proxmoxBackupSourcePresentation.ts@@ -21,20 +21,26 @@ export interface ProxmoxBackupSourcePresentation {timelineSwatchClassName: string;}+// "Snapshot" means one thing on the Backups page: a guest snapshot, which is+// not a separate backup and never counts as protection. PBS calls its own+// restore points snapshots too, but beside guest snapshots that reads as the+// same thing, so PBS items are named PBS backups here.const SOURCE_PRESENTATION: Record<ProxmoxBackupSourceKind, ProxmoxBackupSourcePresentation> = {pbs: {badgeTone: 'sky',badgeLabel: 'PBS',compactFilterLabel: 'PBS',coverageColumnLabel: 'Latest PBS',- coverageFallbackLabel: 'No PBS snapshot',- detailFallbackLabel: 'PBS snapshot',- filterAriaLabel: 'PBS snapshots from Proxmox Backup Server',- filterLabel: 'PBS snapshots',- filterTitle: 'Direct inventory from Proxmox Backup Server',+ coverageFallbackLabel: 'No PBS backup',+ detailFallbackLabel: 'PBS backup',+ filterAriaLabel: 'PBS backups from Proxmox Backup Server',+ filterLabel: 'PBS backups',+ // The PBS UI calls these backup snapshots; say so where it helps, not in+ // the labels.+ filterTitle: 'Direct inventory from Proxmox Backup Server, which calls these backup snapshots',sourceTitle: 'Direct inventory from Proxmox Backup Server',- stateFallbackLabel: 'Snapshot',- timelineLabel: 'PBS snapshots',+ stateFallbackLabel: 'Backup',+ timelineLabel: 'PBS backups',timelineSegmentClassName: 'bg-cyan-500',timelineSwatchClassName: 'bg-cyan-500',},diff --git a/frontend-modern/src/features/proxmox/proxmoxBackupVerdict.ts b/frontend-modern/src/features/proxmox/proxmoxBackupVerdict.tsindex c57c55add5..d604a118e2 100644--- a/frontend-modern/src/features/proxmox/proxmoxBackupVerdict.ts+++ b/frontend-modern/src/features/proxmox/proxmoxBackupVerdict.ts@@ -51,7 +51,7 @@ const reasonLabel = (reason: string, policy: ProtectionPosturePolicy | null): stcase 'no-history':return 'Backup status unknown';case 'snapshots-only':- return 'Snapshots only, no backup';+ return 'Only guest snapshots';case 'no-backup':return 'No successful backup';default: