Method getFreshClusterStatusInternal

pkg/api/client.go:436–473

getFreshClusterStatusInternal is the shared implementation for cluster status retrieval. When enrichVMs is true, running VMs are enriched with guest agent data (slower but more complete).

(enrichVMs bool)

// getFreshClusterStatusInternal is the shared implementation for cluster status retrieval.
// When enrichVMs is true, running VMs are enriched with guest agent data (slower but more complete).
func (c *Client) getFreshClusterStatusInternal(enrichVMs bool) (*Cluster, error) {
	// Selectively clear cluster-level cache entries rather than the entire cache.
	// Node-level data (disks, updates) is invalidated per-node during enrichment,
	// so clearing everything here wastes cached data that is still valid.
	c.ClearClusterCache()

	// Create a fresh cluster with minimal cache TTL for resources
	cluster := &Cluster{
		Nodes:          make([]*Node, 0),
		StorageManager: NewStorageManager(),
		lastUpdate:     time.Now(),
	}

	// 1. Get basic cluster status
	if err := c.getClusterBasicStatus(cluster); err != nil {
		return nil, err
	}

	// 2. Get cluster resources without cache (TTL = 0)
	if err := c.processClusterResourcesWithCache(cluster, 0); err != nil {
		return nil, err
	}

	// 3. Enrich VMs with detailed status information (skipped for light refresh)
	if enrichVMs {
		if err := c.EnrichVMs(cluster); err != nil {
			// Log error but continue
			c.logger.Debug("[CLUSTER] Error enriching VM data: %v", err)
		}
	}

	// 4. Calculate cluster-wide totals
	c.calculateClusterTotals(cluster)

	c.Cluster = cluster

	return cluster, nil
}

// RefreshNodeData refreshes data for a specific node by clearing its cache entries and fetching fresh data.
func (c *Client) RefreshNodeData(nodeName string) (*Node, error) {