Skip to content

armgit / Pulse

Public Imported from GitHub
0

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.

44.4 KB
Raw Blame
package monitoring

import (
	"crypto/sha256"
	"encoding/hex"
	"fmt"
	"strings"
	"time"

	"github.com/rcourtman/pulse-go-rewrite/internal/config"
	"github.com/rcourtman/pulse-go-rewrite/internal/logging"
	"github.com/rcourtman/pulse-go-rewrite/internal/mock"
	"github.com/rcourtman/pulse-go-rewrite/internal/models"
	agentsk8s "github.com/rcourtman/pulse-go-rewrite/pkg/agents/kubernetes"
	"github.com/rs/zerolog"
	"github.com/rs/zerolog/log"
)

const (
	removedKubernetesClustersTTL = 24 * time.Hour
)

func normalizeKubernetesClusterIdentifier(report agentsk8s.Report) string {
	if v := strings.TrimSpace(report.Cluster.ID); v != "" {
		return v
	}
	if v := strings.TrimSpace(report.Agent.ID); v != "" {
		return v
	}

	stableKey := strings.TrimSpace(report.Cluster.Server) + "|" + strings.TrimSpace(report.Cluster.Context) + "|" + strings.TrimSpace(report.Cluster.Name)
	stableKey = strings.TrimSpace(stableKey)
	if stableKey == "||" || stableKey == "" {
		return ""
	}

	sum := sha256.Sum256([]byte(stableKey))
	return hex.EncodeToString(sum[:])
}

// ApplyKubernetesReport ingests a Kubernetes agent report into state.
func (m *Monitor) ApplyKubernetesReport(report agentsk8s.Report, tokenRecord *config.APITokenRecord) (models.KubernetesCluster, error) {
	if mock.IsMockEnabled() {
		// See ApplyHostReport: mock mode drops real push-based reports rather
		// than mixing a real cluster into the fixture fabric.
		return models.KubernetesCluster{
			ID:   strings.TrimSpace(report.Cluster.ID),
			Name: strings.TrimSpace(report.Cluster.Name),
		}, nil
	}

	identifier := normalizeKubernetesClusterIdentifier(report)
	if strings.TrimSpace(identifier) == "" {
		return models.KubernetesCluster{}, fmt.Errorf("kubernetes report missing cluster identifier")
	}

	// Check if this cluster was deliberately removed - reject report to prevent resurrection
	m.mu.RLock()
	removedAt, wasRemoved := m.removedKubernetesClusters[identifier]
	m.mu.RUnlock()
	if wasRemoved {
		log.Info().
			Str("k8sClusterID", identifier).
			Time("removedAt", removedAt).
			Msg("Rejecting report from deliberately removed Kubernetes cluster")
		return models.KubernetesCluster{}, fmt.Errorf("kubernetes cluster %q had monitoring stopped at %v and cannot report again. Use Allow reconnect in Settings -> Infrastructure or rerun the installer with a kubernetes:manage token to clear this block", identifier, removedAt.Format(time.RFC3339))
	}

	// Enforce token uniqueness: each token can only be bound to one cluster agent
	if tokenRecord != nil && tokenRecord.ID != "" {
		tokenID := strings.TrimSpace(tokenRecord.ID)
		agentID := strings.TrimSpace(report.Agent.ID)
		if agentID == "" {
			agentID = identifier
		}

		m.mu.Lock()
		if boundAgentID, exists := m.kubernetesTokenBindings[tokenID]; exists {
			if boundAgentID != agentID {
				m.mu.Unlock()
				tokenHint := tokenHintFromRecord(tokenRecord)
				if tokenHint != "" {
					tokenHint = " (" + tokenHint + ")"
				}
				log.Warn().
					Str("tokenID", tokenID).
					Str("tokenHint", tokenHint).
					Str("reportingAgentID", agentID).
					Str("boundAgentID", boundAgentID).
					Msg("Rejecting Kubernetes report: token already bound to different agent")
				return models.KubernetesCluster{}, fmt.Errorf("API token%s is already in use by agent %q. Each Kubernetes agent must use a unique API token. Generate a new token for this agent", tokenHint, boundAgentID)
			}
		} else {
			m.kubernetesTokenBindings[tokenID] = agentID
			log.Debug().
				Str("tokenID", tokenID).
				Str("agentID", agentID).
				Str("clusterID", identifier).
				Msg("Bound Kubernetes agent token to agent identity")
		}
		m.mu.Unlock()
	}

	receivedAt := time.Now()
	observedAt := receivedAt.UTC()

	agentID := strings.TrimSpace(report.Agent.ID)
	if agentID == "" {
		agentID = identifier
	}

	name := strings.TrimSpace(report.Cluster.Name)
	displayName := name
	if displayName == "" {
		displayName = identifier
	}

	nodes := make([]models.KubernetesNode, 0, len(report.Nodes))
	for _, n := range report.Nodes {
		var usageCPUMilli int64
		var usageMemoryBytes int64
		if n.Usage != nil {
			usageCPUMilli = n.Usage.CPUMilliCores
			usageMemoryBytes = n.Usage.MemoryBytes
		}
		roles := append([]string(nil), n.Roles...)
		nodes = append(nodes, models.KubernetesNode{
			UID:                     strings.TrimSpace(n.UID),
			Name:                    strings.TrimSpace(n.Name),
			MachineID:               strings.TrimSpace(n.MachineID),
			SystemUUID:              strings.TrimSpace(n.SystemUUID),
			Ready:                   n.Ready,
			Unschedulable:           n.Unschedulable,
			KubeletVersion:          strings.TrimSpace(n.KubeletVersion),
			ContainerRuntimeVersion: strings.TrimSpace(n.ContainerRuntimeVersion),
			OSImage:                 strings.TrimSpace(n.OSImage),
			KernelVersion:           strings.TrimSpace(n.KernelVersion),
			Architecture:            strings.TrimSpace(n.Architecture),
			CapacityCPU:             n.Capacity.CPUCores,
			CapacityMemoryBytes:     n.Capacity.MemoryBytes,
			CapacityPods:            n.Capacity.Pods,
			AllocCPU:                n.Allocatable.CPUCores,
			AllocMemoryBytes:        n.Allocatable.MemoryBytes,
			AllocPods:               n.Allocatable.Pods,
			UsageCPUMilliCores:      usageCPUMilli,
			UsageMemoryBytes:        usageMemoryBytes,
			UsageCPUPercent:         kubernetesCPUUsagePercent(usageCPUMilli, n.Allocatable.CPUCores, n.Capacity.CPUCores),
			UsageMemoryPercent:      kubernetesMemoryUsagePercent(usageMemoryBytes, n.Allocatable.MemoryBytes, n.Capacity.MemoryBytes),
			Roles:                   roles,
		})
	}

	nodeByName := make(map[string]models.KubernetesNode, len(nodes))
	for _, node := range nodes {
		nodeName := strings.TrimSpace(node.Name)
		if nodeName != "" {
			nodeByName[nodeName] = node
		}
	}

	pods := make([]models.KubernetesPod, 0, len(report.Pods))
	for _, p := range report.Pods {
		var usageCPUMilli int
		var usageMemoryBytes int64
		var networkRxBytes int64
		var networkTxBytes int64
		var ephemeralStorageUsedBytes int64
		var ephemeralStorageCapacityBytes int64
		if p.Usage != nil {
			usageCPUMilli = int(p.Usage.CPUMilliCores)
			usageMemoryBytes = p.Usage.MemoryBytes
			networkRxBytes = p.Usage.NetworkRxBytes
			networkTxBytes = p.Usage.NetworkTxBytes
			ephemeralStorageUsedBytes = p.Usage.EphemeralStorageUsedBytes
			ephemeralStorageCapacityBytes = p.Usage.EphemeralStorageCapacityBytes
		}
		labels := make(map[string]string, len(p.Labels))
		for k, v := range p.Labels {
			labels[k] = v
		}
		containers := make([]models.KubernetesPodContainer, 0, len(p.Containers))
		for _, c := range p.Containers {
			containers = append(containers, models.KubernetesPodContainer{
				Name:         strings.TrimSpace(c.Name),
				Image:        strings.TrimSpace(c.Image),
				Ready:        c.Ready,
				RestartCount: c.RestartCount,
				State:        strings.TrimSpace(c.State),
				Reason:       strings.TrimSpace(c.Reason),
				Message:      strings.TrimSpace(c.Message),
			})
		}
		pods = append(pods, models.KubernetesPod{
			UID:                           strings.TrimSpace(p.UID),
			Name:                          strings.TrimSpace(p.Name),
			Namespace:                     strings.TrimSpace(p.Namespace),
			NodeName:                      strings.TrimSpace(p.NodeName),
			Phase:                         strings.TrimSpace(p.Phase),
			Reason:                        strings.TrimSpace(p.Reason),
			Message:                       strings.TrimSpace(p.Message),
			QoSClass:                      strings.TrimSpace(p.QoSClass),
			CreatedAt:                     p.CreatedAt,
			StartTime:                     p.StartTime,
			Restarts:                      p.Restarts,
			UsageCPUMilliCores:            usageCPUMilli,
			UsageMemoryBytes:              usageMemoryBytes,
			UsageCPUPercent:               kubernetesCPUUsagePercent(int64(usageCPUMilli), nodeAllocCPU(nodeByName, p.NodeName), nodeCapacityCPU(nodeByName, p.NodeName)),
			UsageMemoryPercent:            kubernetesMemoryUsagePercent(usageMemoryBytes, nodeAllocMemory(nodeByName, p.NodeName), nodeCapacityMemory(nodeByName, p.NodeName)),
			NetworkRxBytes:                networkRxBytes,
			NetworkTxBytes:                networkTxBytes,
			EphemeralStorageUsedBytes:     ephemeralStorageUsedBytes,
			EphemeralStorageCapacityBytes: ephemeralStorageCapacityBytes,
			DiskUsagePercent:              kubernetesDiskUsagePercent(ephemeralStorageUsedBytes, ephemeralStorageCapacityBytes),
			Labels:                        labels,
			OwnerKind:                     strings.TrimSpace(p.OwnerKind),
			OwnerName:                     strings.TrimSpace(p.OwnerName),
			Containers:                    containers,
		})
	}

	clusterKey := models.KubernetesCluster{
		ID:          identifier,
		Name:        name,
		DisplayName: displayName,
	}
	if m.rateTracker != nil {
		for i := range pods {
			metricID := kubernetesPodMetricID(clusterKey, pods[i])
			if metricID == "" {
				continue
			}
			currentMetrics := IOMetrics{
				NetworkIn:  pods[i].NetworkRxBytes,
				NetworkOut: pods[i].NetworkTxBytes,
				Timestamp:  receivedAt,
			}
			_, _, netInRate, netOutRate := m.rateTracker.CalculateRates(metricID, currentMetrics)
			if netInRate > 0 {
				pods[i].NetInRate = netInRate
			}
			if netOutRate > 0 {
				pods[i].NetOutRate = netOutRate
			}
		}
	}

	deployments := make([]models.KubernetesDeployment, 0, len(report.Deployments))
	for _, d := range report.Deployments {
		labels := make(map[string]string, len(d.Labels))
		for k, v := range d.Labels {
			labels[k] = v
		}
		deployments = append(deployments, models.KubernetesDeployment{
			UID:                strings.TrimSpace(d.UID),
			Name:               strings.TrimSpace(d.Name),
			Namespace:          strings.TrimSpace(d.Namespace),
			CreatedAt:          d.CreatedAt,
			DesiredReplicas:    d.DesiredReplicas,
			UpdatedReplicas:    d.UpdatedReplicas,
			ReadyReplicas:      d.ReadyReplicas,
			AvailableReplicas:  d.AvailableReplicas,
			ObservedGeneration: d.ObservedGeneration,
			Labels:             labels,
		})
	}

	namespaces := convertKubernetesNamespaces(report.Namespaces)
	replicaSets := convertKubernetesReplicaSets(report.ReplicaSets)
	statefulSets := convertKubernetesStatefulSets(report.StatefulSets)
	daemonSets := convertKubernetesDaemonSets(report.DaemonSets)
	services := convertKubernetesServices(report.Services)
	jobs := convertKubernetesJobs(report.Jobs)
	cronJobs := convertKubernetesCronJobs(report.CronJobs)
	ingresses := convertKubernetesIngresses(report.Ingresses)
	endpointSlices := convertKubernetesEndpointSlices(report.EndpointSlices)
	networkPolicies := convertKubernetesNetworkPolicies(report.NetworkPolicies)
	persistentVolumes := convertKubernetesPersistentVolumes(report.PersistentVolumes)
	persistentVolumeClaims := convertKubernetesPersistentVolumeClaims(report.PersistentVolumeClaims)
	storageClasses := convertKubernetesStorageClasses(report.StorageClasses)
	configMaps := convertKubernetesConfigMaps(report.ConfigMaps)
	secrets := convertKubernetesSecrets(report.Secrets)
	serviceAccounts := convertKubernetesServiceAccounts(report.ServiceAccounts)
	roles := convertKubernetesRoles(report.Roles)
	clusterRoles := convertKubernetesClusterRoles(report.ClusterRoles)
	roleBindings := convertKubernetesRoleBindings(report.RoleBindings)
	clusterRoleBindings := convertKubernetesClusterRoleBindings(report.ClusterRoleBindings)
	resourceQuotas := convertKubernetesResourceQuotas(report.ResourceQuotas)
	limitRanges := convertKubernetesLimitRanges(report.LimitRanges)
	podDisruptionBudgets := convertKubernetesPodDisruptionBudgets(report.PodDisruptionBudgets)
	horizontalPodAutoscalers := convertKubernetesHorizontalPodAutoscalers(report.HorizontalPodAutoscalers)
	events := convertKubernetesEvents(report.Events)

	agentVersion := normalizeAgentVersion(report.Agent.Version)

	cluster := models.KubernetesCluster{
		ID:                       identifier,
		AgentID:                  agentID,
		Name:                     name,
		DisplayName:              displayName,
		Server:                   strings.TrimSpace(report.Cluster.Server),
		Context:                  strings.TrimSpace(report.Cluster.Context),
		Version:                  strings.TrimSpace(report.Cluster.Version),
		Status:                   "online",
		LastSeen:                 observedAt,
		IntervalSeconds:          report.Agent.IntervalSeconds,
		AgentVersion:             agentVersion,
		Nodes:                    nodes,
		Namespaces:               namespaces,
		Pods:                     pods,
		Deployments:              deployments,
		ReplicaSets:              replicaSets,
		StatefulSets:             statefulSets,
		DaemonSets:               daemonSets,
		Services:                 services,
		Jobs:                     jobs,
		CronJobs:                 cronJobs,
		Ingresses:                ingresses,
		EndpointSlices:           endpointSlices,
		NetworkPolicies:          networkPolicies,
		PersistentVolumes:        persistentVolumes,
		PersistentVolumeClaims:   persistentVolumeClaims,
		StorageClasses:           storageClasses,
		ConfigMaps:               configMaps,
		Secrets:                  secrets,
		ServiceAccounts:          serviceAccounts,
		Roles:                    roles,
		ClusterRoles:             clusterRoles,
		RoleBindings:             roleBindings,
		ClusterRoleBindings:      clusterRoleBindings,
		ResourceQuotas:           resourceQuotas,
		LimitRanges:              limitRanges,
		PodDisruptionBudgets:     podDisruptionBudgets,
		HorizontalPodAutoscalers: horizontalPodAutoscalers,
		Events:                   events,
	}

	if tokenRecord != nil {
		cluster.TokenID = strings.TrimSpace(tokenRecord.ID)
		cluster.TokenName = strings.TrimSpace(tokenRecord.Name)
		cluster.TokenHint = tokenHintFromRecord(tokenRecord)
		cluster.TokenLastUsedAt = tokenRecord.LastUsedAt
	}

	m.state.UpsertKubernetesCluster(cluster)
	m.state.SetConnectionHealth(kubernetesConnectionPrefix+identifier, true)
	m.recordKubernetesPodMetrics(cluster, receivedAt)
	m.refreshUnifiedResourceStoreAfterAgentReport()

	return cluster, nil
}

func convertKubernetesNamespaces(namespaces []agentsk8s.Namespace) []models.KubernetesNamespace {
	if len(namespaces) == 0 {
		return nil
	}
	out := make([]models.KubernetesNamespace, 0, len(namespaces))
	for _, namespace := range namespaces {
		out = append(out, models.KubernetesNamespace{
			UID:       strings.TrimSpace(namespace.UID),
			Name:      strings.TrimSpace(namespace.Name),
			Phase:     strings.TrimSpace(namespace.Phase),
			CreatedAt: namespace.CreatedAt,
			Labels:    cloneStringMap(namespace.Labels),
		}.NormalizeCollections())
	}
	return out
}

func convertKubernetesReplicaSets(replicaSets []agentsk8s.ReplicaSet) []models.KubernetesReplicaSet {
	if len(replicaSets) == 0 {
		return nil
	}
	out := make([]models.KubernetesReplicaSet, 0, len(replicaSets))
	for _, replicaSet := range replicaSets {
		out = append(out, models.KubernetesReplicaSet{
			UID:                  strings.TrimSpace(replicaSet.UID),
			Name:                 strings.TrimSpace(replicaSet.Name),
			Namespace:            strings.TrimSpace(replicaSet.Namespace),
			DesiredReplicas:      replicaSet.DesiredReplicas,
			ReadyReplicas:        replicaSet.ReadyReplicas,
			AvailableReplicas:    replicaSet.AvailableReplicas,
			FullyLabeledReplicas: replicaSet.FullyLabeledReplicas,
			ObservedGeneration:   replicaSet.ObservedGeneration,
			OwnerKind:            strings.TrimSpace(replicaSet.OwnerKind),
			OwnerName:            strings.TrimSpace(replicaSet.OwnerName),
			Labels:               cloneStringMap(replicaSet.Labels),
		}.NormalizeCollections())
	}
	return out
}

func convertKubernetesStatefulSets(statefulSets []agentsk8s.StatefulSet) []models.KubernetesStatefulSet {
	if len(statefulSets) == 0 {
		return nil
	}
	out := make([]models.KubernetesStatefulSet, 0, len(statefulSets))
	for _, statefulSet := range statefulSets {
		out = append(out, models.KubernetesStatefulSet{
			UID:               strings.TrimSpace(statefulSet.UID),
			Name:              strings.TrimSpace(statefulSet.Name),
			Namespace:         strings.TrimSpace(statefulSet.Namespace),
			DesiredReplicas:   statefulSet.DesiredReplicas,
			ReadyReplicas:     statefulSet.ReadyReplicas,
			CurrentReplicas:   statefulSet.CurrentReplicas,
			UpdatedReplicas:   statefulSet.UpdatedReplicas,
			AvailableReplicas: statefulSet.AvailableReplicas,
			ServiceName:       strings.TrimSpace(statefulSet.ServiceName),
			Labels:            cloneStringMap(statefulSet.Labels),
		}.NormalizeCollections())
	}
	return out
}

func convertKubernetesDaemonSets(daemonSets []agentsk8s.DaemonSet) []models.KubernetesDaemonSet {
	if len(daemonSets) == 0 {
		return nil
	}
	out := make([]models.KubernetesDaemonSet, 0, len(daemonSets))
	for _, daemonSet := range daemonSets {
		out = append(out, models.KubernetesDaemonSet{
			UID:                    strings.TrimSpace(daemonSet.UID),
			Name:                   strings.TrimSpace(daemonSet.Name),
			Namespace:              strings.TrimSpace(daemonSet.Namespace),
			DesiredNumberScheduled: daemonSet.DesiredNumberScheduled,
			CurrentNumberScheduled: daemonSet.CurrentNumberScheduled,
			NumberReady:            daemonSet.NumberReady,
			UpdatedNumberScheduled: daemonSet.UpdatedNumberScheduled,
			NumberAvailable:        daemonSet.NumberAvailable,
			NumberUnavailable:      daemonSet.NumberUnavailable,
			NumberMisscheduled:     daemonSet.NumberMisscheduled,
			Labels:                 cloneStringMap(daemonSet.Labels),
		}.NormalizeCollections())
	}
	return out
}

func convertKubernetesServices(services []agentsk8s.Service) []models.KubernetesService {
	if len(services) == 0 {
		return nil
	}
	out := make([]models.KubernetesService, 0, len(services))
	for _, service := range services {
		ports := make([]models.KubernetesServicePort, 0, len(service.Ports))
		for _, port := range service.Ports {
			ports = append(ports, models.KubernetesServicePort{
				Name:       strings.TrimSpace(port.Name),
				Protocol:   strings.TrimSpace(port.Protocol),
				Port:       port.Port,
				TargetPort: strings.TrimSpace(port.TargetPort),
				NodePort:   port.NodePort,
			})
		}
		out = append(out, models.KubernetesService{
			UID:         strings.TrimSpace(service.UID),
			Name:        strings.TrimSpace(service.Name),
			Namespace:   strings.TrimSpace(service.Namespace),
			ServiceType: strings.TrimSpace(service.Type),
			ClusterIP:   strings.TrimSpace(service.ClusterIP),
			ExternalIPs: append([]string(nil), service.ExternalIPs...),
			Ports:       ports,
			Selector:    cloneStringMap(service.Selector),
			CreatedAt:   service.CreatedAt,
			Labels:      cloneStringMap(service.Labels),
		}.NormalizeCollections())
	}
	return out
}

func convertKubernetesJobs(jobs []agentsk8s.Job) []models.KubernetesJob {
	if len(jobs) == 0 {
		return nil
	}
	out := make([]models.KubernetesJob, 0, len(jobs))
	for _, job := range jobs {
		out = append(out, models.KubernetesJob{
			UID:                strings.TrimSpace(job.UID),
			Name:               strings.TrimSpace(job.Name),
			Namespace:          strings.TrimSpace(job.Namespace),
			DesiredCompletions: job.DesiredCompletions,
			Succeeded:          job.Succeeded,
			Failed:             job.Failed,
			Active:             job.Active,
			StartTime:          cloneReportTimePtr(job.StartTime),
			CompletionTime:     cloneReportTimePtr(job.CompletionTime),
			Labels:             cloneStringMap(job.Labels),
		}.NormalizeCollections())
	}
	return out
}

func convertKubernetesCronJobs(cronJobs []agentsk8s.CronJob) []models.KubernetesCronJob {
	if len(cronJobs) == 0 {
		return nil
	}
	out := make([]models.KubernetesCronJob, 0, len(cronJobs))
	for _, cronJob := range cronJobs {
		out = append(out, models.KubernetesCronJob{
			UID:                strings.TrimSpace(cronJob.UID),
			Name:               strings.TrimSpace(cronJob.Name),
			Namespace:          strings.TrimSpace(cronJob.Namespace),
			Schedule:           strings.TrimSpace(cronJob.Schedule),
			Suspend:            cronJob.Suspend,
			Active:             cronJob.Active,
			LastScheduleTime:   cloneReportTimePtr(cronJob.LastScheduleTime),
			LastSuccessfulTime: cloneReportTimePtr(cronJob.LastSuccessfulTime),
			Labels:             cloneStringMap(cronJob.Labels),
		}.NormalizeCollections())
	}
	return out
}

func convertKubernetesIngresses(ingresses []agentsk8s.Ingress) []models.KubernetesIngress {
	if len(ingresses) == 0 {
		return nil
	}
	out := make([]models.KubernetesIngress, 0, len(ingresses))
	for _, ingress := range ingresses {
		out = append(out, models.KubernetesIngress{
			UID:       strings.TrimSpace(ingress.UID),
			Name:      strings.TrimSpace(ingress.Name),
			Namespace: strings.TrimSpace(ingress.Namespace),
			ClassName: strings.TrimSpace(ingress.ClassName),
			Hosts:     append([]string(nil), ingress.Hosts...),
			Addresses: append([]string(nil), ingress.Addresses...),
			CreatedAt: ingress.CreatedAt,
			Labels:    cloneStringMap(ingress.Labels),
		}.NormalizeCollections())
	}
	return out
}

func convertKubernetesEndpointSlices(slices []agentsk8s.EndpointSlice) []models.KubernetesEndpointSlice {
	if len(slices) == 0 {
		return nil
	}
	out := make([]models.KubernetesEndpointSlice, 0, len(slices))
	for _, slice := range slices {
		ports := make([]models.KubernetesEndpointPort, 0, len(slice.Ports))
		for _, port := range slice.Ports {
			ports = append(ports, models.KubernetesEndpointPort{
				Name:        strings.TrimSpace(port.Name),
				Protocol:    strings.TrimSpace(port.Protocol),
				Port:        port.Port,
				AppProtocol: strings.TrimSpace(port.AppProtocol),
			})
		}
		out = append(out, models.KubernetesEndpointSlice{
			UID:                strings.TrimSpace(slice.UID),
			Name:               strings.TrimSpace(slice.Name),
			Namespace:          strings.TrimSpace(slice.Namespace),
			AddressType:        strings.TrimSpace(slice.AddressType),
			ServiceName:        strings.TrimSpace(slice.ServiceName),
			Ports:              ports,
			EndpointCount:      slice.EndpointCount,
			ReadyEndpointCount: slice.ReadyEndpointCount,
			CreatedAt:          slice.CreatedAt,
			Labels:             cloneStringMap(slice.Labels),
		}.NormalizeCollections())
	}
	return out
}

func convertKubernetesNetworkPolicies(policies []agentsk8s.NetworkPolicy) []models.KubernetesNetworkPolicy {
	if len(policies) == 0 {
		return nil
	}
	out := make([]models.KubernetesNetworkPolicy, 0, len(policies))
	for _, policy := range policies {
		out = append(out, models.KubernetesNetworkPolicy{
			UID:              strings.TrimSpace(policy.UID),
			Name:             strings.TrimSpace(policy.Name),
			Namespace:        strings.TrimSpace(policy.Namespace),
			PolicyTypes:      append([]string(nil), policy.PolicyTypes...),
			IngressRuleCount: policy.IngressRuleCount,
			EgressRuleCount:  policy.EgressRuleCount,
			CreatedAt:        policy.CreatedAt,
			Labels:           cloneStringMap(policy.Labels),
		}.NormalizeCollections())
	}
	return out
}

func convertKubernetesPersistentVolumes(volumes []agentsk8s.PersistentVolume) []models.KubernetesPersistentVolume {
	if len(volumes) == 0 {
		return nil
	}
	out := make([]models.KubernetesPersistentVolume, 0, len(volumes))
	for _, volume := range volumes {
		out = append(out, models.KubernetesPersistentVolume{
			UID:            strings.TrimSpace(volume.UID),
			Name:           strings.TrimSpace(volume.Name),
			Phase:          strings.TrimSpace(volume.Phase),
			StorageClass:   strings.TrimSpace(volume.StorageClass),
			CapacityBytes:  volume.CapacityBytes,
			AccessModes:    append([]string(nil), volume.AccessModes...),
			ReclaimPolicy:  strings.TrimSpace(volume.ReclaimPolicy),
			ClaimNamespace: strings.TrimSpace(volume.ClaimNamespace),
			ClaimName:      strings.TrimSpace(volume.ClaimName),
			CreatedAt:      volume.CreatedAt,
			Labels:         cloneStringMap(volume.Labels),
		}.NormalizeCollections())
	}
	return out
}

func convertKubernetesPersistentVolumeClaims(claims []agentsk8s.PersistentVolumeClaim) []models.KubernetesPersistentVolumeClaim {
	if len(claims) == 0 {
		return nil
	}
	out := make([]models.KubernetesPersistentVolumeClaim, 0, len(claims))
	for _, claim := range claims {
		out = append(out, models.KubernetesPersistentVolumeClaim{
			UID:            strings.TrimSpace(claim.UID),
			Name:           strings.TrimSpace(claim.Name),
			Namespace:      strings.TrimSpace(claim.Namespace),
			Phase:          strings.TrimSpace(claim.Phase),
			StorageClass:   strings.TrimSpace(claim.StorageClass),
			RequestedBytes: claim.RequestedBytes,
			CapacityBytes:  claim.CapacityBytes,
			AccessModes:    append([]string(nil), claim.AccessModes...),
			VolumeName:     strings.TrimSpace(claim.VolumeName),
			CreatedAt:      claim.CreatedAt,
			Labels:         cloneStringMap(claim.Labels),
		}.NormalizeCollections())
	}
	return out
}

func convertKubernetesStorageClasses(classes []agentsk8s.StorageClass) []models.KubernetesStorageClass {
	if len(classes) == 0 {
		return nil
	}
	out := make([]models.KubernetesStorageClass, 0, len(classes))
	for _, class := range classes {
		out = append(out, models.KubernetesStorageClass{
			UID:                  strings.TrimSpace(class.UID),
			Name:                 strings.TrimSpace(class.Name),
			Provisioner:          strings.TrimSpace(class.Provisioner),
			ReclaimPolicy:        strings.TrimSpace(class.ReclaimPolicy),
			VolumeBindingMode:    strings.TrimSpace(class.VolumeBindingMode),
			AllowVolumeExpansion: cloneReportBoolPtr(class.AllowVolumeExpansion),
			ParameterKeys:        append([]string(nil), class.ParameterKeys...),
			CreatedAt:            class.CreatedAt,
			Labels:               cloneStringMap(class.Labels),
		}.NormalizeCollections())
	}
	return out
}

func convertKubernetesConfigMaps(configMaps []agentsk8s.ConfigMap) []models.KubernetesConfigMap {
	if len(configMaps) == 0 {
		return nil
	}
	out := make([]models.KubernetesConfigMap, 0, len(configMaps))
	for _, configMap := range configMaps {
		out = append(out, models.KubernetesConfigMap{
			UID:            strings.TrimSpace(configMap.UID),
			Name:           strings.TrimSpace(configMap.Name),
			Namespace:      strings.TrimSpace(configMap.Namespace),
			DataKeys:       append([]string(nil), configMap.DataKeys...),
			BinaryDataKeys: append([]string(nil), configMap.BinaryDataKeys...),
			Immutable:      configMap.Immutable,
			MetadataOnly:   configMap.MetadataOnly,
			CreatedAt:      configMap.CreatedAt,
			Labels:         cloneStringMap(configMap.Labels),
		}.NormalizeCollections())
	}
	return out
}

func convertKubernetesSecrets(secrets []agentsk8s.Secret) []models.KubernetesSecret {
	if len(secrets) == 0 {
		return nil
	}
	out := make([]models.KubernetesSecret, 0, len(secrets))
	for _, secret := range secrets {
		out = append(out, models.KubernetesSecret{
			UID:          strings.TrimSpace(secret.UID),
			Name:         strings.TrimSpace(secret.Name),
			Namespace:    strings.TrimSpace(secret.Namespace),
			Type:         strings.TrimSpace(secret.Type),
			DataKeys:     append([]string(nil), secret.DataKeys...),
			Immutable:    secret.Immutable,
			MetadataOnly: secret.MetadataOnly,
			CreatedAt:    secret.CreatedAt,
			Labels:       cloneStringMap(secret.Labels),
		}.NormalizeCollections())
	}
	return out
}

func convertKubernetesServiceAccounts(accounts []agentsk8s.ServiceAccount) []models.KubernetesServiceAccount {
	if len(accounts) == 0 {
		return nil
	}
	out := make([]models.KubernetesServiceAccount, 0, len(accounts))
	for _, account := range accounts {
		out = append(out, models.KubernetesServiceAccount{
			UID:                          strings.TrimSpace(account.UID),
			Name:                         strings.TrimSpace(account.Name),
			Namespace:                    strings.TrimSpace(account.Namespace),
			AutomountServiceAccountToken: cloneReportBoolPtr(account.AutomountServiceAccountToken),
			SecretCount:                  account.SecretCount,
			ImagePullSecrets:             append([]string(nil), account.ImagePullSecrets...),
			CreatedAt:                    account.CreatedAt,
			Labels:                       cloneStringMap(account.Labels),
		}.NormalizeCollections())
	}
	return out
}

func convertKubernetesRoles(roles []agentsk8s.Role) []models.KubernetesRole {
	if len(roles) == 0 {
		return nil
	}
	out := make([]models.KubernetesRole, 0, len(roles))
	for _, role := range roles {
		out = append(out, models.KubernetesRole{
			UID:       strings.TrimSpace(role.UID),
			Name:      strings.TrimSpace(role.Name),
			Namespace: strings.TrimSpace(role.Namespace),
			RuleCount: role.RuleCount,
			CreatedAt: role.CreatedAt,
			Labels:    cloneStringMap(role.Labels),
		}.NormalizeCollections())
	}
	return out
}

func convertKubernetesClusterRoles(roles []agentsk8s.ClusterRole) []models.KubernetesClusterRole {
	if len(roles) == 0 {
		return nil
	}
	out := make([]models.KubernetesClusterRole, 0, len(roles))
	for _, role := range roles {
		out = append(out, models.KubernetesClusterRole{
			UID:               strings.TrimSpace(role.UID),
			Name:              strings.TrimSpace(role.Name),
			RuleCount:         role.RuleCount,
			AggregationLabels: cloneStringMap(role.AggregationLabels),
			CreatedAt:         role.CreatedAt,
			Labels:            cloneStringMap(role.Labels),
		}.NormalizeCollections())
	}
	return out
}

func convertKubernetesRoleBindings(bindings []agentsk8s.RoleBinding) []models.KubernetesRoleBinding {
	if len(bindings) == 0 {
		return nil
	}
	out := make([]models.KubernetesRoleBinding, 0, len(bindings))
	for _, binding := range bindings {
		out = append(out, models.KubernetesRoleBinding{
			UID:          strings.TrimSpace(binding.UID),
			Name:         strings.TrimSpace(binding.Name),
			Namespace:    strings.TrimSpace(binding.Namespace),
			RoleKind:     strings.TrimSpace(binding.RoleKind),
			RoleName:     strings.TrimSpace(binding.RoleName),
			SubjectCount: binding.SubjectCount,
			SubjectKinds: append([]string(nil), binding.SubjectKinds...),
			CreatedAt:    binding.CreatedAt,
			Labels:       cloneStringMap(binding.Labels),
		}.NormalizeCollections())
	}
	return out
}

func convertKubernetesClusterRoleBindings(bindings []agentsk8s.ClusterRoleBinding) []models.KubernetesClusterRoleBinding {
	if len(bindings) == 0 {
		return nil
	}
	out := make([]models.KubernetesClusterRoleBinding, 0, len(bindings))
	for _, binding := range bindings {
		out = append(out, models.KubernetesClusterRoleBinding{
			UID:          strings.TrimSpace(binding.UID),
			Name:         strings.TrimSpace(binding.Name),
			RoleKind:     strings.TrimSpace(binding.RoleKind),
			RoleName:     strings.TrimSpace(binding.RoleName),
			SubjectCount: binding.SubjectCount,
			SubjectKinds: append([]string(nil), binding.SubjectKinds...),
			CreatedAt:    binding.CreatedAt,
			Labels:       cloneStringMap(binding.Labels),
		}.NormalizeCollections())
	}
	return out
}

func convertKubernetesResourceQuotas(quotas []agentsk8s.ResourceQuota) []models.KubernetesResourceQuota {
	if len(quotas) == 0 {
		return nil
	}
	out := make([]models.KubernetesResourceQuota, 0, len(quotas))
	for _, quota := range quotas {
		out = append(out, models.KubernetesResourceQuota{
			UID:       strings.TrimSpace(quota.UID),
			Name:      strings.TrimSpace(quota.Name),
			Namespace: strings.TrimSpace(quota.Namespace),
			Hard:      cloneStringMap(quota.Hard),
			Used:      cloneStringMap(quota.Used),
			CreatedAt: quota.CreatedAt,
			Labels:    cloneStringMap(quota.Labels),
		}.NormalizeCollections())
	}
	return out
}

func convertKubernetesLimitRanges(limitRanges []agentsk8s.LimitRange) []models.KubernetesLimitRange {
	if len(limitRanges) == 0 {
		return nil
	}
	out := make([]models.KubernetesLimitRange, 0, len(limitRanges))
	for _, limitRange := range limitRanges {
		out = append(out, models.KubernetesLimitRange{
			UID:        strings.TrimSpace(limitRange.UID),
			Name:       strings.TrimSpace(limitRange.Name),
			Namespace:  strings.TrimSpace(limitRange.Namespace),
			LimitTypes: append([]string(nil), limitRange.LimitTypes...),
			CreatedAt:  limitRange.CreatedAt,
			Labels:     cloneStringMap(limitRange.Labels),
		}.NormalizeCollections())
	}
	return out
}

func convertKubernetesPodDisruptionBudgets(budgets []agentsk8s.PodDisruptionBudget) []models.KubernetesPodDisruptionBudget {
	if len(budgets) == 0 {
		return nil
	}
	out := make([]models.KubernetesPodDisruptionBudget, 0, len(budgets))
	for _, budget := range budgets {
		out = append(out, models.KubernetesPodDisruptionBudget{
			UID:                strings.TrimSpace(budget.UID),
			Name:               strings.TrimSpace(budget.Name),
			Namespace:          strings.TrimSpace(budget.Namespace),
			MinAvailable:       strings.TrimSpace(budget.MinAvailable),
			MaxUnavailable:     strings.TrimSpace(budget.MaxUnavailable),
			DesiredHealthy:     budget.DesiredHealthy,
			CurrentHealthy:     budget.CurrentHealthy,
			DisruptionsAllowed: budget.DisruptionsAllowed,
			ExpectedPods:       budget.ExpectedPods,
			CreatedAt:          budget.CreatedAt,
			Labels:             cloneStringMap(budget.Labels),
		}.NormalizeCollections())
	}
	return out
}

func convertKubernetesHorizontalPodAutoscalers(autoscalers []agentsk8s.HorizontalPodAutoscaler) []models.KubernetesHorizontalPodAutoscaler {
	if len(autoscalers) == 0 {
		return nil
	}
	out := make([]models.KubernetesHorizontalPodAutoscaler, 0, len(autoscalers))
	for _, autoscaler := range autoscalers {
		out = append(out, models.KubernetesHorizontalPodAutoscaler{
			UID:             strings.TrimSpace(autoscaler.UID),
			Name:            strings.TrimSpace(autoscaler.Name),
			Namespace:       strings.TrimSpace(autoscaler.Namespace),
			TargetKind:      strings.TrimSpace(autoscaler.TargetKind),
			TargetName:      strings.TrimSpace(autoscaler.TargetName),
			MinReplicas:     autoscaler.MinReplicas,
			MaxReplicas:     autoscaler.MaxReplicas,
			CurrentReplicas: autoscaler.CurrentReplicas,
			DesiredReplicas: autoscaler.DesiredReplicas,
			MetricTypes:     append([]string(nil), autoscaler.MetricTypes...),
			CreatedAt:       autoscaler.CreatedAt,
			Labels:          cloneStringMap(autoscaler.Labels),
		}.NormalizeCollections())
	}
	return out
}

func convertKubernetesEvents(events []agentsk8s.Event) []models.KubernetesEvent {
	if len(events) == 0 {
		return nil
	}
	out := make([]models.KubernetesEvent, 0, len(events))
	for _, event := range events {
		out = append(out, models.KubernetesEvent{
			UID:          strings.TrimSpace(event.UID),
			Name:         strings.TrimSpace(event.Name),
			Namespace:    strings.TrimSpace(event.Namespace),
			EventType:    strings.TrimSpace(event.Type),
			Reason:       strings.TrimSpace(event.Reason),
			Message:      strings.TrimSpace(event.Message),
			InvolvedKind: strings.TrimSpace(event.InvolvedKind),
			InvolvedName: strings.TrimSpace(event.InvolvedName),
			Count:        event.Count,
			FirstSeen:    cloneReportTimePtr(event.FirstSeen),
			LastSeen:     cloneReportTimePtr(event.LastSeen),
			EventTime:    cloneReportTimePtr(event.EventTime),
		})
	}
	return out
}

func cloneReportTimePtr(src *time.Time) *time.Time {
	if src == nil {
		return nil
	}
	dest := *src
	return &dest
}

func cloneReportBoolPtr(src *bool) *bool {
	if src == nil {
		return nil
	}
	dest := *src
	return &dest
}

func kubernetesCPUUsagePercent(usageMilli, allocCPU, capacityCPU int64) float64 {
	denom := allocCPU
	if denom <= 0 {
		denom = capacityCPU
	}
	if usageMilli <= 0 || denom <= 0 {
		return 0
	}
	percent := (float64(usageMilli) / float64(denom*1000)) * 100
	if percent < 0 {
		return 0
	}
	if percent > 100 {
		return 100
	}
	return percent
}

func kubernetesMemoryUsagePercent(usageBytes, allocMemoryBytes, capacityMemoryBytes int64) float64 {
	denom := allocMemoryBytes
	if denom <= 0 {
		denom = capacityMemoryBytes
	}
	if usageBytes <= 0 || denom <= 0 {
		return 0
	}
	percent := (float64(usageBytes) / float64(denom)) * 100
	if percent < 0 {
		return 0
	}
	if percent > 100 {
		return 100
	}
	return percent
}

func kubernetesDiskUsagePercent(usedBytes, capacityBytes int64) float64 {
	if usedBytes <= 0 || capacityBytes <= 0 {
		return 0
	}
	percent := (float64(usedBytes) / float64(capacityBytes)) * 100
	if percent < 0 {
		return 0
	}
	if percent > 100 {
		return 100
	}
	return percent
}

func nodeAllocCPU(nodes map[string]models.KubernetesNode, nodeName string) int64 {
	if node, ok := nodes[strings.TrimSpace(nodeName)]; ok {
		return node.AllocCPU
	}
	return 0
}

func nodeCapacityCPU(nodes map[string]models.KubernetesNode, nodeName string) int64 {
	if node, ok := nodes[strings.TrimSpace(nodeName)]; ok {
		return node.CapacityCPU
	}
	return 0
}

func nodeAllocMemory(nodes map[string]models.KubernetesNode, nodeName string) int64 {
	if node, ok := nodes[strings.TrimSpace(nodeName)]; ok {
		return node.AllocMemoryBytes
	}
	return 0
}

func nodeCapacityMemory(nodes map[string]models.KubernetesNode, nodeName string) int64 {
	if node, ok := nodes[strings.TrimSpace(nodeName)]; ok {
		return node.CapacityMemoryBytes
	}
	return 0
}

func (m *Monitor) recordKubernetesPodMetrics(cluster models.KubernetesCluster, timestamp time.Time) {
	if m == nil {
		return
	}
	if m.metricsHistory == nil && m.metricsStore == nil {
		return
	}

	if timestamp.IsZero() {
		timestamp = time.Now().UTC()
	}
	if shouldSkipNativeMockStateMetricWrites() {
		return
	}

	for _, pod := range cluster.Pods {
		metricID := kubernetesPodMetricID(cluster, pod)
		if metricID == "" {
			continue
		}

		if pod.UsageCPUPercent > 0 {
			if m.metricsHistory != nil {
				m.metricsHistory.AddGuestMetric(metricID, "cpu", pod.UsageCPUPercent, timestamp)
			}
			if m.metricsStore != nil {
				m.metricsStore.Write("k8s", metricID, "cpu", pod.UsageCPUPercent, timestamp)
			}
		}
		if pod.UsageMemoryPercent > 0 {
			if m.metricsHistory != nil {
				m.metricsHistory.AddGuestMetric(metricID, "memory", pod.UsageMemoryPercent, timestamp)
			}
			if m.metricsStore != nil {
				m.metricsStore.Write("k8s", metricID, "memory", pod.UsageMemoryPercent, timestamp)
			}
		}
		if pod.DiskUsagePercent > 0 {
			if m.metricsHistory != nil {
				m.metricsHistory.AddGuestMetric(metricID, "disk", pod.DiskUsagePercent, timestamp)
			}
			if m.metricsStore != nil {
				m.metricsStore.Write("k8s", metricID, "disk", pod.DiskUsagePercent, timestamp)
			}
		}
		if pod.NetInRate > 0 {
			if m.metricsHistory != nil {
				m.metricsHistory.AddGuestMetric(metricID, "netin", pod.NetInRate, timestamp)
			}
			if m.metricsStore != nil {
				m.metricsStore.Write("k8s", metricID, "netin", pod.NetInRate, timestamp)
			}
		}
		if pod.NetOutRate > 0 {
			if m.metricsHistory != nil {
				m.metricsHistory.AddGuestMetric(metricID, "netout", pod.NetOutRate, timestamp)
			}
			if m.metricsStore != nil {
				m.metricsStore.Write("k8s", metricID, "netout", pod.NetOutRate, timestamp)
			}
		}
	}
}

// RemoveKubernetesCluster removes a kubernetes cluster from the shared state and clears related data.
func (m *Monitor) RemoveKubernetesCluster(clusterID string) (models.KubernetesCluster, error) {
	clusterID = strings.TrimSpace(clusterID)
	if clusterID == "" {
		return models.KubernetesCluster{}, fmt.Errorf("kubernetes cluster id is required")
	}

	cluster, removed := m.state.RemoveKubernetesCluster(clusterID)
	if !removed {
		if logging.IsLevelEnabled(zerolog.DebugLevel) {
			log.Debug().Str("k8sClusterID", clusterID).Msg("kubernetes cluster not present in state during removal; proceeding")
		}
		cluster = models.KubernetesCluster{
			ID:          clusterID,
			Name:        clusterID,
			DisplayName: clusterID,
		}
	}

	// Revoke the API token associated with this Kubernetes cluster unless a
	// sibling module still uses it. Unified-agent installs share one credential
	// across host, Docker, and Kubernetes reports; revoking it here would turn a
	// Kubernetes-only removal into 401s for the surviving modules.
	if cluster.TokenID != "" {
		tokenID := strings.TrimSpace(cluster.TokenID)
		if m.agentTokenUsedByLiveResource(tokenID) {
			log.Info().
				Str("tokenID", tokenID).
				Str("k8sClusterID", clusterID).
				Msg("API token still used by other agents; skipping revocation during Kubernetes cluster removal")
		} else {
			tokenRemoved, err := m.revokeAPIToken(tokenID)
			if err != nil {
				log.Warn().Err(err).Str("tokenID", tokenID).Msg("API token revocation rolled back after Kubernetes cluster removal")
			} else if tokenRemoved != nil {
				log.Info().Str("tokenID", tokenID).Str("tokenName", cluster.TokenName).Msg("API token revoked for removed Kubernetes cluster")
			}
		}
	}

	removedAt := time.Now()

	m.mu.Lock()
	m.removedKubernetesClusters[clusterID] = removedAt
	if cluster.TokenID != "" {
		delete(m.kubernetesTokenBindings, cluster.TokenID)
		log.Debug().
			Str("tokenID", cluster.TokenID).
			Str("k8sClusterID", clusterID).
			Msg("Unbound Kubernetes agent token from removed cluster")
	}
	m.mu.Unlock()

	m.state.AddRemovedKubernetesCluster(models.RemovedKubernetesCluster{
		ID:          clusterID,
		Name:        cluster.Name,
		DisplayName: cluster.DisplayName,
		RemovedAt:   removedAt,
	})

	m.state.RemoveConnectionHealth(kubernetesConnectionPrefix + clusterID)

	log.Info().
		Str("k8sClusterID", clusterID).
		Bool("removed", removed).
		Msg("Kubernetes cluster removed")

	return cluster, nil
}

// AllowKubernetesClusterReenroll clears the removal block for a kubernetes cluster.
func (m *Monitor) AllowKubernetesClusterReenroll(clusterID string) error {
	clusterID = strings.TrimSpace(clusterID)
	if clusterID == "" {
		return fmt.Errorf("kubernetes cluster id is required")
	}

	m.mu.Lock()
	delete(m.removedKubernetesClusters, clusterID)
	m.mu.Unlock()

	// Clear the persisted entry regardless of in-memory presence: the map
	// resets on restart while the persisted entry keeps blocking reports
	// (#1581).
	m.state.RemoveRemovedKubernetesCluster(clusterID)
	return nil
}

// UnhideKubernetesCluster clears the hidden flag.
func (m *Monitor) UnhideKubernetesCluster(clusterID string) (models.KubernetesCluster, error) {
	clusterID = strings.TrimSpace(clusterID)
	if clusterID == "" {
		return models.KubernetesCluster{}, fmt.Errorf("kubernetes cluster id is required")
	}

	cluster, ok := m.state.SetKubernetesClusterHidden(clusterID, false)
	if !ok {
		return models.KubernetesCluster{}, fmt.Errorf("kubernetes cluster %q not found", clusterID)
	}
	return cluster, nil
}

// MarkKubernetesClusterPendingUninstall sets the pending uninstall flag on a cluster.
func (m *Monitor) MarkKubernetesClusterPendingUninstall(clusterID string) (models.KubernetesCluster, error) {
	clusterID = strings.TrimSpace(clusterID)
	if clusterID == "" {
		return models.KubernetesCluster{}, fmt.Errorf("kubernetes cluster id is required")
	}

	cluster, ok := m.state.SetKubernetesClusterPendingUninstall(clusterID, true)
	if !ok {
		return models.KubernetesCluster{}, fmt.Errorf("kubernetes cluster %q not found", clusterID)
	}
	return cluster, nil
}

// SetKubernetesClusterCustomDisplayName updates the custom display name for a cluster.
func (m *Monitor) SetKubernetesClusterCustomDisplayName(clusterID, customName string) (models.KubernetesCluster, error) {
	clusterID = strings.TrimSpace(clusterID)
	if clusterID == "" {
		return models.KubernetesCluster{}, fmt.Errorf("kubernetes cluster id is required")
	}

	cluster, ok := m.state.SetKubernetesClusterCustomDisplayName(clusterID, customName)
	if !ok {
		return models.KubernetesCluster{}, fmt.Errorf("kubernetes cluster %q not found", clusterID)
	}
	return cluster, nil
}

func (m *Monitor) evaluateKubernetesAgents(now time.Time) {
	clusters := m.state.GetKubernetesClusters()
	for _, cluster := range clusters {
		interval := cluster.IntervalSeconds
		if interval <= 0 {
			interval = int(kubernetesMinimumHealthWindow / time.Second)
		}

		window := time.Duration(interval) * time.Second * kubernetesOfflineGraceMultiplier
		if window < kubernetesMinimumHealthWindow {
			window = kubernetesMinimumHealthWindow
		} else if window > kubernetesMaximumHealthWindow {
			window = kubernetesMaximumHealthWindow
		}

		healthy := !cluster.LastSeen.IsZero() && now.Sub(cluster.LastSeen) <= window
		key := kubernetesConnectionPrefix + cluster.ID
		m.state.SetConnectionHealth(key, healthy)
		if healthy {
			m.state.SetKubernetesClusterStatus(cluster.ID, "online")
		} else {
			m.state.SetKubernetesClusterStatus(cluster.ID, "offline")
		}
	}
}

// cleanupRemovedKubernetesClusters expires removed cluster blocks older than
// the TTL. Persisted entries are swept by their own RemovedAt because the
// in-memory map resets on restart (see cleanupRemovedHostAgents, #1581).
func (m *Monitor) cleanupRemovedKubernetesClusters(now time.Time) {
	expired := make(map[string]time.Time)

	for _, entry := range m.state.GetRemovedKubernetesClusters() {
		if now.Sub(entry.RemovedAt) > removedKubernetesClustersTTL {
			expired[entry.ID] = entry.RemovedAt
		}
	}

	m.mu.Lock()
	for clusterID, removedAt := range m.removedKubernetesClusters {
		if now.Sub(removedAt) > removedKubernetesClustersTTL {
			expired[clusterID] = removedAt
		}
	}
	for clusterID := range expired {
		delete(m.removedKubernetesClusters, clusterID)
	}
	m.mu.Unlock()

	for clusterID, removedAt := range expired {
		m.state.RemoveRemovedKubernetesCluster(clusterID)
		if logging.IsLevelEnabled(zerolog.DebugLevel) {
			log.Debug().
				Str("k8sClusterID", clusterID).
				Time("removedAt", removedAt).
				Msg("Cleaned up stale removed Kubernetes cluster block")
		}
	}
}