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 { State } from '@/types/api';
import type { Resource } from '@/types/resource';
import { KNOWN_SOURCE_PLATFORM_KEYS, type KnownSourcePlatform } from '@/utils/sourcePlatforms';
export const KNOWN_STORAGE_BACKUP_PLATFORMS = KNOWN_SOURCE_PLATFORM_KEYS;
export type KnownStorageBackupPlatform = KnownSourcePlatform;
export type StorageBackupPlatform = KnownStorageBackupPlatform | (string & {});
export type PlatformFamily = 'onprem' | 'container' | 'virtualization' | 'cloud' | 'generic';
export type NormalizedHealth = 'healthy' | 'warning' | 'critical' | 'offline' | 'unknown';
export type StorageHealthFilter = 'all' | 'attention' | NormalizedHealth;
export type StorageCategory =
| 'pool'
| 'datastore'
| 'dataset'
| 'volume'
| 'filesystem'
| 'object-bucket'
| 'backup-repository'
| 'share'
| 'other';
export type StorageCapability =
| 'capacity'
| 'health'
| 'object-bucket'
| 'deduplication'
| 'compression'
| 'encryption'
| 'replication'
| 'snapshots'
| 'immutability'
| 'namespaces'
| 'tiering'
| 'multi-node'
| 'backup-repository';
export interface SourceDescriptor {
platform: StorageBackupPlatform;
family: PlatformFamily;
origin: 'resource';
adapterId: string;
}
export interface StorageLocation {
label: string;
scope: 'node' | 'cluster' | 'namespace' | 'host' | 'region' | 'global' | 'unknown';
}
export interface CapacitySnapshot {
totalBytes: number | null;
usedBytes: number | null;
freeBytes: number | null;
usagePercent: number | null;
}
export interface StorageMetricsTarget {
resourceType: string;
resourceId: string;
}
export interface StorageRecord {
id: string;
name: string;
category: StorageCategory;
health: NormalizedHealth;
statusLabel?: string;
hostLabel?: string;
platformLabel?: string;
platformKey?: StorageBackupPlatform;
topologyLabel?: string;
protectionLabel?: string;
protectionSummary?: string;
protectionReduced?: boolean;
rebuildInProgress?: boolean;
incidentCategory?: string;
incidentSeverity?: string;
incidentPriority?: number;
issueLabel?: string;
issueSummary?: string;
actionSummary?: string;
impactSummary?: string;
consumerCount?: number;
protectedWorkloadCount?: number;
affectedDatastoreCount?: number;
location: StorageLocation;
capacity: CapacitySnapshot;
capabilities: StorageCapability[];
source: SourceDescriptor;
observedAt: number;
freshness?: 'fresh' | 'stale' | 'unknown';
freshnessError?: string;
// Alert resource ids of rows folded into this one (a Ceph pool collapsed
// into the PVE storage that mounts it), so their alerts still explain and
// rank the surviving row.
absorbedAlertResourceIds?: string[];
metricsTarget?: StorageMetricsTarget;
refs?: {
resourceId?: string;
platformEntityId?: string;
};
details?: Record<string, unknown>;
}
export interface StorageAdapterContext {
state: State;
resources: Resource[];
}
export interface StorageAdapter {
id: string;
supports: (ctx: StorageAdapterContext) => boolean;
build: (ctx: StorageAdapterContext) => StorageRecord[];
}