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 { createSignal } from 'solid-js';
import {
ConnectionsAPI,
type ConnectionType,
type ProbeCandidate,
type ProbeResponse,
} from '@/api/connections';
import { getInfrastructureOnboardingProductPresentation } from '@/utils/infrastructureOnboardingPresentation';
const PROBE_ERROR_FALLBACK = 'Probe failed. Try again or enter credentials manually.';
function describeProbeError(error: unknown): string {
if (error instanceof Error && error.message) {
return error.message;
}
if (typeof error === 'string' && error.trim().length > 0) {
return error.trim();
}
return PROBE_ERROR_FALLBACK;
}
export type ProbePhase = 'idle' | 'probing' | 'detected' | 'no-match' | 'error';
export type CompletedProbePhase = Extract<ProbePhase, 'detected' | 'no-match' | 'error'>;
export interface ConnectionEditorState {
address: () => string;
setAddress: (value: string) => void;
phase: () => ProbePhase;
candidates: () => ProbeCandidate[];
probedMs: () => number;
errorMessage: () => string;
reset: () => void;
runProbe: () => Promise<CompletedProbePhase>;
}
// CONNECTION_TYPE_LABELS drives both the detected-candidate header copy and
// the manual fallback menu. Keeping one table avoids drift between probe
// results and the manual route labels.
export const CONNECTION_TYPE_LABELS: Record<ConnectionType, string> = {
pve: 'Proxmox VE',
pbs: 'Proxmox Backup Server',
pmg: 'Proxmox Mail Gateway',
vmware: getInfrastructureOnboardingProductPresentation('vmware').label,
truenas: getInfrastructureOnboardingProductPresentation('truenas').label,
availability: getInfrastructureOnboardingProductPresentation('availability').label,
agent: 'Pulse Agent',
docker: 'Docker',
kubernetes: 'Kubernetes',
};
// Validation on the client side is intentionally lenient: the backend is the
// real authority on what constitutes a probeable address. We only reject the
// obviously empty case so the API does not see a payload it will always
// refuse.
function isSubmittableAddress(address: string): boolean {
return address.trim().length > 0;
}
export function createConnectionEditorState(): ConnectionEditorState {
const [address, setAddress] = createSignal('');
const [phase, setPhase] = createSignal<ProbePhase>('idle');
const [candidates, setCandidates] = createSignal<ProbeCandidate[]>([]);
const [probedMs, setProbedMs] = createSignal(0);
const [errorMessage, setErrorMessage] = createSignal('');
const reset = () => {
setAddress('');
setPhase('idle');
setCandidates([]);
setProbedMs(0);
setErrorMessage('');
};
const runProbe = async () => {
const value = address().trim();
if (!isSubmittableAddress(value)) {
setErrorMessage('Enter an API endpoint to probe.');
setPhase('error');
return 'error';
}
setPhase('probing');
setErrorMessage('');
setCandidates([]);
setProbedMs(0);
let response: ProbeResponse;
try {
response = await ConnectionsAPI.probe(value);
} catch (error: unknown) {
setErrorMessage(describeProbeError(error));
setPhase('error');
return 'error';
}
setProbedMs(response.probedMs);
setCandidates(response.candidates);
const nextPhase: CompletedProbePhase = response.candidates.length > 0 ? 'detected' : 'no-match';
setPhase(nextPhase);
return nextPhase;
};
return {
address,
setAddress,
phase,
candidates,
probedMs,
errorMessage,
reset,
runProbe,
};
}