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 { toReportingResourceType } from '@/utils/reportingResourceTypes';
import { formatReportingFilenameDate } from '@/utils/reportingPresentation';
import type { SelectedResource } from '@/components/Settings/ResourcePicker';
import type {
ReportingFormat,
ReportingPerformanceReportDefinition,
} from '@/components/Settings/reportingCatalogModel';
export type ReportingRangeValue = string;
export interface ReportingRequestContext {
end: string;
format: ReportingFormat;
metricType: string;
now: Date;
resources: SelectedResource[];
start: string;
title: string;
}
export interface ReportingRequestDefinition {
filename: string;
request: {
init?: {
body?: string;
headers?: Record<string, string>;
method?: string;
};
url: string;
};
}
export function getReportingRangeStart(
range: ReportingRangeValue,
now: Date,
definition: Pick<ReportingPerformanceReportDefinition, 'defaultRange' | 'ranges'>,
): Date {
const start = new Date(now);
const resolvedRange =
definition.ranges.find((candidate) => candidate.key === range) ??
definition.ranges.find((candidate) => candidate.key === definition.defaultRange);
if (!resolvedRange) {
throw new Error('Invalid reporting range definition');
}
start.setHours(start.getHours() - resolvedRange.windowHours);
return start;
}
export function buildReportingFilename(
format: ReportingFormat,
resourceID: string | null,
now: Date,
definition: Pick<
ReportingPerformanceReportDefinition,
'filenameDateStyle' | 'multiFilenamePrefix' | 'singleFilenamePrefix' | 'singleFilenameSubject'
>,
): string {
const date = formatReportingFilenameDate(now, definition.filenameDateStyle);
if (resourceID) {
return `${definition.singleFilenamePrefix}-${sanitizeReportingFilenameSubject(resourceID, definition.singleFilenameSubject)}-${date}.${format}`;
}
return `${definition.multiFilenamePrefix}-${date}.${format}`;
}
function sanitizeReportingFilenameSubject(
value: string,
subject: Pick<
ReportingPerformanceReportDefinition,
'singleFilenameSubject'
>['singleFilenameSubject'],
): string {
switch (subject) {
case 'resource_id': {
let sanitized = value;
sanitized = sanitized.replace(/"/g, '');
sanitized = sanitized.replace(/\\/g, '');
sanitized = sanitized.replace(/\//g, '-');
sanitized = sanitized.replace(/:/g, '-');
sanitized = sanitized.replace(/\r/g, '');
sanitized = sanitized.replace(/\n/g, '');
if (sanitized.length > 64) {
sanitized = sanitized.slice(0, 64);
}
return sanitized;
}
}
}
export function buildReportingRequest(
context: ReportingRequestContext,
definition: Pick<
ReportingPerformanceReportDefinition,
| 'multiFilenamePrefix'
| 'multiResourceEndpoint'
| 'filenameDateStyle'
| 'singleFilenamePrefix'
| 'singleFilenameSubject'
| 'singleResourceEndpoint'
| 'singleResourceMethod'
| 'supportsCustomTitle'
| 'supportsMetricFilter'
>,
): ReportingRequestDefinition {
const metricType = definition.supportsMetricFilter === false ? '' : context.metricType.trim();
const customTitle = definition.supportsCustomTitle === false ? '' : context.title.trim();
if (context.resources.length === 1) {
const resource = context.resources[0];
const fields = {
resourceType: toReportingResourceType(resource.type),
resourceId: resource.id,
format: context.format,
start: context.start,
end: context.end,
title: customTitle || undefined,
metricType: metricType || undefined,
};
const filename = buildReportingFilename(context.format, resource.id, context.now, definition);
// Only POST may narrate a PDF with AI; the catalog names
// GET only for backends that accept nothing else.
if (definition.singleResourceMethod === 'POST') {
return {
filename,
request: {
url: definition.singleResourceEndpoint,
init: {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(fields),
},
},
};
}
const params = new URLSearchParams();
for (const [key, value] of Object.entries(fields)) {
if (value) {
params.append(key, value);
}
}
return {
filename,
request: {
url: `${definition.singleResourceEndpoint}?${params.toString()}`,
},
};
}
return {
filename: buildReportingFilename(context.format, null, context.now, definition),
request: {
url: definition.multiResourceEndpoint,
init: {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
resources: context.resources.map((resource) => ({
resourceType: toReportingResourceType(resource.type),
resourceId: resource.id,
})),
format: context.format,
start: context.start,
end: context.end,
title: customTitle || undefined,
metricType: metricType || undefined,
}),
},
},
};
}