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 type { Resource } from '@/types/resource';
export {
compareAgentVersions,
formatAgentVersionDisplay,
parseAgentVersion,
type ParsedAgentVersion,
} from '@/utils/agentVersion';
import {
compareAgentVersions,
formatAgentVersionDisplay,
parseAgentVersion,
} from '@/utils/agentVersion';
// Agent staleness helpers for platform pages.
//
// Platform pages gate their detail tabs (Docker images/networks/storage/swarm,
// and the equivalent on other runtimes) purely on whether the matching
// inventory is present in the resource snapshot. An agent that predates a given
// inventory feature simply never reports it, so those tabs silently disappear
// with no way for the user to tell "this host genuinely has none" from "this
// host's agent is too old to report it". These helpers let a page detect the
// second case by comparing each host's reported agent version against the
// server that is rendering the page.
const isKubernetesPlatformRow = (host: Resource): boolean =>
host.type === 'k8s-node' ||
host.type === 'k8s-cluster' ||
host.platformType === 'kubernetes' ||
host.sources?.includes('kubernetes') === true;
// The agent version reported for a host. Docker hosts carry it on the docker
// meta; Kubernetes platform rows carry the cluster agent version on the
// kubernetes meta; plain host agents carry it on the agent meta.
export function hostAgentVersion(host: Resource): string | undefined {
const kubernetesAgentVersion = host.kubernetes?.agentVersion?.trim();
if (kubernetesAgentVersion && isKubernetesPlatformRow(host)) {
return kubernetesAgentVersion;
}
return (
host.docker?.agentVersion?.trim() ||
host.agent?.agentVersion?.trim() ||
kubernetesAgentVersion ||
undefined
);
}
export function hostAgentConnectionID(host: Resource): string | undefined {
if (isKubernetesPlatformRow(host)) {
const kubernetesAgentId = host.kubernetes?.agentId?.trim();
if (kubernetesAgentId) {
return kubernetesAgentId.startsWith('agent:')
? kubernetesAgentId
: `agent:${kubernetesAgentId}`;
}
}
const agentId =
host.agent?.agentId?.trim() ||
host.kubernetes?.agentId?.trim() ||
(host.type === 'agent' ? host.id?.trim() : '');
if (!agentId) return undefined;
return agentId.startsWith('agent:') ? agentId : `agent:${agentId}`;
}
export type OutdatedAgentHost = { name: string; version: string; agentId?: string };
// Hosts whose agent version is strictly behind the server version. Hosts with
// no reported version (or an unparseable one) are skipped rather than flagged,
// so we never raise a false alarm we cannot substantiate. Returns an empty list
// when the server version itself is unknown or unparseable (e.g. a build that
// does not report one), so a page never nags without a basis for comparison.
export function collectOutdatedAgentHosts(
hosts: Resource[],
serverVersion?: string | null,
): OutdatedAgentHost[] {
if (!parseAgentVersion(serverVersion)) return [];
const outdated: OutdatedAgentHost[] = [];
for (const host of hosts) {
// A provider-backed host can remain online after its Pulse Agent stops
// reporting. The unified-resource adapter deliberately retains the last
// agent version for diagnosis and marks that facet stale. Do not describe
// that retained value as an agent that "is running" an older release;
// Agent Doctor owns the separate non-reporting-agent diagnosis.
if (host.agent?.stale === true) continue;
const version = hostAgentVersion(host);
if (!version) continue;
const cmp = compareAgentVersions(version, serverVersion);
if (cmp !== null && cmp < 0) {
const outdatedHost: OutdatedAgentHost = {
name: host.name?.trim() || host.id || 'host',
version: formatAgentVersionDisplay(version),
};
const agentId = hostAgentConnectionID(host);
if (agentId) {
outdatedHost.agentId = agentId;
}
outdated.push(outdatedHost);
}
}
return outdated;
}