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 { Show, createMemo, type Component, type JSX } from 'solid-js';
import { Button } from '@/components/shared/Button';
import { InlineNotice } from '@/components/shared/InlineNotice';
import { InlineDetailTableRow } from '@/components/shared/InlineDetailTableRow';
import { StatusDot } from '@/components/shared/StatusDot';
import { TableCell, TableRow } from '@/components/shared/Table';
import {
getRecoveryOutcomeBadgeClass,
getRecoveryOutcomeLabel,
normalizeRecoveryOutcome,
} from '@/utils/recoveryOutcomePresentation';
import { asTrimmedString } from '@/utils/stringUtils';
import { parseBackupTimestampMs } from '@/utils/backupTimestamp';
import type { StatusIndicatorVariant } from '@/utils/status';
import {
PlatformWindowedRows,
PlatformErrorState,
PlatformResponsiveTableLabel,
PlatformSortableTableHead,
PlatformTableDateTimeValue,
PlatformTableEmptyState,
PlatformTableLoadingState,
PlatformTableToolbar,
createPlatformTableFilterState,
createPlatformTableSortState,
formatPlatformTableBytesValue,
getPlatformTableCellClassForKind,
withPlatformStatusCounts,
type PlatformTableFilterOption,
type PlatformTableSortValue,
PlatformTableShell,
} from '@/features/platformPage/sharedPlatformPage';
import {
PlatformResourceDetailToggleButton,
createPlatformResourceDetailState,
getPlatformResourceDetailRowClass,
} from '@/features/platformPage/PlatformResourceDetailTableRow';
import type { RecoveryPoint } from '@/types/recovery';
import {
filterTrueNASProtectionPoints,
buildTrueNASProtectionPosture,
mapTrueNASProtectionKind,
mapTrueNASProtectionStatus,
sortTrueNASProtectionPoints,
type TrueNASProtectionKind,
type TrueNASProtectionStatusBucket,
type TrueNASProtectionStatusFilter,
} from './truenasPageModel';
import {
InlineDetailPanel,
compactDetailRows,
compactDetailSections,
makeDetailRow,
type DetailSection,
type DetailValueTone,
} from '@/components/shared/DetailSectionTable';
import { RecordOwnerLink } from '@/features/platformPage/RecordOwnerLink';
const TRUENAS_PROTECTION_STATUS_OPTIONS: PlatformTableFilterOption<TrueNASProtectionStatusFilter>[] =
[
{ value: 'all', label: 'All' },
{
value: 'attention',
label: 'Attention',
compactLabel: 'Issues',
tone: 'warning',
},
{ value: 'success', label: 'Healthy', compactLabel: 'OK', tone: 'success' },
{ value: 'warning', label: 'Warning', compactLabel: 'Warn', tone: 'warning' },
{ value: 'failed', label: 'Failed', compactLabel: 'Fail', tone: 'danger' },
{ value: 'running', label: 'Running', compactLabel: 'Run', tone: 'info' },
{ value: 'unknown', label: 'Unknown', compactLabel: 'Unk', tone: 'muted' },
];
const detailString = (point: RecoveryPoint, key: string): string =>
asTrimmedString(point.details?.[key]) || '';
const detailStringList = (point: RecoveryPoint, key: string): string[] => {
const value = point.details?.[key];
return Array.isArray(value)
? value.filter((item): item is string => typeof item === 'string' && item.trim().length > 0)
: [];
};
const kindLabel = (kind: TrueNASProtectionKind): string => {
if (kind === 'snapshot') return 'Snapshot';
if (kind === 'replication') return 'Replication';
return 'Protection';
};
const protectionVariant = (status: TrueNASProtectionStatusBucket): StatusIndicatorVariant => {
switch (status) {
case 'success':
return 'success';
case 'warning':
return 'warning';
case 'failed':
return 'danger';
case 'running':
case 'unknown':
return 'muted';
}
};
const datasetLabel = (point: RecoveryPoint): string =>
asTrimmedString(point.display?.itemLabel) ||
asTrimmedString(point.itemRef?.name) ||
detailString(point, 'dataset') ||
detailStringList(point, 'sourceDatasets')[0] ||
point.id;
const hostLabel = (point: RecoveryPoint): string =>
asTrimmedString(point.display?.nodeHostLabel) ||
asTrimmedString(point.display?.nodeAgentLabel) ||
asTrimmedString(point.display?.clusterLabel) ||
detailString(point, 'hostname') ||
asTrimmedString(point.node) ||
asTrimmedString(point.cluster) ||
'TrueNAS';
const artifactLabel = (point: RecoveryPoint): string => {
const kind = mapTrueNASProtectionKind(point);
if (kind === 'replication') {
return (
detailString(point, 'taskName') ||
asTrimmedString(point.display?.detailsSummary) ||
asTrimmedString(point.repositoryRef?.name) ||
'Replication task'
);
}
if (kind === 'snapshot') {
return (
detailString(point, 'snapshot') ||
detailString(point, 'fullName') ||
asTrimmedString(point.display?.detailsSummary) ||
'ZFS snapshot'
);
}
return asTrimmedString(point.display?.detailsSummary) || point.kind || 'Protection point';
};
const artifactSecondaryLabel = (point: RecoveryPoint): string => {
const kind = mapTrueNASProtectionKind(point);
if (kind === 'replication') {
return (
detailString(point, 'lastSnapshot') ||
detailString(point, 'lastState') ||
asTrimmedString(point.display?.detailsSummary) ||
''
);
}
if (kind === 'snapshot') {
const fullName = detailString(point, 'fullName');
const snapshot = detailString(point, 'snapshot');
return fullName && fullName !== snapshot ? fullName : '';
}
return '';
};
const targetLabel = (point: RecoveryPoint): string => {
if (mapTrueNASProtectionKind(point) === 'snapshot') return 'Local ZFS';
return (
asTrimmedString(point.display?.repositoryLabel) ||
detailString(point, 'targetDataset') ||
asTrimmedString(point.repositoryRef?.name) ||
'-'
);
};
const targetSecondaryLabel = (point: RecoveryPoint): string => {
if (mapTrueNASProtectionKind(point) === 'snapshot') return datasetLabel(point);
const direction = detailString(point, 'direction');
const state = detailString(point, 'lastState');
return [direction, state].filter(Boolean).join(' / ');
};
const sizeLabel = (point: RecoveryPoint): string =>
formatPlatformTableBytesValue(point.sizeBytes ?? undefined, '-');
// A start is not a finish. Running replication can also retain a last-run
// timestamp in completedAt, which is not completion of the active run.
const completionTimestamp = (point: RecoveryPoint): string | undefined =>
normalizeRecoveryOutcome(point.outcome) === 'running' ? '' : asTrimmedString(point.completedAt);
// Columns a user can sort by. Every protection column carries a scalar:
// Completed orders chronologically and Size on raw bytes, both newest/biggest
// first on the first click.
const TRUENAS_PROTECTION_SORT_KEYS = [
'dataset',
'artifact',
'target',
'completed',
'size',
'outcome',
] as const;
type TrueNASProtectionSortKey = (typeof TRUENAS_PROTECTION_SORT_KEYS)[number];
const getTrueNASProtectionSortValue = (
point: RecoveryPoint,
key: TrueNASProtectionSortKey,
): PlatformTableSortValue => {
switch (key) {
case 'dataset':
return datasetLabel(point);
case 'artifact':
return artifactLabel(point);
case 'target': {
const target = targetLabel(point);
return target === '-' ? null : target;
}
case 'completed':
return parseBackupTimestampMs(completionTimestamp(point)) ?? null;
case 'size':
return typeof point.sizeBytes === 'number' && Number.isFinite(point.sizeBytes)
? point.sizeBytes
: null;
case 'outcome':
return getRecoveryOutcomeLabel(normalizeRecoveryOutcome(point.outcome));
default:
key satisfies never;
return null;
}
};
type ProtectionDetailTone = DetailValueTone;
type ProtectionDetailSection = DetailSection;
const detailBool = (value?: boolean | null): string | null => {
if (value == null) return null;
return value ? 'Yes' : 'No';
};
const detailDateTime = (value?: string | null): string | null => {
const raw = asTrimmedString(value);
if (!raw) return null;
const timestamp = parseBackupTimestampMs(raw);
// Keep malformed evidence inspectable without letting Date repair its
// calendar or invent a browser-local zone. It is not an observed instant.
if (timestamp === undefined) return `Unknown date (${raw})`;
return new Date(timestamp).toLocaleString(undefined, {
month: 'short',
day: 'numeric',
year: 'numeric',
hour: '2-digit',
minute: '2-digit',
});
};
const detailRow = makeDetailRow;
const outcomeTone = (point: RecoveryPoint): ProtectionDetailTone => {
const outcome = normalizeRecoveryOutcome(point.outcome);
if (outcome === 'success') return 'success';
if (outcome === 'running') return 'muted';
if (outcome === 'failed') return 'danger';
if (outcome === 'warning') return 'warning';
return 'default';
};
const sourceDatasetsLabel = (point: RecoveryPoint): string | null => {
const datasets = detailStringList(point, 'sourceDatasets');
return datasets.length > 0 ? datasets.join(', ') : null;
};
const buildProtectionDetailSections = (point: RecoveryPoint): ProtectionDetailSection[] => {
const kind = mapTrueNASProtectionKind(point);
const target = targetLabel(point);
const targetSecondary = targetSecondaryLabel(point);
const summaryRows = compactDetailRows([
detailRow('Kind', kindLabel(kind)),
detailRow('Outcome', getRecoveryOutcomeLabel(normalizeRecoveryOutcome(point.outcome)), {
tone: outcomeTone(point),
}),
detailRow('Dataset', datasetLabel(point)),
detailRow('Host', hostLabel(point)),
detailRow('Started', detailDateTime(point.startedAt)),
detailRow('Completed', detailDateTime(completionTimestamp(point))),
detailRow('Size', sizeLabel(point)),
detailRow('Verified', detailBool(point.verified)),
detailRow('Encrypted', detailBool(point.encrypted)),
detailRow('Immutable', detailBool(point.immutable)),
]);
const artifactRows = compactDetailRows([
detailRow('Artifact', artifactLabel(point)),
detailRow('Summary', asTrimmedString(point.display?.detailsSummary)),
detailRow('Full name', detailString(point, 'fullName')),
detailRow('Snapshot', detailString(point, 'snapshot')),
detailRow('Last snapshot', detailString(point, 'lastSnapshot')),
detailRow('Task name', detailString(point, 'taskName')),
detailRow('Task ID', detailString(point, 'taskId') || detailString(point, 'upid')),
]);
const targetRows = compactDetailRows([
detailRow('Target', target === 'Local ZFS' ? target : target || null),
detailRow('Target detail', targetSecondary),
detailRow('Direction', detailString(point, 'direction')),
detailRow('Last state', detailString(point, 'lastState'), {
tone: detailString(point, 'lastState').toLowerCase() === 'running' ? 'muted' : 'default',
}),
detailRow('Source datasets', sourceDatasetsLabel(point)),
detailRow('Target dataset', detailString(point, 'targetDataset')),
detailRow('Repository', asTrimmedString(point.repositoryRef?.name)),
]);
return compactDetailSections([
{ label: 'Protection', rows: summaryRows },
{ label: kind === 'replication' ? 'Replication' : 'Snapshot', rows: artifactRows },
{ label: 'Target', rows: targetRows },
]);
};
const DatasetCell: Component<{ point: RecoveryPoint; detailToggle?: JSX.Element }> = (props) => {
const status = () => mapTrueNASProtectionStatus(props.point);
const kind = () => mapTrueNASProtectionKind(props.point);
const name = () => datasetLabel(props.point);
const subtitle = () => `${kindLabel(kind())} on ${hostLabel(props.point)}`;
return (
<div class="flex min-w-0 items-center gap-2">
{props.detailToggle}
<StatusDot
size="sm"
variant={protectionVariant(status())}
pulse={status() === 'running'}
title={getRecoveryOutcomeLabel(normalizeRecoveryOutcome(props.point.outcome))}
/>
<div class="min-w-0">
<div
class="truncate font-medium text-base-content"
title={[name(), subtitle()].filter(Boolean).join(' · ')}
>
{name()}
</div>
</div>
</div>
);
};
const ProtectionDetailTable: Component<{ point: RecoveryPoint; onClose: () => void }> = (props) => (
<InlineDetailPanel
testId="truenas-protection-detail"
detailFor={props.point.id}
title={datasetLabel(props.point)}
status={{
variant: protectionVariant(mapTrueNASProtectionStatus(props.point)),
label: getRecoveryOutcomeLabel(normalizeRecoveryOutcome(props.point.outcome)),
}}
summary={`${kindLabel(mapTrueNASProtectionKind(props.point))} on ${hostLabel(props.point)}`}
actions={
<RecordOwnerLink
subject={{
id: asTrimmedString(props.point.itemRef?.id) || datasetLabel(props.point),
name: datasetLabel(props.point),
type: 'truenas-dataset',
}}
/>
}
sections={buildProtectionDetailSections(props.point)}
detailAttributes={{ 'data-truenas-protection-detail-for': props.point.id }}
onClose={props.onClose}
/>
);
export const TrueNASProtectionTable: Component<{
points: RecoveryPoint[];
loading?: boolean;
error?: unknown;
onRefresh?: () => void;
emptyIcon: JSX.Element;
emptyTitle: string;
emptyDescription: string;
showToolbar?: boolean;
/** The page's URL search, when it owns one; the table then reads and writes it. */
search?: () => string;
onSearchChange?: (value: string) => void;
}> = (props) => {
const rows = createMemo(() => sortTrueNASProtectionPoints(props.points));
const posture = createMemo(() => buildTrueNASProtectionPosture(rows()));
const detail = createPlatformResourceDetailState({ idPrefix: 'truenas-protection-detail' });
const tableState = createPlatformTableFilterState({
resources: rows,
initialStatus: 'all' as TrueNASProtectionStatusFilter,
filter: filterTrueNASProtectionPoints,
externalSearch: props.search,
onExternalSearchChange: props.onSearchChange,
});
const statusOptions = createMemo(() =>
withPlatformStatusCounts(TRUENAS_PROTECTION_STATUS_OPTIONS, tableState.countForStatus, {
value: 'attention',
tone: posture().failed > 0 ? 'danger' : 'warning',
}),
);
const sort = createPlatformTableSortState({
storageKey: 'truenasProtection',
sortKeys: TRUENAS_PROTECTION_SORT_KEYS,
descendingFirst: ['completed', 'size'],
});
const sortedRows = createMemo(() =>
sort.sortRows(tableState.filtered(), getTrueNASProtectionSortValue),
);
return (
<Show
when={!props.loading || rows().length > 0}
fallback={
<PlatformTableLoadingState
title="Loading TrueNAS protection"
description="Pulse is loading ZFS snapshot and replication activity."
/>
}
>
<Show
when={!props.error || rows().length > 0}
fallback={
<PlatformErrorState
title="Could not load TrueNAS protection"
description="Refresh the recovery point snapshot or check the API connection state."
onRefresh={() => props.onRefresh?.()}
/>
}
>
<Show
when={rows().length > 0}
fallback={
<PlatformTableEmptyState
icon={props.emptyIcon}
title={props.emptyTitle}
description={props.emptyDescription}
/>
}
>
<div class="space-y-3">
<Show when={props.error}>
<InlineNotice role="alert" tone="warning" aria-label="Protection refresh failed">
<p class="font-medium">Could not refresh TrueNAS protection.</p>
<p>
Showing previously loaded events. Outcomes and counts may be out of date. Newer
activity may be missing.
</p>
<Show when={props.onRefresh}>
<Button
size="sm"
class="mt-2"
disabled={props.loading}
aria-label="Refresh TrueNAS protection"
onClick={() => props.onRefresh?.()}
>
{props.loading ? 'Refreshing...' : 'Refresh'}
</Button>
</Show>
</InlineNotice>
</Show>
<Show when={props.showToolbar !== false}>
<PlatformTableToolbar
search={tableState.search}
onSearchChange={tableState.setSearch}
searchPlaceholder="Search snapshots or replication"
searchSuggestions={tableState.searchSuggestions}
status={tableState.status()}
onStatusChange={tableState.setStatus}
statusOptions={statusOptions()}
visible={tableState.visible()}
total={tableState.total()}
rowNoun="events"
/>
</Show>
<Show
when={tableState.filtered().length > 0}
fallback={
<PlatformTableEmptyState
icon={props.emptyIcon}
title="No protection events match current filters"
description="Adjust the search or outcome filter to see more TrueNAS snapshots and replication tasks."
/>
}
>
<PlatformTableShell
title="Snapshots & Replication"
actions={
<span class="text-[10px] font-medium text-muted">
{tableState.total()} event{tableState.total() === 1 ? '' : 's'}
</span>
}
tableClass="min-w-full table-fixed text-xs md:min-w-[960px]"
header={
<>
{/* On phones, keep identity, completion and outcome readable.
Artifact and target remain in the existing wrapping details. */}
<PlatformSortableTableHead
kind="name"
sort={sort}
sortKey="dataset"
class="platform-table-mobile-w-30 md:w-[22%]"
>
Dataset
</PlatformSortableTableHead>
<PlatformSortableTableHead
kind="text"
sort={sort}
sortKey="artifact"
class="platform-table-phone-hidden md:w-[25%]"
>
Artifact
</PlatformSortableTableHead>
<PlatformSortableTableHead
kind="text"
sort={sort}
sortKey="target"
class="platform-table-phone-hidden md:w-[23%]"
>
Target
</PlatformSortableTableHead>
<PlatformSortableTableHead
kind="numeric-value"
sort={sort}
sortKey="completed"
class="platform-table-mobile-w-30 md:w-[12%]"
>
<PlatformResponsiveTableLabel compact="Finished" full="Completed" />
</PlatformSortableTableHead>
<PlatformSortableTableHead
kind="numeric-value"
sort={sort}
sortKey="size"
class="hidden lg:table-cell md:w-[8%]"
>
Size
</PlatformSortableTableHead>
<PlatformSortableTableHead
kind="badge"
sort={sort}
sortKey="outcome"
class="platform-table-mobile-w-30 md:w-[9%]"
>
Outcome
</PlatformSortableTableHead>
</>
}
body={
<>
<PlatformWindowedRows items={sortedRows} estimatedRowHeight={32}>
{(point) => {
const outcome = () => normalizeRecoveryOutcome(point.outcome);
const artifact = () => artifactLabel(point);
const artifactSecondary = () => artifactSecondaryLabel(point);
const target = () => targetLabel(point);
const targetSecondary = () => targetSecondaryLabel(point);
const detailRowId = () => detail.detailRowId(point);
const isExpanded = () => detail.isExpanded(point);
return (
<>
<TableRow
class={`${getPlatformResourceDetailRowClass(isExpanded())} text-[11px] sm:text-xs`}
data-truenas-protection-row={point.id}
data-truenas-protection-kind={mapTrueNASProtectionKind(point)}
data-truenas-protection-outcome={mapTrueNASProtectionStatus(point)}
onClick={() => detail.toggle(point)}
>
<TableCell class={getPlatformTableCellClassForKind('name')}>
<DatasetCell
point={point}
detailToggle={
<PlatformResourceDetailToggleButton
expanded={isExpanded()}
resourceLabel={datasetLabel(point)}
controlsId={detailRowId()}
onToggle={() => detail.toggle(point)}
/>
}
/>
</TableCell>
<TableCell
class={`${getPlatformTableCellClassForKind('text')} platform-table-phone-hidden`}
>
<span
class="block truncate text-base-content"
title={[artifact(), artifactSecondary()]
.filter(Boolean)
.join(' · ')}
>
{artifact()}
</span>
</TableCell>
<TableCell
class={`${getPlatformTableCellClassForKind('text')} platform-table-phone-hidden`}
>
<span
class="block truncate text-base-content"
title={[target(), targetSecondary()].filter(Boolean).join(' · ')}
>
{target()}
</span>
</TableCell>
<TableCell
class={`${getPlatformTableCellClassForKind('numeric-value')} text-base-content`}
>
<PlatformTableDateTimeValue
value={parseBackupTimestampMs(completionTimestamp(point))}
emptyText={completionTimestamp(point) ? 'Unknown' : '-'}
/>
</TableCell>
<TableCell
class={`${getPlatformTableCellClassForKind('numeric-value')} hidden text-base-content lg:table-cell`}
>
{sizeLabel(point)}
</TableCell>
<TableCell class={getPlatformTableCellClassForKind('badge')}>
<span class={getRecoveryOutcomeBadgeClass(outcome())}>
{getRecoveryOutcomeLabel(outcome())}
</span>
</TableCell>
</TableRow>
<Show when={isExpanded()}>
<InlineDetailTableRow
cellId={detailRowId()}
colspan={6}
data-inline-detail-for={point.id}
data-truenas-protection-detail-row={point.id}
>
<ProtectionDetailTable
point={point}
onClose={() => detail.close(point)}
/>
</InlineDetailTableRow>
</Show>
</>
);
}}
</PlatformWindowedRows>
</>
}
/>
</Show>
</div>
</Show>
</Show>
</Show>
);
};
export default TrueNASProtectionTable;