Method GetInstance

src/go/plugin/ibm.d/framework/state.go:23–68

GetInstance returns or creates an instance for the given context and labels

(ctx any, labels any)

// GetInstance returns or creates an instance for the given context and labels
func (s *CollectorState) GetInstance(ctx any, labels any) *Instance {
	// Extract context metadata including label order
	contextMeta := extractContextMetadata(ctx)
	if contextMeta == nil {
		return nil
	}

	// Extract context name
	contextName := contextMeta.Name

	// Generate instance key
	var key string
	var labelMap map[string]string

	if labels != nil {
		// Always convert to map for storage
		labelMap = structToMap(labels)

		// Use the InstanceID method if available
		if labeler, ok := labels.(interface{ InstanceID(string) string }); ok {
			key = labeler.InstanceID(contextName)
		} else {
			// Fallback to manual generation
			key = generateInstanceKeyWithOrder(contextName, contextMeta.LabelOrder, labelMap)
		}
	} else {
		// No labels, just use context name
		key = contextName
		labelMap = make(map[string]string)
	}

	// Get or create instance
	instance, exists := s.instances[key]
	if !exists {
		instance = &Instance{
			key:         key,
			contextName: contextName,
			labels:      labelMap,
			lastSeen:    time.Now(),
		}
		s.instances[key] = instance
	}

	instance.lastSeen = time.Now()
	return instance
}

// SetMetricsForGeneratedCode is ONLY for use by code generated by metricgen.
// DO NOT call this method directly in hand-written code.