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, vi } from 'vitest';
import type { Resource } from '@/types/resource';
import {
getAvailabilityProbeMethodLabel,
getAvailabilityProbePresentation,
} from '@/utils/availabilityProbePresentation';
const makeAvailabilityResource = (overrides?: Partial<Resource>): Resource => ({
id: 'availability:mock-availability-mqtt-meter',
type: 'network-endpoint',
name: 'MQTT power meter',
displayName: 'MQTT power meter',
platformId: 'mock-availability-mqtt-meter',
platformType: 'availability',
sourceType: 'api',
status: 'online',
lastSeen: Date.now(),
availability: {
protocol: 'tcp',
port: 1883,
available: true,
latencyMillis: 7,
lastChecked: '2026-05-06T13:00:06Z',
},
platformData: { sources: ['availability'] },
...overrides,
});
describe('availabilityProbePresentation', () => {
it('labels ICMP by protocol so the system badge and probe detail agree', () => {
expect(getAvailabilityProbeMethodLabel({ protocol: 'icmp' })).toBe('ICMP');
});
it('builds compact row evidence for a successful TCP availability probe', () => {
vi.spyOn(Date, 'now').mockReturnValue(new Date('2026-05-06T13:00:20Z').getTime());
const presentation = getAvailabilityProbePresentation(makeAvailabilityResource());
expect(presentation).toMatchObject({
methodLabel: 'TCP 1883',
targetLabel: '1883',
resultLabel: '7 ms',
netIoLabel: '1883: 7 ms',
rowLabel: '1883: 7 ms - checked 14s ago',
});
expect(presentation?.detailLabel).toContain('TCP 1883 - 7 ms');
expect(presentation?.toneClassName).toContain('emerald');
});
it('presents open-or-filtered UDP as indeterminate rather than reachable', () => {
vi.spyOn(Date, 'now').mockReturnValue(new Date('2026-05-06T13:00:20Z').getTime());
const presentation = getAvailabilityProbePresentation(
makeAvailabilityResource({
status: 'warning',
availability: {
protocol: 'udp',
port: 514,
available: false,
probeOutcome: 'indeterminate',
udpMode: 'open_or_filtered',
lastChecked: '2026-05-06T13:00:18Z',
},
}),
);
expect(presentation).toMatchObject({
methodLabel: 'UDP 514',
targetLabel: '514',
resultLabel: 'open or filtered',
netIoLabel: '514: open or filtered',
});
expect(presentation?.toneClassName).toContain('amber');
});
it('also reads availability evidence from platform data for live state rows', () => {
vi.spyOn(Date, 'now').mockReturnValue(new Date('2026-05-06T13:00:20Z').getTime());
const presentation = getAvailabilityProbePresentation(
makeAvailabilityResource({
availability: undefined,
platformData: {
sources: ['availability'],
availability: {
protocol: 'tcp',
port: 6053,
available: true,
latencyMillis: 11,
lastChecked: '2026-05-06T13:00:15Z',
},
},
}),
);
expect(presentation).toMatchObject({
methodLabel: 'TCP 6053',
targetLabel: '6053',
resultLabel: '11 ms',
netIoLabel: '6053: 11 ms',
rowLabel: '6053: 11 ms - checked 5s ago',
});
});
it('keeps failure evidence visible without exposing a full error as the row label', () => {
vi.spyOn(Date, 'now').mockReturnValue(new Date('2026-05-06T13:00:20Z').getTime());
const presentation = getAvailabilityProbePresentation(
makeAvailabilityResource({
status: 'offline',
availability: {
protocol: 'icmp',
available: false,
lastChecked: '2026-05-06T13:00:09Z',
lastSuccess: '2026-05-06T12:51:20Z',
consecutiveFailures: 3,
failureThreshold: 2,
lastError: 'icmp probe timed out',
},
}),
);
expect(presentation).toMatchObject({
methodLabel: 'ICMP',
targetLabel: null,
resultLabel: 'timed out',
netIoLabel: 'timed out',
rowLabel: 'timed out - checked 11s ago',
});
expect(presentation?.detailLabel).toContain('3/2 failures');
expect(presentation?.detailLabel).toContain('icmp probe timed out');
expect(presentation?.toneClassName).toContain('red');
});
it('uses the HTTP path as the network evidence target without repeating the protocol', () => {
vi.spyOn(Date, 'now').mockReturnValue(new Date('2026-05-06T13:00:20Z').getTime());
const presentation = getAvailabilityProbePresentation(
makeAvailabilityResource({
status: 'degraded',
availability: {
protocol: 'http',
path: '/status',
available: false,
lastChecked: '2026-05-06T13:00:02Z',
consecutiveFailures: 1,
failureThreshold: 2,
lastError: 'http probe returned 503 Service Unavailable',
},
}),
);
expect(presentation).toMatchObject({
methodLabel: 'HTTP /status',
targetLabel: '/status',
resultLabel: '503',
netIoLabel: '/status: 503',
rowLabel: '/status: 503 - checked 18s ago',
});
expect(presentation?.detailLabel).toContain('HTTP /status - 503');
expect(presentation?.detailLabel).toContain('http probe returned 503 Service Unavailable');
});
it('returns a presentation for a non-endpoint resource carrying an availability facet', () => {
vi.spyOn(Date, 'now').mockReturnValue(new Date('2026-05-06T13:00:20Z').getTime());
const presentation = getAvailabilityProbePresentation(
makeAvailabilityResource({
id: 'vm:100',
type: 'vm',
platformType: 'proxmox-pve',
platformId: 'proxmox-ve',
sourceType: 'agent',
status: 'online',
availability: {
protocol: 'icmp',
available: true,
latencyMillis: 3,
lastChecked: '2026-05-06T13:00:18Z',
},
platformData: {},
}),
);
expect(presentation).not.toBeNull();
expect(presentation?.methodLabel).toBe('ICMP');
expect(presentation?.resultLabel).toBe('3 ms');
expect(presentation?.toneClassName).toContain('emerald');
});
it('keeps freshness independent from a successful probe result', () => {
const now = new Date('2026-05-06T13:05:00Z');
const presentation = getAvailabilityProbePresentation(
makeAvailabilityResource({
availability: {
protocol: 'icmp',
available: true,
latencyMillis: 3,
lastChecked: '2026-05-06T13:00:00Z',
evidence: {
id: 'evidence-1',
source: { provider: 'availability', collector: 'availability-poller' },
subject: { resourceId: 'vm:100' },
observedAt: '2026-05-06T13:00:00Z',
ingestedAt: '2026-05-06T13:00:00Z',
validUntil: '2026-05-06T13:02:00Z',
completeness: 'complete',
confidence: 'confirmed',
permissions: 'sufficient',
},
},
}),
now,
);
expect(presentation).toMatchObject({
resultLabel: '3 ms',
freshnessLabel: 'stale',
});
expect(presentation?.detailLabel).toContain('stale');
expect(presentation?.toneClassName).toContain('amber');
});
it('names ambiguous resource identity without presenting it as an attachment', () => {
const presentation = getAvailabilityProbePresentation(
makeAvailabilityResource({
availability: {
protocol: 'icmp',
available: true,
correlationState: 'ambiguous',
correlationCandidates: 2,
},
}),
);
expect(presentation?.correlationLabel).toBe('2 possible resource matches');
expect(presentation?.detailLabel).toContain('2 possible resource matches');
expect(presentation?.toneClassName).toContain('amber');
});
});
it('measures all probe ages from the supplied clock rather than Date.now', () => {
const clock = new Date('2026-10-10T12:02:00Z');
const probe = getAvailabilityProbePresentation(
makeAvailabilityResource({
availability: {
protocol: 'https',
available: false,
lastChecked: '2026-10-10T12:01:00Z',
lastSuccess: '2026-10-10T12:00:00Z',
},
}),
clock,
);
expect(probe?.detailLabel).toContain('checked 1 min ago');
expect(probe?.detailLabel).toContain('last success 2 mins ago');
});