NewEvent creates and returns a Event with the specified status and sets the timestamp time.Now().

NewFatalErrorEvent wraps the fatal runtime error passed as argument as a Event with a status StatusFatalError and a timestamp set to time.Now().

NewInstanceID returns an ID that uniquely identifies a component.

NewPermanentErrorEvent wraps an error requiring human intervention to fix passed as argument as a Event with a status StatusPermanentError and a timestamp set to time.Now().

NewRecoverableErrorEvent wraps a transient error passed as argument as a Event with a status StatusRecoverableError and a timestamp set to time.Now().

ReportStatus is a helper function that handles checking if the component.Host has implemented Reporter.

StatusIsError returns true for error statuses (e.g.

StatusFatalError indicates that the collector has experienced a fatal runtime error and will shut down.

StatusNone indicates absence of component status.

StatusOK indicates the component is running without issues.

StatusPermanentError indicates that the component has detected a condition at runtime that will need human intervention to fix.

StatusRecoverableError indicates that the component has experienced a transient error and may recover.

StatusStarting indicates the component is starting.

StatusStopped indicates that the component has completed shutdown.

StatusStopping indicates that the component is in the process of shutting down.

Event contains a status and timestamp, and can contain an error.

InstanceID uniquely identifies a component instance TODO: consider moving this struct to a new package/module like `extension/statuswatcher` https://github.com/open-telemetry/opentelemetry-collector/issues/10764.

Reporter is an extra interface for `component.Host` implementations.

Watcher is an extra interface for Extension hosted by the OpenTelemetry Collector that is to be implemented by extensions interested in changes to component status.