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.

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.md
index 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 shared
container 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 media
queries, so between a 34rem container and a 768px viewport the phone-hidden
columns return while no width applies, and every visible column took an equal
diff --git a/docs/release-control/v6/internal/subsystems/unified-resources.md b/docs/release-control/v6/internal/subsystems/unified-resources.md
index 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 a
single network has many attached containers, relationship consumers must keep
the attached container fields searchable and attention-filterable from the
network 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.cjs
index 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.tsx
index 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.json
new file mode 100644
index 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.tsx
index 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[]): string
const 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): AttachmentGroupKey
return '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>
<Show
when={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.tsx
index 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();
});