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 { Disk } from '@/types/api';
import { formatBytes } from '@/utils/format';
import { getMetricColorClass } from '@/utils/metricThresholds';
import type { MetricDisplayThresholds } from '@/utils/metricThresholds';
export interface DiskListProps {
disks: Disk[];
diskStatusReason?: string;
thresholds?: MetricDisplayThresholds | null;
}
export interface WorkloadsDiskPresentation {
key: string;
label: string;
labelTitle?: string;
progressClass: string;
progressValue: number | null;
progressWidth: string;
typeLabel: string;
usageText: string;
usagePercentLabel: string;
}
export const hasWorkloadsDiskCapacity = (disk: Disk): disk is Disk & { total: number } =>
typeof disk.total === 'number' && Number.isFinite(disk.total) && disk.total > 0;
// The poller reports usage -1 for mounts it can only see in the container
// config (capacity may be known, live usage is not).
export const isWorkloadsDiskUsageUnknown = (disk: Disk): boolean =>
typeof disk.used !== 'number' ||
!Number.isFinite(disk.used) ||
disk.used < 0 ||
(typeof disk.usage === 'number' && (!Number.isFinite(disk.usage) || disk.usage < 0));
// Capacity alone is not a measurement. In particular, an omitted `used`
// field must not become a healthy empty filesystem, even if usage/free exist.
export const getWorkloadsDiskUsagePercent = (disk: Disk): number | null => {
const { total, used } = disk;
if (
!hasWorkloadsDiskCapacity(disk) ||
isWorkloadsDiskUsageUnknown(disk) ||
typeof total !== 'number' ||
typeof used !== 'number'
) {
return null;
}
const percent = (used / total) * 100;
return Number.isFinite(percent) ? percent : null;
};
export const getWorkloadsDiskLabel = (disk: Disk): string =>
disk.mountpoint || disk.device || 'Unknown';
export const getWorkloadsDiskLabelTitle = (label: string): string | undefined =>
label !== 'Unknown' ? label : undefined;
export const getWorkloadsDiskUsageText = (disk: Disk): string => {
if (!hasWorkloadsDiskCapacity(disk)) return 'Usage unavailable';
const used =
getWorkloadsDiskUsagePercent(disk) === null || typeof disk.used !== 'number'
? '?'
: formatBytes(disk.used);
return `${used}/${formatBytes(disk.total)}`;
};
export const getWorkloadsDiskUsagePercentLabel = (disk: Disk): string => {
const percent = getWorkloadsDiskUsagePercent(disk);
return percent === null ? '—' : `${percent.toFixed(0)}%`;
};
export const getWorkloadsDiskProgressClass = (
disk: Disk,
thresholds?: MetricDisplayThresholds | null,
): string => {
const percent = getWorkloadsDiskUsagePercent(disk);
return percent === null ? 'bg-surface-hover' : getMetricColorClass(percent, 'disk', thresholds);
};
export const getWorkloadsDiskProgressValue = (disk: Disk): number | null =>
getWorkloadsDiskUsagePercent(disk);
export const getWorkloadsDiskProgressWidth = (disk: Disk): string => {
const percent = getWorkloadsDiskUsagePercent(disk);
return percent === null ? '0%' : `${Math.min(percent, 100)}%`;
};
export const getWorkloadsDiskTypeLabel = (disk: Disk): string => disk.type?.toUpperCase() ?? '';
export const buildWorkloadsDiskPresentation = (
disk: Disk,
index: number,
thresholds?: MetricDisplayThresholds | null,
readState: 'current' | 'last-known' | 'unavailable' = 'current',
): WorkloadsDiskPresentation => {
const label = getWorkloadsDiskLabel(disk);
// Retention preserves identity and capacity, not a current utilization
// measurement. Only an explicitly retained read may display old used bytes.
const reading = readState === 'unavailable' ? { ...disk, used: undefined } : disk;
const percentLabel = getWorkloadsDiskUsagePercentLabel(reading);
return {
key: `${disk.mountpoint ?? ''}:${disk.device ?? ''}:${index}`,
label,
labelTitle: getWorkloadsDiskLabelTitle(label),
progressClass:
readState === 'current'
? getWorkloadsDiskProgressClass(reading, thresholds)
: 'bg-surface-hover',
progressValue: readState === 'current' ? getWorkloadsDiskProgressValue(reading) : null,
progressWidth: readState === 'current' ? getWorkloadsDiskProgressWidth(reading) : '0%',
typeLabel: getWorkloadsDiskTypeLabel(disk),
usageText: getWorkloadsDiskUsageText(reading),
usagePercentLabel:
readState === 'current'
? percentLabel
: percentLabel === '—'
? 'Usage unavailable'
: `Last known ${percentLabel}`,
};
};