Skip to content

armgit / Pulse

Public Imported from GitHub
0

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.

Link connected systems to the page that shows their data

rcourtman474efcee86c2
diff --git a/docs/release-control/v6/internal/subsystems/agent-lifecycle.md b/docs/release-control/v6/internal/subsystems/agent-lifecycle.md
index fdec653b82..66598a9380 100644
--- a/docs/release-control/v6/internal/subsystems/agent-lifecycle.md
+++ b/docs/release-control/v6/internal/subsystems/agent-lifecycle.md
@@ -9803,3 +9803,18 @@ sources through a runtime transition. Production collection/late-reply and
publication-order controls are in `guest_poll_ownership_test.go`; diagnostics
and both History stores are covered in `diagnostic_snapshots_test.go`. These
controls establish no native guest restart, thaw or prior-workload restoration.
+### Connected systems open the page that shows their data (14 October 2026)
+
+Settings > Infrastructure listed a connected PBS as Active, but its servers
+appear under Proxmox > Backups, and a user could not find them (#2905).
+Each connected API system's name now links to the page that shows its data:
+Proxmox VE to the Proxmox overview, PBS to Proxmox > Backups, Mail Gateway to
+Proxmox > Mail Gateway, vCenter to vSphere, TrueNAS to TrueNAS, and Docker or
+Kubernetes connections to their pages. `infrastructureRowMonitoringPath`
+in `connectionsTableModel.ts` owns the mapping. Agent hosts and availability
+checks get no link: an agent host appears on Proxmox, Machines or Kubernetes
+depending on what it runs, so a fixed destination would often be wrong. The
+link is underlined at rest, because touch users have no hover hint, and it
+does not depend on edit rights or read-only mode; Manage still owns
+connection settings.
+
diff --git a/docs/release-control/v6/internal/subsystems/frontend-primitives.md b/docs/release-control/v6/internal/subsystems/frontend-primitives.md
index 04b964ceeb..b7a85f461b 100644
--- a/docs/release-control/v6/internal/subsystems/frontend-primitives.md
+++ b/docs/release-control/v6/internal/subsystems/frontend-primitives.md
@@ -8672,6 +8672,15 @@ unresolved status would flash the default tab away from an admin on every load.
`__tests__/useSettingsAccess.test.tsx` pin the complete named-capability,
fail-closed mount, failed-status, deduplicated-load, and General-fallback rules.
+### Infrastructure system names are plain in-app links
+
+`InfrastructureSourceManager` renders a connected system's name as a plain
+`<a href>` to its monitoring page in both the desktop table and the phone
+cards; Solid Router intercepts it as an in-app navigation, so the component
+needs no router context. The name keeps its existing tooltip, carries a
+resting underline, and leaves the Actions column (budgeted for Manage and
+the install button) unchanged.
+
### Alert monitoring actions preserve domain ownership
The Alerts overview may offer a compact per-resource Monitoring menu, but the
diff --git a/frontend-modern/browser-verification/494c7754ed93aba7.json b/frontend-modern/browser-verification/494c7754ed93aba7.json
new file mode 100644
index 0000000000..c7ad80bd05
--- /dev/null
+++ b/frontend-modern/browser-verification/494c7754ed93aba7.json
@@ -0,0 +1,39 @@
+{
+ "version": 1,
+ "base_sha": "6f7926fddfe04fa697be686c483dc1c0acdd0ec1",
+ "verified_at": "2026-10-14T17:25:00Z",
+ "result": "passed",
+ "changed_paths": [
+ "frontend-modern/src/components/Settings/InfrastructureSourceManager.tsx",
+ "frontend-modern/src/components/Settings/connectionsTableModel.ts"
+ ],
+ "content_sha256": {
+ "frontend-modern/src/components/Settings/InfrastructureSourceManager.tsx": "6945af1729145ebc486be7a5400686299db487b47390a67f2fa0f473a54c8d2a",
+ "frontend-modern/src/components/Settings/connectionsTableModel.ts": "8bb363a094a4055882d795ea069be02e67ff07b1e4ee97bdf50ddd917a704c70"
+ },
+ "routes": [
+ "/settings/infrastructure",
+ "/truenas/overview",
+ "/vmware/overview"
+ ],
+ "viewports": [
+ {
+ "width": 1440,
+ "height": 900
+ },
+ {
+ "width": 375,
+ "height": 812
+ }
+ ],
+ "states": [
+ "embedded production build of origin/main plus this change, private mock stack (PULSE_MOCK_MODE: Lab vCenter, Archive NAS and 14 agent hosts as connected systems), compared with an unchanged origin/main build where every name is plain text and rows offer only Manage",
+ "1440px dark and light: Lab vCenter and Archive NAS names render blue with a resting underline, linking to /vmware/overview and /truenas/overview; agent host names stay plain; badges, member toggle and Actions column unchanged",
+ "375px light: the connected-system cards show Archive NAS as an underlined blue link and agent cards as plain names",
+ "mock data has no Proxmox VE, PBS or Mail Gateway connection rows; their mappings are covered by unit and component tests",
+ "no console errors"
+ ],
+ "interactions": [
+ "1440px: real click on Archive NAS navigates in-app to /truenas/overview (no page reload; a window marker survived) and browser Back returns to /settings/infrastructure"
+ ]
+}
diff --git a/frontend-modern/src/components/Settings/InfrastructureSourceManager.tsx b/frontend-modern/src/components/Settings/InfrastructureSourceManager.tsx
index 0463115211..07cd5f93bb 100644
--- a/frontend-modern/src/components/Settings/InfrastructureSourceManager.tsx
+++ b/frontend-modern/src/components/Settings/InfrastructureSourceManager.tsx
@@ -34,6 +34,7 @@ import {
} from '@/components/shared/groupedTableRowPresentation';
import {
connectionAgentVersionPresentation,
+ infrastructureRowMonitoringPath,
infrastructureSourcePresentation,
surfaceLabel,
type InfrastructureSourcePresentation,
@@ -69,6 +70,12 @@ interface InfrastructureSourceManagerProps {
onReviewDiscoveredSource?: (server: DiscoveredServer) => void;
}
+// A connected system's name opens the page that shows its data (#2905).
+// Underlined at rest: touch users get no hover hint, and the user in #2905 was
+// not looking for something to click.
+const MONITORING_LINK_CLASS =
+ 'text-blue-700 underline decoration-blue-700/40 underline-offset-2 hover:decoration-current focus-visible:decoration-current dark:text-blue-300 dark:decoration-blue-300/40';
+
// Per-section 'Add' shortcuts are demoted to ghost text buttons so the
// primary '+ Add infrastructure' CTA at the top of the page stays visually
// dominant. They retain the 1-click shortcut for users adding another node
@@ -956,14 +963,33 @@ export const InfrastructureSourceManager: Component<InfrastructureSourceManagerP
>
<TableCell class="py-1.5 pl-3 pr-3 align-middle">
<div class="flex min-w-0 flex-wrap items-center gap-1.5">
- <div
- class={`min-w-0 truncate text-[13px] ${
- row.isCluster ? 'font-medium text-base-content' : ''
- }`}
- title={rowSystemTitle(row)}
+ <Show
+ when={infrastructureRowMonitoringPath(row)}
+ fallback={
+ <div
+ class={`min-w-0 truncate text-[13px] ${
+ row.isCluster
+ ? 'font-medium text-base-content'
+ : ''
+ }`}
+ title={rowSystemTitle(row)}
+ >
+ {row.name}
+ </div>
+ }
>
- {row.name}
- </div>
+ {(path) => (
+ <a
+ href={path()}
+ class={`${MONITORING_LINK_CLASS} min-w-0 truncate text-[13px] ${
+ row.isCluster ? 'font-medium' : ''
+ }`}
+ title={rowSystemTitle(row)}
+ >
+ {row.name}
+ </a>
+ )}
+ </Show>
{(() => {
const presentation = infrastructureSourcePresentation(
row.source,
@@ -1459,12 +1485,27 @@ export const InfrastructureSourceManager: Component<InfrastructureSourceManagerP
<article class="rounded-md border border-border-subtle bg-surface p-3 shadow-xs">
<header class="flex items-start justify-between gap-2">
<div class="min-w-0 flex-1">
- <div
- class="wrap-break-word text-[13px] font-medium text-base-content"
- title={row.name}
+ <Show
+ when={infrastructureRowMonitoringPath(row)}
+ fallback={
+ <div
+ class="wrap-break-word text-[13px] font-medium text-base-content"
+ title={row.name}
+ >
+ {row.name}
+ </div>
+ }
>
- {row.name}
- </div>
+ {(path) => (
+ <a
+ href={path()}
+ class={`${MONITORING_LINK_CLASS} block wrap-break-word text-[13px] font-medium`}
+ title={row.name}
+ >
+ {row.name}
+ </a>
+ )}
+ </Show>
<Show when={row.isCluster && row.subtitle}>
<div class="mt-0.5 text-[11px] text-muted">
{row.subtitle}
diff --git a/frontend-modern/src/components/Settings/__tests__/InfrastructureSourceManager.test.tsx b/frontend-modern/src/components/Settings/__tests__/InfrastructureSourceManager.test.tsx
index 16e8b825ae..84ab570363 100644
--- a/frontend-modern/src/components/Settings/__tests__/InfrastructureSourceManager.test.tsx
+++ b/frontend-modern/src/components/Settings/__tests__/InfrastructureSourceManager.test.tsx
@@ -910,4 +910,46 @@ describe('InfrastructureSourceManager setup summary', () => {
expect(screen.getByTitle('esxi-01.lab.local · vSphere host')).toBeInTheDocument();
expect(screen.getByTitle('esxi-02.lab.local · vSphere host')).toBeInTheDocument();
});
+
+ it('links each connected API system to the page that shows its data', () => {
+ // A PBS read as Active here while its servers sat under Proxmox > Backups,
+ // and its user could not find it (#2905).
+ const apiRow = (type: Connection['type'], id: string, name: string) =>
+ row({
+ id,
+ ownerType: type,
+ name,
+ source: 'api',
+ connection: connectionFixture({
+ id,
+ type,
+ name,
+ address: `https://${name}`,
+ source: 'manual',
+ }),
+ });
+ render(() => (
+ <InfrastructureSourceManager
+ rows={() => [
+ apiRow('pbs', 'pbs:vault', 'backup-vault'),
+ apiRow('pmg', 'pmg:mail', 'mail-gateway'),
+ apiRow('vmware', 'vmware:vc-1', 'Lab vCenter'),
+ row(),
+ ]}
+ discoveredNodes={() => []}
+ discoveryEnabled
+ discoveryScanStatus={() => ({ scanning: false })}
+ readOnly
+ />
+ ));
+
+ const hrefs = (name: string) =>
+ screen.getAllByRole('link', { name }).map((link) => link.getAttribute('href'));
+ expect(new Set(hrefs('backup-vault'))).toEqual(new Set(['/proxmox/backups']));
+ expect(new Set(hrefs('mail-gateway'))).toEqual(new Set(['/proxmox/mail']));
+ expect(new Set(hrefs('Lab vCenter'))).toEqual(new Set(['/vmware/overview']));
+ // An agent host shows on a different page depending on what it runs.
+ expect(screen.queryByRole('link', { name: 'host-1' })).toBeNull();
+ expect(screen.getAllByText('host-1').length).toBeGreaterThan(0);
+ });
});
diff --git a/frontend-modern/src/components/Settings/__tests__/InfrastructureWorkspace.test.tsx b/frontend-modern/src/components/Settings/__tests__/InfrastructureWorkspace.test.tsx
index 9e539b5431..5a7bd7a070 100644
--- a/frontend-modern/src/components/Settings/__tests__/InfrastructureWorkspace.test.tsx
+++ b/frontend-modern/src/components/Settings/__tests__/InfrastructureWorkspace.test.tsx
@@ -2,9 +2,10 @@ import { cleanup, fireEvent, render, screen, waitFor, within } from '@solidjs/te
import { createSignal } from 'solid-js';
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
import type { Connection } from '@/api/connections';
-import type {
- InfrastructureSystemMemberRow,
- InfrastructureSystemRow,
+import {
+ infrastructureRowMonitoringPath,
+ type InfrastructureSystemMemberRow,
+ type InfrastructureSystemRow,
} from '../connectionsTableModel';
import { InfrastructureWorkspace } from '../InfrastructureWorkspace';
@@ -1451,3 +1452,26 @@ describe('InfrastructureWorkspace', () => {
expect(screen.queryByRole('heading', { name: 'Monitored systems' })).not.toBeInTheDocument();
});
});
+
+describe('infrastructureRowMonitoringPath', () => {
+ // A PBS read as Active in this workspace while its servers sat under
+ // Proxmox > Backups, and its user could not find it (#2905).
+ it('sends each API-collected system to the page that shows its data', () => {
+ expect(infrastructureRowMonitoringPath({ ownerType: 'pve' })).toBe('/proxmox/overview');
+ expect(infrastructureRowMonitoringPath({ ownerType: 'pbs' })).toBe('/proxmox/backups');
+ expect(infrastructureRowMonitoringPath({ ownerType: 'pmg' })).toBe('/proxmox/mail');
+ expect(infrastructureRowMonitoringPath({ ownerType: 'vmware' })).toBe('/vmware/overview');
+ expect(infrastructureRowMonitoringPath({ ownerType: 'truenas' })).toBe('/truenas/overview');
+ expect(infrastructureRowMonitoringPath({ ownerType: 'docker' })).toBe('/docker/overview');
+ expect(infrastructureRowMonitoringPath({ ownerType: 'kubernetes' })).toBe(
+ '/kubernetes/overview',
+ );
+ });
+
+ it('gives agent hosts and availability checks no single destination', () => {
+ // An agent host shows on Proxmox, Machines or Kubernetes depending on
+ // what it runs, so a fixed link would often be wrong.
+ expect(infrastructureRowMonitoringPath({ ownerType: 'agent' })).toBeUndefined();
+ expect(infrastructureRowMonitoringPath({ ownerType: 'availability' })).toBeUndefined();
+ });
+});
diff --git a/frontend-modern/src/components/Settings/connectionsTableModel.ts b/frontend-modern/src/components/Settings/connectionsTableModel.ts
index 7bbc204974..e6e169d14d 100644
--- a/frontend-modern/src/components/Settings/connectionsTableModel.ts
+++ b/frontend-modern/src/components/Settings/connectionsTableModel.ts
@@ -13,6 +13,13 @@ import type {
ConnectionFleetVersionDrift,
} from '@/api/connections';
import { getAgentHostProfileFamily } from '@/utils/platformSupportManifest';
+import {
+ buildDockerPath,
+ buildKubernetesPath,
+ buildProxmoxPath,
+ buildTrueNASPath,
+ buildVmwarePath,
+} from '@/routing/resourceLinks';
export const lastActivityTextFromLastSeen = (lastSeen?: string | null): string => {
if (!lastSeen) return 'No activity yet';
@@ -1038,6 +1045,25 @@ export interface InfrastructureSystemRow {
connection: Connection;
}
+// The page that shows a connected system's data. Settings lists the
+// connection, but a PBS reads as Active here while its servers live under
+// Proxmox > Backups, which users did not find (#2905). Agent hosts appear on
+// different pages depending on what they run, and availability checks under
+// Machines, so neither has a single destination.
+const MONITORING_PATH_BY_CONNECTION_TYPE: Partial<Record<ConnectionType, string>> = {
+ pve: buildProxmoxPath(),
+ pbs: buildProxmoxPath('backups'),
+ pmg: buildProxmoxPath('mail'),
+ vmware: buildVmwarePath(),
+ truenas: buildTrueNASPath(),
+ docker: buildDockerPath(),
+ kubernetes: buildKubernetesPath(),
+};
+
+export const infrastructureRowMonitoringPath = (
+ row: Pick<InfrastructureSystemRow, 'ownerType'>,
+): string | undefined => MONITORING_PATH_BY_CONNECTION_TYPE[row.ownerType];
+
// Pick the single most important problem to surface in the row's status
// column. Critical beats warning; otherwise first wins — the upstream
// builder has already prioritised highlights (attention before info).