Add component event attributes to serialized output

.chloggen/43606-1.yaml

@@ -0,0 +1,41 @@
+# Use this changelog template to create an entry for release notes.
+
+# One of 'breaking', 'deprecation', 'new_component', 'enhancement', 'bug_fix'
+change_type: 'enhancement'
+
+# The name of the component, or a single word describing the area of concern, (e.g. receiver/filelog)
+component: extension/health_check
+
+# A brief description of the change.  Surround your text with quotes ("") if it needs to start with a backtick (`).
+note: Add component event attributes to serialized output.
+
+# Mandatory: One or more tracking issues related to the change. You can use the PR number here if no issue exists.
+issues: [43606]
+
+# (Optional) One or more lines of additional information to render under the primary note.
+# These lines will be padded with 2 spaces and then inserted directly into the document.
+# Use pipe (|) for multiline entries.
+subtext: |
+  When `http.status.include_attributes` is enabled in the healthcheckv2 extension (with `use_v2: true`),
+  users will see additional attributes in the status output. These attributes provide more
+  context about component states, including details like error messages and affected components.
+  For example:
+  ```json
+  {
+    "healthy": false,
+    "status": "error",
+    "attributes": {
+      "error_msg": "not enough permissions to read cpu data",
+      "scrapers": ["cpu", "memory", "network"]
+    }
+  }
+  ```
+
+# If your change doesn't affect end users or the exported elements of any package,
+# you should instead start your pull request title with [chore] or use the "Skip Changelog" label.
+# Optional: The change log or logs in which this entry should be included.
+# e.g. '[user]' or '[user, api]'
+# Include 'user' if the change is relevant to end users.
+# Include 'api' if there is a change to a library API.
+# Default: '[user]'
+change_logs: [user]

.chloggen/43606.yaml

@@ -0,0 +1,41 @@
+# Use this changelog template to create an entry for release notes.
+
+# One of 'breaking', 'deprecation', 'new_component', 'enhancement', 'bug_fix'
+change_type: 'enhancement'
+
+# The name of the component, or a single word describing the area of concern, (e.g. receiver/filelog)
+component: extension/healthcheckv2
+
+# A brief description of the change.  Surround your text with quotes ("") if it needs to start with a backtick (`).
+note: Add component event attributes to serialized output.
+
+# Mandatory: One or more tracking issues related to the change. You can use the PR number here if no issue exists.
+issues: [43606]
+
+# (Optional) One or more lines of additional information to render under the primary note.
+# These lines will be padded with 2 spaces and then inserted directly into the document.
+# Use pipe (|) for multiline entries.
+subtext: |
+  When `http.status.include_attributes` is enabled in the healthcheckv2 extension (with `use_v2: true`),
+  users will see additional attributes in the status output. These attributes provide more
+  context about component states, including details like error messages and affected components.
+  For example:
+  ```json
+  {
+    "healthy": false,
+    "status": "error",
+    "attributes": {
+      "error_msg": "not enough permissions to read cpu data",
+      "scrapers": ["cpu", "memory", "network"]
+    }
+  }
+  ```
+
+# If your change doesn't affect end users or the exported elements of any package,
+# you should instead start your pull request title with [chore] or use the "Skip Changelog" label.
+# Optional: The change log or logs in which this entry should be included.
+# e.g. '[user]' or '[user, api]'
+# Include 'user' if the change is relevant to end users.
+# Include 'api' if there is a change to a library API.
+# Default: '[user]'
+change_logs: [user]

extension/healthcheckextension/go.mod

@@ -3,7 +3,7 @@ module github.com/open-telemetry/opentelemetry-collector-contrib/extension/healt
 go 1.25.0
 
 require (
-	github.com/open-telemetry/opentelemetry-collector-contrib/internal/common v0.148.0
+	github.com/open-telemetry/opentelemetry-collector-contrib/internal/common v0.148.1-0.20260320051400-372cc483b303
 	github.com/open-telemetry/opentelemetry-collector-contrib/internal/healthcheck v0.148.0
 	github.com/stretchr/testify v1.11.1
 	go.opentelemetry.io/collector/component v1.54.1-0.20260320051400-372cc483b303
@@ -48,7 +48,7 @@ require (
 	github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd // indirect
 	github.com/modern-go/reflect2 v1.0.3-0.20250322232337-35a7c28c31ee // indirect
 	github.com/mostynb/go-grpc-compression v1.2.3 // indirect
-	github.com/open-telemetry/opentelemetry-collector-contrib/pkg/status v0.148.0 // indirect
+	github.com/open-telemetry/opentelemetry-collector-contrib/pkg/status v0.148.1-0.20260320051400-372cc483b303 // indirect
 	github.com/pierrec/lz4/v4 v4.1.26 // indirect
 	github.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2 // indirect
 	github.com/rs/cors v1.11.1 // indirect

extension/healthcheckv2extension/README.md

@@ -102,6 +102,7 @@ extensions:
       status:
         enabled: true
         path: "/health/status"
+        include_attributes: true
       config:
         enabled: true
         path: "/health/config"
@@ -171,7 +172,8 @@ status to HTTP status is as follows:
 
 The response body contains either a detailed, or non-detailed view into collector or pipeline health
 in JSON format. The level of detail applies to the contents of the response body and is controlled
-by passing `verbose` as a query parameter.
+by the `verbose` query parameter. Component event attributes are included when
+`http.status.include_attributes` is set to `true`, regardless of whether the response is detailed.
 
 ###### Error Precedence
 
@@ -192,8 +194,8 @@ collector health.
 **Verbose Example**
 
 Assuming the health check extension is configured with `http.status.endpoint` set to
-`localhost:13133` a request to `http://localhost:13133/status?verbose` will have a
-response body such as:
+`localhost:13133`, a request to `http://localhost:13133/status?verbose`
+will have a response body such as:
 
 ```json
 {
@@ -274,8 +276,10 @@ Note the following based on this response:
 
 **Non-verbose Response example**
 
-If the same request is made to a collector without setting the verbose flag, only the overall status
-will be returned. The pipeline and component level statuses will be omitted.
+If the same request is made without the `verbose` query parameter, only the overall
+status will be returned. The pipeline and component level statuses will be omitted. If
+`http.status.include_attributes` is enabled, the overall status will also include an `attributes`
+field.
 
 ```json
 {
@@ -297,8 +301,8 @@ pipeline.
 **Verbose Response Example**
 
 Assuming the health check extension is configured with `http.status.endpoint` set to
-`localhost:13133` a request to `http://localhost:13133/status?pipeline=traces/http&verbose` will have
-a response body such as:
+`localhost:13133`, a request to
+`http://localhost:13133/status?pipeline=traces/http&verbose` will have a response body such as:
 
 
 ```json
@@ -329,8 +333,9 @@ a response body such as:
 
 **Non-detailed Response Example**
 
-If the same request is made without the verbose flag, only the overall pipeline status will be
-returned. The component level statuses will be omitted.
+If the same request is made without the `verbose` query parameter, only the overall pipeline status
+will be returned. The component level statuses will be omitted. If `http.status.include_attributes`
+is enabled, the overall status will also include an `attributes` field.
 
 ```json
 {

extension/healthcheckv2extension/go.mod

@@ -3,7 +3,7 @@ module github.com/open-telemetry/opentelemetry-collector-contrib/extension/healt
 go 1.25.0
 
 require (
-	github.com/open-telemetry/opentelemetry-collector-contrib/internal/common v0.148.0
+	github.com/open-telemetry/opentelemetry-collector-contrib/internal/common v0.148.1-0.20260320051400-372cc483b303
 	github.com/open-telemetry/opentelemetry-collector-contrib/internal/healthcheck v0.148.0
 	github.com/stretchr/testify v1.11.1
 	go.opentelemetry.io/collector/component v1.54.1-0.20260320051400-372cc483b303
@@ -44,7 +44,7 @@ require (
 	github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd // indirect
 	github.com/modern-go/reflect2 v1.0.3-0.20250322232337-35a7c28c31ee // indirect
 	github.com/mostynb/go-grpc-compression v1.2.3 // indirect
-	github.com/open-telemetry/opentelemetry-collector-contrib/pkg/status v0.148.0 // indirect
+	github.com/open-telemetry/opentelemetry-collector-contrib/pkg/status v0.148.1-0.20260320051400-372cc483b303 // indirect
 	github.com/pierrec/lz4/v4 v4.1.26 // indirect
 	github.com/pmezard/go-difflib v1.0.0 // indirect
 	github.com/rs/cors v1.11.1 // indirect

extension/opampextension/opamp_agent_test.go

@@ -26,6 +26,7 @@ import (
 	"go.opentelemetry.io/collector/confmap/confmaptest"
 	"go.opentelemetry.io/collector/extension"
 	"go.opentelemetry.io/collector/extension/extensiontest"
+	"go.opentelemetry.io/collector/pdata/pcommon"
 	"go.opentelemetry.io/collector/pipeline"
 	"go.opentelemetry.io/collector/service"
 	"go.uber.org/zap"
@@ -985,6 +986,10 @@ func (m mockStatusEvent) Timestamp() time.Time {
 	return m.timestamp
 }
 
+func (mockStatusEvent) Attributes() pcommon.Map {
+	return pcommon.NewMap()
+}
+
 func newTestOpampAgent(cfg *Config, set extension.Settings, mockOpampClient *mockOpAMPClient, sa *mockStatusAggregator) *opampAgent {
 	uid := uuid.New()
 	o := &opampAgent{

internal/healthcheck/config.go

@@ -174,8 +174,9 @@ func NewDefaultConfig() component.Config {
 				},
 			},
 			Status: http.PathConfig{
-				Enabled: true,
-				Path:    "/status",
+				Enabled:           true,
+				Path:              "/status",
+				IncludeAttributes: false,
 			},
 			Config: http.PathConfig{
 				Enabled: false,

internal/healthcheck/go.mod

@@ -3,8 +3,8 @@ module github.com/open-telemetry/opentelemetry-collector-contrib/internal/health
 go 1.25.0
 
 require (
-	github.com/open-telemetry/opentelemetry-collector-contrib/internal/common v0.148.0
-	github.com/open-telemetry/opentelemetry-collector-contrib/pkg/status v0.148.0
+	github.com/open-telemetry/opentelemetry-collector-contrib/internal/common v0.148.1-0.20260320051400-372cc483b303
+	github.com/open-telemetry/opentelemetry-collector-contrib/pkg/status v0.148.1-0.20260320051400-372cc483b303
 	github.com/stretchr/testify v1.11.1
 	go.opentelemetry.io/collector/component v1.54.1-0.20260320051400-372cc483b303
 	go.opentelemetry.io/collector/component/componentstatus v0.148.1-0.20260320051400-372cc483b303
@@ -16,6 +16,7 @@ require (
 	go.opentelemetry.io/collector/extension v1.54.1-0.20260320051400-372cc483b303
 	go.opentelemetry.io/collector/extension/extensioncapabilities v0.148.1-0.20260320051400-372cc483b303
 	go.opentelemetry.io/collector/extension/extensiontest v0.148.1-0.20260320051400-372cc483b303
+	go.opentelemetry.io/collector/pdata v1.54.1-0.20260320051400-372cc483b303
 	go.opentelemetry.io/collector/pipeline v1.54.1-0.20260320051400-372cc483b303
 	go.uber.org/goleak v1.3.0
 	go.uber.org/multierr v1.11.0
@@ -63,7 +64,6 @@ require (
 	go.opentelemetry.io/collector/extension/extensionmiddleware v0.148.1-0.20260320051400-372cc483b303 // indirect
 	go.opentelemetry.io/collector/featuregate v1.54.1-0.20260320051400-372cc483b303 // indirect
 	go.opentelemetry.io/collector/internal/componentalias v0.148.1-0.20260320051400-372cc483b303 // indirect
-	go.opentelemetry.io/collector/pdata v1.54.1-0.20260320051400-372cc483b303 // indirect
 	go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc v0.67.0 // indirect
 	go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.67.0 // indirect
 	go.opentelemetry.io/otel v1.42.0 // indirect

internal/healthcheck/internal/http/config.go

@@ -14,8 +14,9 @@ type Config struct {
 }
 
 type PathConfig struct {
-	Enabled bool   `mapstructure:"enabled"`
-	Path    string `mapstructure:"path"`
+	Enabled           bool   `mapstructure:"enabled"`
+	Path              string `mapstructure:"path"`
+	IncludeAttributes bool   `mapstructure:"include_attributes"`
 }
 
 // LegacyConfig contains the config for the original healthcheck extension. We plan to migrate

internal/healthcheck/internal/http/package_test.go

@@ -10,5 +10,12 @@ import (
 )
 
 func TestMain(m *testing.M) {
-	goleak.VerifyTestMain(m)
+	// These goroutines are part of the http.Client's connection pool management.
+	// They don't accept context.Context and are managed by the transport's lifecycle,
+	// not our test lifecycle. They'll be cleaned up when the transport is garbage collected.
+	opts := []goleak.Option{
+		goleak.IgnoreTopFunction("net/http.(*persistConn).writeLoop"),
+		goleak.IgnoreTopFunction("net/http.(*persistConn).readLoop"),
+	}
+	goleak.VerifyTestMain(m, opts...)
 }

internal/healthcheck/internal/http/responders.go

@@ -51,12 +51,13 @@ func respondWithJSON(code int, content any, w http.ResponseWriter) error {
 	return wErr
 }
 
-func defaultResponder(startTimestamp *time.Time) responderFunc {
+func defaultResponder(startTimestamp *time.Time, includeAttributes bool) responderFunc {
 	return func(st *status.AggregateStatus, w http.ResponseWriter) error {
 		code := responseCodes[st.Status()]
 		sst := toSerializableStatus(st, &serializationOptions{
-			includeStartTime: true,
-			startTimestamp:   startTimestamp,
+			includeStartTime:  true,
+			startTimestamp:    startTimestamp,
+			includeAttributes: includeAttributes,
 		})
 		return respondWithJSON(code, sst, w)
 	}
@@ -65,6 +66,7 @@ func defaultResponder(startTimestamp *time.Time) responderFunc {
 func componentHealthResponder(
 	startTimestamp *time.Time,
 	config *common.ComponentHealthConfig,
+	includeAttributes bool,
 ) responderFunc {
 	healthyFunc := func(now *time.Time) func(status.Event) bool {
 		return func(ev status.Event) bool {
@@ -84,9 +86,10 @@ func componentHealthResponder(
 		sst := toSerializableStatus(
 			st,
 			&serializationOptions{
-				includeStartTime: true,
-				startTimestamp:   startTimestamp,
-				healthyFunc:      healthyFunc(&now),
+				includeStartTime:  true,
+				startTimestamp:    startTimestamp,
+				healthyFunc:       healthyFunc(&now),
+				includeAttributes: includeAttributes,
 			},
 		)
 

internal/healthcheck/internal/http/serialization.go

@@ -21,9 +21,10 @@ func (f healthyFunc) isHealthy(ev status.Event) bool {
 }
 
 type serializationOptions struct {
-	includeStartTime bool
-	startTimestamp   *time.Time
-	healthyFunc      healthyFunc
+	includeStartTime  bool
+	startTimestamp    *time.Time
+	healthyFunc       healthyFunc
+	includeAttributes bool
 }
 
 type serializableStatus struct {
@@ -34,10 +35,11 @@ type serializableStatus struct {
 
 // SerializableEvent is exported for json.Unmarshal
 type SerializableEvent struct {
-	Healthy      bool      `json:"healthy"`
-	StatusString string    `json:"status"`
-	Error        string    `json:"error,omitempty"`
-	Timestamp    time.Time `json:"status_time"`
+	Healthy      bool           `json:"healthy"`
+	StatusString string         `json:"status"`
+	Error        string         `json:"error,omitempty"`
+	Timestamp    time.Time      `json:"status_time"`
+	Attributes   map[string]any `json:"attributes"`
 }
 
 var stringToStatusMap = map[string]componentstatus.Status{
@@ -58,12 +60,22 @@ func (ev *SerializableEvent) Status() componentstatus.Status {
 	return componentstatus.StatusNone
 }
 
-func toSerializableEvent(ev status.Event, isHealthy bool) *SerializableEvent {
+func toSerializableEvent(ev status.Event, isHealthy, includeAttributes bool) *SerializableEvent {
 	se := &SerializableEvent{
 		Healthy:      isHealthy,
 		StatusString: ev.Status().String(),
 		Timestamp:    ev.Timestamp(),
+		Attributes:   map[string]any{},
 	}
+
+	if includeAttributes {
+		attrs := ev.Attributes()
+		attrLen := attrs.Len()
+		if attrLen > 0 {
+			se.Attributes = attrs.AsRaw()
+		}
+	}
+
 	if ev.Err() != nil {
 		se.Error = ev.Err().Error()
 	}
@@ -78,6 +90,7 @@ func toSerializableStatus(
 		SerializableEvent: toSerializableEvent(
 			st.Event,
 			opts.healthyFunc.isHealthy(st.Event),
+			opts.includeAttributes,
 		),
 		ComponentStatuses: make(map[string]*serializableStatus),
 	}

internal/healthcheck/internal/http/server.go

@@ -60,10 +60,14 @@ func NewServer(
 
 	if legacyConfig.UseV2 {
 		srv.httpConfig = config.ServerConfig
+		includeAttributes := true // default for backward compatibility
+		if config.Status.Enabled {
+			includeAttributes = config.Status.IncludeAttributes
+		}
 		if componentHealthConfig != nil {
-			srv.responder = componentHealthResponder(&now, componentHealthConfig)
+			srv.responder = componentHealthResponder(&now, componentHealthConfig, includeAttributes)
 		} else {
-			srv.responder = defaultResponder(&now)
+			srv.responder = defaultResponder(&now, includeAttributes)
 		}
 		if config.Status.Enabled {
 			srv.mux.Handle(config.Status.Path, srv.statusHandler())