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
import { describe, expect, it } from 'vitest';
import type { Resource } from '@/types/resource';
import {
getPhysicalDiskNodeIdentity,
matchesPhysicalDiskNode,
resolvePhysicalDiskHistoryResourceId,
resolvePhysicalDiskMetricResourceId,
} from '@/components/Storage/diskResourceUtils';
const buildDisk = (overrides: Partial<Resource> = {}): Resource =>
({
id: 'disk-1',
type: 'physical_disk',
name: 'disk-1',
displayName: 'disk-1',
platformId: 'cluster-main',
platformType: 'proxmox-pve',
sourceType: 'api',
status: 'online',
lastSeen: Date.now(),
platformData: {
proxmox: { nodeName: 'tower', instance: 'cluster-main' },
physicalDisk: { devPath: '/dev/sda' },
},
identity: { hostname: 'tower' },
canonicalIdentity: { hostname: 'tower' },
...overrides,
}) as Resource;
const buildNode = (overrides: Partial<Resource> = {}): Resource =>
({
id: 'node-1',
type: 'agent',
name: 'tower',
displayName: 'tower',
platformId: 'cluster-main',
platformType: 'proxmox-pve',
sourceType: 'api',
status: 'online',
lastSeen: Date.now(),
platformData: {
proxmox: { instance: 'cluster-main' },
agent: { agentId: 'agent-tower' },
},
...overrides,
}) as Resource;
describe('diskResourceUtils', () => {
it('derives physical disk node identity canonically', () => {
expect(getPhysicalDiskNodeIdentity(buildDisk())).toEqual({
node: 'tower',
instance: 'cluster-main',
});
});
it('matches physical disks to nodes by canonical node identity', () => {
expect(
matchesPhysicalDiskNode(buildDisk(), {
id: 'node-1',
name: 'tower',
instance: 'cluster-main',
}),
).toBe(true);
expect(
matchesPhysicalDiskNode(buildDisk(), {
id: 'other-node-id',
name: 'tower',
instance: 'cluster-secondary',
}),
).toBe(false);
expect(
matchesPhysicalDiskNode(buildDisk(), {
id: 'other-node-id',
name: 'tower',
}),
).toBe(false);
expect(
matchesPhysicalDiskNode(
buildDisk({
platformData: { proxmox: { nodeName: 'tower' } } as any,
}),
{
id: 'legacy-node-id',
name: 'tower',
},
),
).toBe(true);
});
it('keeps agent-reported disks attached to their Proxmox node without instance evidence', () => {
// A host-agent SMART disk carries no Proxmox block at all, so it has no
// instance to compare against the PVE node it physically lives on.
const agentDisk = buildDisk({
platformId: 'agent-tower',
platformType: 'agent',
sourceType: 'agent',
platformData: { physicalDisk: { devPath: '/dev/sda' } } as never,
});
expect(
matchesPhysicalDiskNode(agentDisk, {
id: 'node-1',
name: 'tower',
instance: 'cluster-main',
}),
).toBe(true);
// Node identity still has to agree.
expect(
matchesPhysicalDiskNode(agentDisk, {
id: 'node-2',
name: 'other-node',
instance: 'cluster-main',
}),
).toBe(false);
});
it('resolves physical disk metric targets through linked agents when needed', () => {
expect(resolvePhysicalDiskMetricResourceId(buildDisk(), [buildNode()], '/dev/sda')).toBe(
'agent-tower:sda',
);
expect(
resolvePhysicalDiskMetricResourceId(
buildDisk({ metricsTarget: { resourceId: 'existing-target' } as any }),
[buildNode()],
'/dev/sda',
),
).toBe('existing-target');
});
it('resolves canonical physical disk history ids through metrics targets before raw hardware ids', () => {
expect(
resolvePhysicalDiskHistoryResourceId(
buildDisk({
metricsTarget: { resourceType: 'disk', resourceId: 'disk:truenas-main:sda' } as any,
physicalDisk: { serial: '', wwn: '' } as any,
platformData: {
physicalDisk: { serial: '', wwn: '' },
} as any,
}),
),
).toBe('disk:truenas-main:sda');
expect(
resolvePhysicalDiskHistoryResourceId(
buildDisk({
metricsTarget: undefined,
physicalDisk: { serial: 'SERIAL-1', wwn: '' } as any,
}),
),
).toBe('SERIAL-1');
expect(
resolvePhysicalDiskHistoryResourceId(
buildDisk({
metricsTarget: undefined,
physicalDisk: { serial: '', wwn: 'WWN-1' } as any,
}),
),
).toBe('WWN-1');
expect(
resolvePhysicalDiskHistoryResourceId(
buildDisk({
metricsTarget: undefined,
physicalDisk: { serial: '', wwn: '' } as any,
platformData: {
proxmox: { nodeName: 'tower', instance: 'cluster-main' },
physicalDisk: { serial: '', wwn: '' },
} as any,
}),
),
).toBe('disk-1');
});
});