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
Filter a network's running containers by Docker's run state
rcourtmanac18c1d9583f
diff --git a/docs/release-control/v6/internal/subsystems/frontend-primitives.md b/docs/release-control/v6/internal/subsystems/frontend-primitives.mdindex f08516337d..ed42532121 100644--- a/docs/release-control/v6/internal/subsystems/frontend-primitives.md+++ b/docs/release-control/v6/internal/subsystems/frontend-primitives.md@@ -2740,6 +2740,11 @@ not a replacement status card, CTA band, or page-local nested card.desktop table and inline detail. Consumers mark a normal-phone demotion with`platform-table-phone-hidden` on both its header and its body cell. The sharedcontainer rule owns the matching `th`/`td` visibility so the two cannot drift.+ A table that decides a column from its own measured layout instead drops the+ header and the cell under the same condition: the Docker Networks table had+ the class on the Subnets cell and the Driver header, so a phone showed+ `bridge` under SUBNETS. It now leaves both to its compact layout's Network+ details, and its browser proof counts visible headers against cells.Column visibility is container-led but `md:w-[...]` widths are viewport mediaqueries, so between a 34rem container and a 768px viewport the phone-hiddencolumns return while no width applies, and every visible column took an equaldiff --git a/docs/release-control/v6/internal/subsystems/unified-resources.md b/docs/release-control/v6/internal/subsystems/unified-resources.mdindex 30fac62361..d465fad8f5 100644--- a/docs/release-control/v6/internal/subsystems/unified-resources.md+++ b/docs/release-control/v6/internal/subsystems/unified-resources.md@@ -1867,7 +1867,13 @@ edge; that fallback must not match containers across Docker hosts. When asingle network has many attached containers, relationship consumers must keepthe attached container fields searchable and attention-filterable from thenetwork detail disclosure instead of forcing operators to inspect a full-container inventory table.+container inventory table. Its Attention filter is the rows' verdict (the+`mapDockerContainerStatus` dot), while Running and Other are Docker's run+state, so an unhealthy or crash-looping container that still runs matches+Running and Attention both; the sections stay one per row, Attention first.+The network's State counts every Attention row ("3 need attention", the dot+taking the worst). A phone row leaves Subnets and Driver, header and cell+together, to the expansion's Network details.2. `frontend-modern/src/components/Infrastructure/resourceDetailMappers.ts` shared with `performance-and-scalability`: resource detail mappers are both a canonical unified-resource consumer surface and a fleet-scale performance hot-path boundary.12. `frontend-modern/src/features/proxmox/ProxmoxBackupServersTable.tsx` shared with `storage-recovery`: Proxmox backup server table rows are both a storage/recovery backup-health surface and a unified-resource platform-table consumer boundary.diff --git a/frontend-modern/browser-tests/proxmox-docker-rows.cjs b/frontend-modern/browser-tests/proxmox-docker-rows.cjsindex c48d9d09c4..f877bec061 100644--- a/frontend-modern/browser-tests/proxmox-docker-rows.cjs+++ b/frontend-modern/browser-tests/proxmox-docker-rows.cjs@@ -59,6 +59,7 @@ const observations = (mode) => [actionReadiness: [{ name: 'restart', available: false, reason: 'Command agent disconnected' }],metrics: { cpu: { percent: 42 }, memory: { percent: 50, used: 5e8, total: 1e9 } },docker: {+ networks: [{ name: 'edge-net', ipv4: '10.88.0.10' }],agentId: 'agent-edge',hostSourceId: 'agent-edge',containerId: 'native-edge-web',@@ -82,6 +83,7 @@ const observations = (mode) => [status: 'offline',metrics: { cpu: { percent: 0 }, memory: { percent: 0 } },docker: {+ networks: [{ name: 'edge-net', ipv4: '10.88.0.11' }],agentId: 'agent-edge',hostname: 'edge-long-hostname',runtime: 'podman',@@ -96,6 +98,7 @@ const observations = (mode) => [status: 'degraded',metrics: { cpu: { percent: 3 }, memory: { percent: 20 } },docker: {+ networks: [{ name: 'edge-net', ipv4: '10.88.0.12' }],agentId: 'agent-edge',hostSourceId: 'agent-edge',containerId: 'native-edge-queue',@@ -110,6 +113,7 @@ const observations = (mode) => [status: 'running',metrics: { cpu: { percent: 5 }, memory: { percent: 10 } },docker: {+ networks: [{ name: 'edge-net', ipv4: '10.88.0.13' }],agentId: 'agent-edge',hostname: 'edge-long-hostname',runtime: 'docker',@@ -119,6 +123,16 @@ const observations = (mode) => [restartCount: 12,},}),+ base('edge-net', 'docker-network', {+ docker: {+ hostSourceId: 'agent-edge',+ hostname: 'edge-long-hostname',+ networkId: 'net-edge',+ driver: 'bridge',+ scope: 'local',+ enableIpv4: true,+ },+ }),base('nginx:latest', 'docker-image', {docker: {hostname: 'edge-long-hostname',@@ -294,7 +308,7 @@ const observations = (mode) => [timeout: 120000,});if (width === 390) await page.evaluate(() => document.documentElement.classList.add('dark'));- await page.getByText('10 REST-mapped rows', { exact: true }).waitFor();+ await page.getByText('11 REST-mapped rows', { exact: true }).waitFor();await check('REST-first PMG counters and facets are present before any websocket hydration',async () => {@@ -506,6 +520,52 @@ const observations = (mode) => [}});await capture('images');+ await select('Networks');+ await check('Network Running filter follows run state, not the verdict', async () => {+ const table = page.getByRole('region', { name: 'Network table' });+ const networkRow = table.locator('[data-docker-network-row="edge-net"]');+ const headers = await table.locator('th:visible').allTextContents();+ // Every visible header sits over its own cells, and a phone leaves+ // Subnets and Driver to the expansion's Network details.+ assert.equal(await networkRow.locator('td:visible').count(), headers.length);+ if (width === 390) {+ assert.ok(!headers.some((h) => /Subnets|Driver/i.test(h)), JSON.stringify(headers));+ }+ // The state counts every container the Attention filter holds, whole.+ const state = networkRow.getByText('3 need attention', { exact: true });+ const fit = await state.evaluate((e) => ({ scroll: e.scrollWidth, client: e.clientWidth }));+ assert.ok(fit.scroll <= fit.client, JSON.stringify(fit));+ await networkRow.click();+ const detail = table.locator('[data-docker-network-detail-row="edge-net"]');+ await detail.getByText('edge-loop', { exact: true }).waitFor();+ const visibleNames = async () =>+ (+ await Promise.all(+ ['edge-web', 'edge-loop', 'edge-queue', 'edge-cache'].map(async (name) =>+ (await detail.getByText(name, { exact: true }).count()) > 0 ? name : null,+ ),+ )+ ).filter(Boolean);+ // A phone keeps the status chips behind the toolbar's Filters button.+ const chooseStatus = async (name) => {+ const chip = page.getByRole('button', { name });+ if (!(await chip.isVisible())) {+ await detail.getByRole('button', { name: /Filters/ }).click();+ }+ await chip.click();+ };+ // Unhealthy and crash-looping containers still run: they match Running+ // and sit in its Attention section.+ await chooseStatus(/^Running, 2$/);+ assert.deepEqual(await visibleNames(), ['edge-web', 'edge-loop']);+ await detail.getByText('Needs operator review', { exact: true }).waitFor();+ await chooseStatus(/^Other, 2$/);+ assert.deepEqual(await visibleNames(), ['edge-queue', 'edge-cache']);+ await chooseStatus(/^Attention, 3$/);+ assert.deepEqual(await visibleNames(), ['edge-web', 'edge-loop', 'edge-queue']);+ await chooseStatus(/^Running, 2$/);+ });+ await capture('networks');await select('Swarm');await check('Swarm state and started time use operator wording with raw evidence retained',diff --git a/frontend-modern/browser-tests/proxmox-docker-rows.tsx b/frontend-modern/browser-tests/proxmox-docker-rows.tsxindex 1c1c42dc55..2864015062 100644--- a/frontend-modern/browser-tests/proxmox-docker-rows.tsx+++ b/frontend-modern/browser-tests/proxmox-docker-rows.tsx@@ -8,6 +8,7 @@ import { useUnifiedResources } from '../src/hooks/useUnifiedResources';import { ProxmoxMailGatewayTable } from '../src/features/proxmox/ProxmoxMailGatewayTable';import { DockerContainersTable } from '../src/features/docker/DockerContainersTable';import { DockerImagesTable } from '../src/features/docker/DockerImagesTable';+import { DockerNetworksTable } from '../src/features/docker/DockerNetworksTable';import { DockerServicesTable } from '../src/features/docker/DockerServicesTable';import { DockerTasksTable } from '../src/features/docker/DockerTasksTable';import { StackedDiskBar } from '../src/components/Workloads/StackedDiskBar';@@ -76,15 +77,17 @@ function Fixture() {<main class="min-h-screen space-y-4 bg-surface p-4 text-base-content"><h1 class="text-lg font-semibold">Transport facets and operator rows</h1><nav aria-label="Fixture views" class="flex flex-wrap gap-2">- {['Mail', 'Storage', 'Containers', 'Images', 'Swarm', 'Disk'].map((name) => (- <button- type="button"- class="min-h-11 rounded border border-border px-3"- onClick={() => setView(name)}- >- {name}- </button>- ))}+ {['Mail', 'Storage', 'Containers', 'Images', 'Networks', 'Swarm', 'Disk'].map(+ (name) => (+ <button+ type="button"+ class="min-h-11 rounded border border-border px-3"+ onClick={() => setView(name)}+ >+ {name}+ </button>+ ),+ )}</nav><p data-fixture-loaded>{rows.resources().length} REST-mapped rows</p><Show when={view() === 'Mail'}>@@ -128,6 +131,15 @@ function Fixture() {<DockerImagesTable resources={ofType('docker-image')} {...nativeProps} /></section></Show>+ <Show when={view() === 'Networks'}>+ <section aria-label="Network table">+ <DockerNetworksTable+ resources={ofType('docker-network')}+ relatedResources={rows.resources()}+ {...nativeProps}+ />+ </section>+ </Show><Show when={view() === 'Swarm'}><section aria-label="Swarm services"><DockerServicesTable resources={ofType('docker-service')} {...nativeProps} />diff --git a/frontend-modern/browser-verification/aeb70b4cb2009fae.json b/frontend-modern/browser-verification/aeb70b4cb2009fae.jsonnew file mode 100644index 0000000000..837dc5d2ac--- /dev/null+++ b/frontend-modern/browser-verification/aeb70b4cb2009fae.json@@ -0,0 +1,37 @@+{+ "version": 1,+ "base_sha": "4c82d303cdf61f64a450de19f11a9c5fc3576ff9",+ "verified_at": "2026-10-14T16:03:47Z",+ "result": "passed",+ "changed_paths": [+ "frontend-modern/src/features/docker/DockerNetworksTable.tsx"+ ],+ "content_sha256": {+ "frontend-modern/src/features/docker/DockerNetworksTable.tsx": "ed02d864a68ff28276a0c44e370a0ee1882b6572e7ade22fd4ca90d45a744b3f"+ },+ "routes": [+ "browser-tests/proxmox-docker-rows.html Networks view (production DockerNetworksTable over REST-mapped rows, Chromium and WebKit via Playwright 1.56.1 on pulse-dev)"+ ],+ "viewports": [+ {+ "width": 1440,+ "height": 900+ },+ {+ "width": 390,+ "height": 844+ }+ ],+ "states": [+ "network with unhealthy, crash-looping (12 restarts), degraded and exited containers: Running 2 shows the two running ones under their Attention section (old: Running 0)",+ "Other 2 (degraded with no reported state, exited), Attention 3",+ "network State \"3 need attention\" with a red dot (old: \"1 needs attention\")",+ "phone: no Subnets or Driver header or cell; header and cell counts match (old: bridge under SUBNETS); State whole",+ "attached-containers header shows the total; the filtered count reads once in the toolbar",+ "reviewed by Sol from desktop and phone screenshots; its follow-ups applied and re-checked"+ ],+ "interactions": [+ "network row expand",+ "status chips All/Attention/Running/Other, opened from Filters on the phone"+ ]+}diff --git a/frontend-modern/src/features/docker/DockerNetworksTable.tsx b/frontend-modern/src/features/docker/DockerNetworksTable.tsxindex 8d6ff264a2..bb065e167c 100644--- a/frontend-modern/src/features/docker/DockerNetworksTable.tsx+++ b/frontend-modern/src/features/docker/DockerNetworksTable.tsx@@ -34,6 +34,7 @@ import {} from './DockerNativeTableShared';import {buildDockerNetworkAttachmentRows,+ dockerContainerRunState,dockerResourceSearchHaystack,filterDockerResources,type DockerNetworkAttachmentRow,@@ -55,12 +56,15 @@ const DOCKER_NETWORK_COLUMN_WIDTH_CLASS: Record<PlatformTableContainerLayout,Record<DockerNetworkColumn, string>> = {+ // A phone row has no Subnets or Driver column (the expansion's Network+ // details list both), so the attached summary and its state get the room:+ // "3 need attention" whole beside its dot, the summary truncating instead.compact: {network: 'w-[30%]',- attached: 'w-[25%]',- attention: 'w-[15%]',- subnet: 'w-[15%]',- driver: 'w-[15%]',+ attached: 'w-[30%]',+ attention: 'w-[40%]',+ subnet: 'w-0',+ driver: 'w-0',host: 'w-0',},basic: {@@ -123,12 +127,12 @@ const ATTACHMENT_STATUS_FILTER_OPTIONS: PlatformTableFilterOption<AttachmentStat{value: 'running',label: 'Running',- title: 'Running containers',+ title: 'Running containers, including any that need review',},{value: 'other',label: 'Other',- title: 'Stopped, paused, or unknown containers',+ title: 'Containers not known to be running: stopped, paused, restarting, or unknown',},];@@ -177,13 +181,13 @@ const attachmentSummary = (rows: readonly DockerNetworkAttachmentRow[]): stringconst attachmentAttention = (rows: readonly DockerNetworkAttachmentRow[]): StatusIndicator => {if (rows.length === 0) return { variant: 'muted', label: 'Unused' };- const danger = rows.filter((row) => row.status.variant === 'danger').length;- if (danger > 0) {- return { variant: 'danger', label: `${danger} needs attention` };- }- const warning = rows.filter((row) => row.status.variant === 'warning').length;- if (warning > 0) {- return { variant: 'warning', label: `${warning} warning` };+ // Counts every row the Attention filter holds; the dot takes the worst.+ const attention = rows.filter((row) => attachmentGroupKey(row) === 'attention');+ if (attention.length > 0) {+ return {+ variant: attention.some((row) => row.status.variant === 'danger') ? 'danger' : 'warning',+ label: `${attention.length} ${attention.length === 1 ? 'needs' : 'need'} attention`,+ };}const running = rows.filter((row) => row.status.variant === 'success').length;if (running === rows.length) {@@ -207,6 +211,20 @@ const attachmentGroupKey = (row: DockerNetworkAttachmentRow): AttachmentGroupKeyreturn 'other';};+// Attention is Pulse's verdict on the row; Running and Other are Docker's run+// state. A container that is unhealthy or restarting too often while it runs+// is both running and worth a look, so it matches the Running filter as well+// as Attention. The sections below stay one per row: Attention first.+const attachmentMatchesStatus = (+ row: DockerNetworkAttachmentRow,+ status: AttachmentStatusFilter,+): boolean => {+ if (status === 'all') return true;+ if (status === 'attention') return attachmentGroupKey(row) === 'attention';+ const running = dockerContainerRunState(row.resource) === 'running';+ return status === 'running' ? running : !running;+};+const filterAttachmentRows = (rows: DockerNetworkAttachmentRow[],search: string,@@ -214,7 +232,7 @@ const filterAttachmentRows = (): DockerNetworkAttachmentRow[] => {const needle = search.trim().toLowerCase();return rows.filter((row) => {- if (status !== 'all' && attachmentGroupKey(row) !== status) return false;+ if (!attachmentMatchesStatus(row, status)) return false;if (!needle) return true;return row.searchText.includes(needle);});@@ -265,12 +283,7 @@ const AttachmentDetail: Component<{ rows: readonly DockerNetworkAttachmentRow[]const hiddenRowCount = createMemo(() =>Math.max(tableState.filtered().length - visibleRows().length, 0),);- const filteredSummary = createMemo(() => {- if (!tableState.hasActiveFilters()) return attachmentCountLabel(tableState.total());- return `${attachmentPlainCountLabel(tableState.visible())} of ${attachmentPlainCountLabel(- tableState.total(),- )}`;- });+const setSearch = (value: string) => {tableState.setSearch(value);setShowAll(false);@@ -284,7 +297,7 @@ const AttachmentDetail: Component<{ rows: readonly DockerNetworkAttachmentRow[]<section class="min-w-0"><div class="mb-2 flex items-center justify-between gap-2"><h3 class="text-xs font-semibold text-base-content">Attached containers</h3>- <span class="text-[11px] text-muted">{filteredSummary()}</span>+ <span class="text-[11px] text-muted">{attachmentCountLabel(tableState.total())}</span></div><Showwhen={props.rows.length > 0}@@ -420,8 +433,8 @@ export const DockerNetworksTable: Component<DockerNetworksTableProps> = (props)const layout = createMemo(() =>getPlatformTableContainerLayout(observedWidth.width() ?? 1920, [480, 720, 960, 1200]),);- const showSubnet = () => true;- const showDriver = () => true;+ const showSubnet = createMemo(() => layout() !== 'compact');+ const showDriver = createMemo(() => layout() !== 'compact');const showHost = createMemo(() => layout() === 'full');const columnWidthClass = (column: DockerNetworkColumn) =>DOCKER_NETWORK_COLUMN_WIDTH_CLASS[layout()][column];@@ -498,7 +511,7 @@ export const DockerNetworksTable: Component<DockerNetworksTableProps> = (props)</Show><Show when={showDriver()}><TableHead- class={`${getPlatformTableHeadClassForKind('text')} platform-table-phone-hidden ${columnWidthClass('driver')}`}+ class={`${getPlatformTableHeadClassForKind('text')} ${columnWidthClass('driver')}`}>Driver</TableHead>@@ -567,7 +580,7 @@ export const DockerNetworksTable: Component<DockerNetworksTableProps> = (props)</TableCell><Show when={showSubnet()}><TableCell- class={`${getPlatformTableCellClassForKind('text')} platform-table-phone-hidden text-base-content`}+ class={`${getPlatformTableCellClassForKind('text')} text-base-content`}><span class="block truncate" title={subnets()}>{subnets()}diff --git a/frontend-modern/src/features/docker/__tests__/DockerNativeTables.test.tsx b/frontend-modern/src/features/docker/__tests__/DockerNativeTables.test.tsxindex 3241ddd9f0..d7c84a24bb 100644--- a/frontend-modern/src/features/docker/__tests__/DockerNativeTables.test.tsx+++ b/frontend-modern/src/features/docker/__tests__/DockerNativeTables.test.tsx@@ -1776,6 +1776,10 @@ describe('Docker native tables', () => {),).toBeInTheDocument();+ // The network's state counts every container the Attention filter holds,+ // the restarting warning as well as the unhealthy one.+ expect(screen.getAllByText('2 need attention').length).toBeGreaterThan(0);+fireEvent.click(document.querySelector('[data-docker-network-row="network-dense"]')!);const detail = within(@@ -1792,17 +1796,31 @@ describe('Docker native tables', () => {expect(detail.getByText('Show first 24')).toBeInTheDocument();fireEvent.click(detail.getByRole('button', { name: /^Attention, \d+$/ }));- expect(detail.getByText('2 containers of 30 containers')).toBeInTheDocument();+ expect(detail.getAllByText('2 of 30 containers').length).toBeGreaterThan(0);expect(detail.getByText('api-unhealthy')).toBeInTheDocument();expect(detail.getByText('api-restarting')).toBeInTheDocument();expect(detail.queryByText('worker-29')).toBeNull();+ // Running is Docker's run state: the unhealthy container still runs, so it+ // matches Running too, listed under its Attention section.+ fireEvent.click(detail.getByRole('button', { name: /^Running, 28$/ }));+ expect(detail.getAllByText('28 of 30 containers').length).toBeGreaterThan(0);+ expect(detail.getByText('api-unhealthy')).toBeInTheDocument();+ expect(detail.getByText('Needs operator review')).toBeInTheDocument();+ expect(detail.queryByText('api-restarting')).toBeNull();+ expect(detail.queryByText('worker-stopped')).toBeNull();++ fireEvent.click(detail.getByRole('button', { name: /^Other, 2$/ }));+ expect(detail.getByText('api-restarting')).toBeInTheDocument();+ expect(detail.getByText('worker-stopped')).toBeInTheDocument();+ expect(detail.queryByText('api-unhealthy')).toBeNull();+fireEvent.click(detail.getByRole('button', { name: /^All, \d+$/ }));fireEvent.input(detail.getByPlaceholderText('Search attached containers'), {target: { value: 'worker-29' },});- expect(detail.getByText('1 container of 30 containers')).toBeInTheDocument();+ expect(detail.getAllByText('1 of 30 containers').length).toBeGreaterThan(0);expect(detail.getByText('worker-29')).toBeInTheDocument();expect(detail.getByText('0.0.0.0:8029->80/tcp')).toBeInTheDocument();});