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.

2.2 KB
Raw Blame
package monitoring

import (
	"strings"
	"time"

	"github.com/rcourtman/pulse-go-rewrite/internal/models"
	"github.com/rcourtman/pulse-go-rewrite/pkg/proxmox"
)

const recentGuestAgentEvidenceMaxAge = 10 * time.Minute

func hasRecentGuestAgentEvidence(prev *models.VM, now time.Time) bool {
	observedAt := guestAgentEvidenceTime(prev)
	return !observedAt.IsZero() && !observedAt.After(now) && now.Sub(observedAt) <= recentGuestAgentEvidenceMaxAge
}

func guestAgentEvidenceTime(prev *models.VM) time.Time {
	if prev == nil || prev.Type != "qemu" {
		return time.Time{}
	}
	if prev.GuestAgentEvidence.Explicit || !prev.GuestAgentEvidence.ObservedAt.IsZero() {
		return prev.GuestAgentEvidence.ObservedAt
	}
	// Import a legacy direct snapshot's receipt once. Modern producers mark
	// evidence explicitly, including its absence, before preserving identity.
	// Its subsequent LastSeen can therefore never refresh this original time.
	if prev.AgentVersion != "" ||
		prev.GuestAgentStatus == "available" ||
		len(prev.IPAddresses) > 0 ||
		len(prev.NetworkInterfaces) > 0 ||
		prev.OSName != "" ||
		prev.OSVersion != "" {
		return prev.LastSeen
	}

	if len(prev.Disks) > 0 && !strings.HasPrefix(prev.DiskStatusReason, "prev-") {
		// Disk provenance was available before query eligibility had its own
		// annotation. Do not import a known linked-agent or unknown-age reading
		// as fresh QGA evidence just because the legacy VM row was refreshed.
		return guestDiskObservationTime(prev)
	}
	return time.Time{}
}

func retainGuestAgentEvidence(prev *models.VM, now time.Time) models.GuestAgentEvidence {
	evidence := models.GuestAgentEvidence{Explicit: true}
	renewGuestAgentEvidence(&evidence, guestAgentEvidenceTime(prev), now)
	return evidence
}

func renewGuestAgentEvidence(evidence *models.GuestAgentEvidence, observedAt, now time.Time) {
	if !observedAt.IsZero() && !observedAt.After(now) && observedAt.After(evidence.ObservedAt) {
		evidence.ObservedAt = observedAt
	}
}

func shouldQueryGuestAgent(vmStatus *proxmox.VMStatus, prev *models.VM, now time.Time) bool {
	if vmStatus != nil {
		return vmStatus.Lock == "" && vmStatus.Agent.IsAvailable()
	}
	return hasRecentGuestAgentEvidence(prev, now)
}