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
package unifiedresources
import (
"sort"
"strings"
)
const proxmoxLXCDockerHostSourcePrefix = "proxmox-lxc-docker:"
var canonicalPlatformScopeOrder = []string{
"agent",
"truenas",
"proxmox-pve",
"proxmox-pbs",
"proxmox-pmg",
"docker",
"kubernetes",
"vmware-vsphere",
"availability",
}
// RefreshPlatformScopes derives the canonical platform-page membership for a
// resource. Platform scopes are intentionally separate from the primary display
// platform: runtime resources such as Docker containers can belong to both the
// runtime lens and the platform that owns the host/guest they run on.
func RefreshPlatformScopes(resource *Resource) {
if resource == nil {
return
}
// Clones refresh scopes on registry reads as well as writes. These small
// membership sets do not need a map on every resource read.
scopes := make([]string, 0, 4)
add := func(scope string) {
scope = strings.ToLower(strings.TrimSpace(scope))
if scope == "" {
return
}
for _, existing := range scopes {
if existing == scope {
return
}
}
scopes = append(scopes, scope)
}
for _, source := range resource.Sources {
add(platformScopeForSource(source))
}
addPlatformScopesForFacets(add, resource)
if shouldAddDockerPlatformScope(resource) {
add("docker")
}
if resource.Docker != nil {
hostSourceID := strings.TrimSpace(resource.Docker.HostSourceID)
if strings.HasPrefix(hostSourceID, proxmoxLXCDockerHostSourcePrefix) {
add("proxmox-pve")
add("docker")
}
}
resource.PlatformScopes = orderPlatformScopes(scopes)
}
func platformScopeForSource(source DataSource) string {
switch source {
case SourceAgent:
return "agent"
case SourceProxmox:
return "proxmox-pve"
case SourceDocker:
return "docker"
case SourcePBS:
return "proxmox-pbs"
case SourcePMG:
return "proxmox-pmg"
case SourceK8s:
return "kubernetes"
case SourceTrueNAS:
return "truenas"
case SourceVMware:
return "vmware-vsphere"
case SourceAvailability:
return "availability"
default:
return ""
}
}
// Facet readers borrow the caller-owned resource without retaining or mutating
// it; only RefreshPlatformScopes replaces its derived membership slice.
func addPlatformScopesForFacets(add func(string), resource *Resource) {
if resource.Agent != nil {
add("agent")
}
if resource.TrueNAS != nil {
add("truenas")
}
if resource.Proxmox != nil {
add("proxmox-pve")
}
if resource.PBS != nil {
add("proxmox-pbs")
}
if resource.PMG != nil {
add("proxmox-pmg")
}
if resource.Kubernetes != nil {
add("kubernetes")
}
if resource.VMware != nil {
add("vmware-vsphere")
}
if len(AvailabilityChecksForResource(*resource)) > 0 || CanonicalResourceType(resource.Type) == ResourceTypeNetworkEndpoint {
add("availability")
}
}
func shouldAddDockerPlatformScope(resource *Resource) bool {
if resource.Docker == nil {
return false
}
if resource.TrueNAS != nil || hasDataSource(resource.Sources, SourceTrueNAS) {
return false
}
return true
}
// orderPlatformScopes consumes the deduplicated slice, placing known scopes in
// canonical order and sorting any remaining scopes alphabetically in place.
func orderPlatformScopes(scopes []string) []string {
if len(scopes) == 0 {
return nil
}
knownCount := 0
for _, canonical := range canonicalPlatformScopeOrder {
for i := knownCount; i < len(scopes); i++ {
if scopes[i] == canonical {
scopes[knownCount], scopes[i] = scopes[i], scopes[knownCount]
knownCount++
break
}
}
}
sort.Strings(scopes[knownCount:])
return scopes
}