From b3dc302bbfb740b3006eb2ce83188a84bcc88c5f Mon Sep 17 00:00:00 2001
From: Andre Ziviani <andrepziviani@gmail.com>
Date: Thu, 6 Nov 2025 16:06:30 -0300
Subject: [PATCH 1/2] feat: pyroscope.enrich component

---
 CHANGELOG.md                                  |   4 +
 .../sources/reference/compatibility/_index.md |   3 +
 .../components/pyroscope/pyroscope.enrich.md  | 178 +++++++++++++++
 internal/component/all/all.go                 |   1 +
 internal/component/pyroscope/enrich/enrich.go | 202 +++++++++++++++++
 .../component/pyroscope/enrich/enrich_test.go | 208 ++++++++++++++++++
 6 files changed, 596 insertions(+)
 create mode 100644 docs/sources/reference/components/pyroscope/pyroscope.enrich.md
 create mode 100644 internal/component/pyroscope/enrich/enrich.go
 create mode 100644 internal/component/pyroscope/enrich/enrich_test.go

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 8af2963346b..98af6e5a68e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -13,8 +13,11 @@ Main (unreleased)
 ### Features
 
 - A new `mimir.alerts.kubernetes` component which discovers `AlertmanagerConfig` Kubernetes resources and loads them into a Mimir instance. (@ptodev)
+
 - Mark `stage.windowsevent` block in the `loki.process` component as GA. (@kgeckhart)
 
+- (_Experimental_) Add `pyroscope.enrich` component to enrich profiles using labels from `discovery.*` components. (@AndreZiviani)
+
 ### Enhancements
 
 - update promtail converter to use `file_match` block for `loki.source.file` instead of going through `local.file_match`. (@kalleep)
@@ -93,6 +96,7 @@ v1.12.0-rc.0
   - The `otelcol.processor.servicegraph` component now supports defining the maximum number of buckets for generated exponential histograms.
   - See the upstream [core][https://github.com/open-telemetry/opentelemetry-collector/blob/v0.139.0/CHANGELOG.md] and [contrib][https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/v0.139.0/CHANGELOG.md] changelogs for more details.
 
+
 ### Enhancements
 
 - Add per-application rate limiting with the `strategy` attribute in the `faro.receiver` component, to prevent one application from consuming the rate limit quota of others. (@hhertout)
diff --git a/docs/sources/reference/compatibility/_index.md b/docs/sources/reference/compatibility/_index.md
index a60e33099a6..5d09be2cc5a 100644
--- a/docs/sources/reference/compatibility/_index.md
+++ b/docs/sources/reference/compatibility/_index.md
@@ -159,6 +159,7 @@ The following components, grouped by namespace, _consume_ Targets.
 
 {{< collapse title="pyroscope" >}}
 - [pyroscope.ebpf](../components/pyroscope/pyroscope.ebpf)
+- [pyroscope.enrich](../components/pyroscope/pyroscope.enrich)
 - [pyroscope.java](../components/pyroscope/pyroscope.java)
 - [pyroscope.scrape](../components/pyroscope/pyroscope.scrape)
 {{< /collapse >}}
@@ -422,6 +423,7 @@ The following components, grouped by namespace, _export_ Pyroscope `ProfilesRece
 <!-- START GENERATED SECTION: EXPORTERS OF Pyroscope `ProfilesReceiver` -->
 
 {{< collapse title="pyroscope" >}}
+- [pyroscope.enrich](../components/pyroscope/pyroscope.enrich)
 - [pyroscope.relabel](../components/pyroscope/pyroscope.relabel)
 - [pyroscope.write](../components/pyroscope/pyroscope.write)
 {{< /collapse >}}
@@ -437,6 +439,7 @@ The following components, grouped by namespace, _consume_ Pyroscope `ProfilesRec
 
 {{< collapse title="pyroscope" >}}
 - [pyroscope.ebpf](../components/pyroscope/pyroscope.ebpf)
+- [pyroscope.enrich](../components/pyroscope/pyroscope.enrich)
 - [pyroscope.java](../components/pyroscope/pyroscope.java)
 - [pyroscope.receive_http](../components/pyroscope/pyroscope.receive_http)
 - [pyroscope.relabel](../components/pyroscope/pyroscope.relabel)
diff --git a/docs/sources/reference/components/pyroscope/pyroscope.enrich.md b/docs/sources/reference/components/pyroscope/pyroscope.enrich.md
new file mode 100644
index 00000000000..6ea115b35ce
--- /dev/null
+++ b/docs/sources/reference/components/pyroscope/pyroscope.enrich.md
@@ -0,0 +1,178 @@
+---
+canonical: https://grafana.com/docs/alloy/latest/reference/components/pyroscope/pyroscope.enrich/
+description: Learn about pyroscope.enrich
+labels:
+  stage: experimental
+  products:
+    - oss
+title: pyroscope.enrich
+---
+
+# `pyroscope.enrich`
+
+{{< docs/shared lookup="stability/experimental.md" source="alloy" version="<ALLOY_VERSION>" >}}
+
+`pyroscope.enrich` enriches profiles with additional labels from service discovery targets.
+It matches a label from incoming profiles against a label from discovered targets, and copies specified labels from the matched target to the profile.
+
+## Usage
+
+```alloy
+pyroscope.enrich "<LABEL>" {
+  targets = <DISCOVERY_COMPONENT>.targets
+  target_match_label = "<LABEL>"
+  forward_to = [<RECEIVER_LIST>]
+}
+```
+
+## Arguments
+
+You can use the following arguments with `pyroscope.enrich`:
+
+| Name                   | Type                     | Description                                                                                   | Default | Required |
+| ---------------------- | ------------------------ | --------------------------------------------------------------------------------------------- | ------- | -------- |
+| `forward_to`           | `list(ProfilesReceiver)` | List of receivers to send enriched profiles to.                                               |         | yes      |
+| `target_match_label`   | `string`                 | The label from discovered targets to match against.                                           |         | yes      |
+| `targets`              | `list(Target)`           | List of targets from a discovery component.                                                   |         | yes      |
+| `labels_to_copy`       | `list(string)`           | List of labels to copy from discovered targets to profiles. If empty, all labels are copied. |         | no       |
+| `profiles_match_label` | `string`                 | The label from incoming profiles to match against discovered targets.                         |         | no       |
+
+If `profiles_match_label` isn't provided, `target_match_label` is used for matching profile labels.
+
+## Blocks
+
+`pyroscope.enrich` doesn't support any blocks.
+Configure this component with arguments.
+
+## Exported fields
+
+The following fields are exported and can be referenced by other components:
+
+| Name       | Type                 | Description                         |
+| ---------- | -------------------- | ----------------------------------- |
+| `receiver` | `ProfilesReceiver`   | The receiver for profiles.          |
+
+## Component health
+
+`pyroscope.enrich` is only reported as unhealthy if given an invalid configuration.
+
+## Debug information
+
+`pyroscope.enrich` exposes debug information about its state and enrichment activity.
+
+The following fields are available:
+
+| Field                    | Type        | Description                                                                |
+| ------------------------ | ----------- | -------------------------------------------------------------------------- |
+| `targets_cached`         | `int`       | The number of discovery targets currently cached for enrichment.           |
+| `profiles_processed`     | `uint64`    | The total number of profiles processed by the component.                   |
+| `profiles_enriched`      | `uint64`    | The number of profiles that were successfully enriched with target labels. |
+| `profiles_unmatched`     | `uint64`    | The number of profiles that couldn't be matched to a target.               |
+| `last_enrichment_time`   | `time.Time` | The timestamp of the last successful enrichment.                           |
+| `last_unmatched_value`   | `string`    | The match label value of the most recent unmatched profile.                |
+| `recent_matches`         | `list`      | The 10 most recent successful matches with timestamp and labels added.     |
+
+## Debug metrics
+
+`pyroscope.enrich` doesn't expose additional metrics.
+
+## Example
+
+This example enriches profiles received over HTTP with metadata from Kubernetes service discovery:
+
+```alloy
+// Discover Kubernetes pods
+discovery.kubernetes "pods" {
+  role = "pod"
+}
+
+// Add custom labels from Kubernetes metadata
+discovery.relabel "pods" {
+  targets = discovery.kubernetes.pods.targets
+  
+  rule {
+    source_labels = ["__meta_kubernetes_namespace"]
+    target_label  = "namespace"
+  }
+  
+  rule {
+    source_labels = ["__meta_kubernetes_pod_node_name"]
+    target_label  = "node"
+  }
+  
+  rule {
+    source_labels = ["__meta_kubernetes_pod_label_app"]
+    target_label  = "app"
+  }
+  
+  rule {
+    source_labels = ["__meta_kubernetes_pod_label_environment"]
+    target_label  = "environment"
+  }
+  
+  rule {
+    source_labels = ["__meta_kubernetes_pod_ip"]
+    target_label  = "pod_ip"
+  }
+}
+
+// Receive profiles over HTTP
+pyroscope.receive_http "default" {
+  http {
+    listen_address = "0.0.0.0"
+    listen_port    = 4040
+  }
+  forward_to = [pyroscope.enrich.metadata.receiver]
+}
+
+// Enrich profiles with Kubernetes metadata
+pyroscope.enrich "metadata" {
+  targets               = discovery.relabel.pods.output
+  target_match_label    = "pod_ip"
+  profiles_match_label  = "service_name"
+  labels_to_copy        = ["namespace", "node", "app", "environment"]
+  forward_to            = [pyroscope.write.default.receiver]
+}
+
+// Write profiles to Pyroscope
+pyroscope.write "default" {
+  endpoint {
+    url = "http://pyroscope:4040"
+  }
+}
+```
+
+## Component behavior
+
+The component matches profiles to discovered targets and enriches them with additional labels:
+
+1. For each profile, it looks up the value of `profiles_match_label` from the profile's labels, or `target_match_label` if `profiles_match_label` isn't specified.
+1. It matches this value against the `target_match_label` in discovered targets.
+1. If a match is found, it copies the requested `labels_to_copy` from the discovered target to the profile. If `labels_to_copy` is empty, all labels are copied.
+1. The profile, enriched or unchanged, is forwarded to the configured receivers.
+
+{{< admonition type="caution" >}}
+By default, `pyroscope.enrich` is ready as soon as it starts, even if no targets are discovered.
+If profiles are sent to this component before the metadata is synced, they're passed through as-is, without enrichment.
+This is most likely to impact `pyroscope.enrich` on startup for a short time before the discovery components send a new list of targets.
+{{< /admonition >}}
+
+<!-- START GENERATED COMPATIBLE COMPONENTS -->
+
+## Compatible components
+
+`pyroscope.enrich` can accept arguments from the following components:
+
+- Components that export [Targets](../../../compatibility/#targets-exporters)
+- Components that export [Pyroscope `ProfilesReceiver`](../../../compatibility/#pyroscope-profilesreceiver-exporters)
+
+`pyroscope.enrich` has exports that can be consumed by the following components:
+
+- Components that consume [Pyroscope `ProfilesReceiver`](../../../compatibility/#pyroscope-profilesreceiver-consumers)
+
+{{< admonition type="note" >}}
+Connecting some components may not be sensible or components may require further configuration to make the connection work correctly.
+Refer to the linked documentation for more details.
+{{< /admonition >}}
+
+<!-- END GENERATED COMPATIBLE COMPONENTS -->
diff --git a/internal/component/all/all.go b/internal/component/all/all.go
index adcb28db54f..1b71ab1e624 100644
--- a/internal/component/all/all.go
+++ b/internal/component/all/all.go
@@ -164,6 +164,7 @@ import (
 	_ "github.com/grafana/alloy/internal/component/prometheus/scrape"                        // Import prometheus.scrape
 	_ "github.com/grafana/alloy/internal/component/prometheus/write/queue"                   // Import prometheus.write.queue
 	_ "github.com/grafana/alloy/internal/component/pyroscope/ebpf"                           // Import pyroscope.ebpf
+	_ "github.com/grafana/alloy/internal/component/pyroscope/enrich"                         // Import pyroscope.enrich
 	_ "github.com/grafana/alloy/internal/component/pyroscope/java"                           // Import pyroscope.java
 	_ "github.com/grafana/alloy/internal/component/pyroscope/receive_http"                   // Import pyroscope.receive_http
 	_ "github.com/grafana/alloy/internal/component/pyroscope/relabel"                        // Import pyroscope.relabel
diff --git a/internal/component/pyroscope/enrich/enrich.go b/internal/component/pyroscope/enrich/enrich.go
new file mode 100644
index 00000000000..599b58c3a7e
--- /dev/null
+++ b/internal/component/pyroscope/enrich/enrich.go
@@ -0,0 +1,202 @@
+// Package enrich provides the pyroscope.enrich component.
+package enrich
+
+import (
+	"context"
+	"sync"
+
+	"github.com/prometheus/prometheus/model/labels"
+
+	"github.com/grafana/alloy/internal/component"
+	"github.com/grafana/alloy/internal/component/discovery"
+	"github.com/grafana/alloy/internal/component/pyroscope"
+	"github.com/grafana/alloy/internal/featuregate"
+)
+
+func init() {
+	component.Register(component.Registration{
+		Name:      "pyroscope.enrich",
+		Stability: featuregate.StabilityExperimental,
+		Args:      Arguments{},
+		Exports:   Exports{},
+		Build: func(opts component.Options, args component.Arguments) (component.Component, error) {
+			return New(opts, args.(Arguments))
+		},
+	})
+}
+
+// Arguments configures the pyroscope.enrich component.
+type Arguments struct {
+	// The targets to use for enrichment
+	Targets []discovery.Target `alloy:"targets,attr"`
+
+	// Which label from targets to use for matching (e.g. "hostname", "ip")
+	TargetMatchLabel string `alloy:"target_match_label,attr"`
+
+	// Which label from profiles to match against (e.g. "hostname", "ip")
+	// If not specified, TargetMatchLabel will be used
+	ProfilesMatchLabel string `alloy:"profiles_match_label,attr,optional"`
+
+	// List of labels to copy from discovered targets to profiles. If empty, all labels will be copied.
+	LabelsToCopy []string `alloy:"labels_to_copy,attr,optional"`
+
+	// Where to forward profiles after enrichment
+	ForwardTo []pyroscope.Appendable `alloy:"forward_to,attr"`
+}
+
+type Exports struct {
+	Receiver pyroscope.Appendable `alloy:"receiver,attr"`
+}
+
+type Component struct {
+	opts    component.Options
+	args    Arguments
+	exports Exports
+
+	mut          sync.RWMutex
+	targetsCache map[string]labels.Labels
+	cacheMutex   sync.RWMutex
+
+	fanout *pyroscope.Fanout
+}
+
+func New(opts component.Options, args Arguments) (*Component, error) {
+	c := &Component{
+		opts:         opts,
+		args:         args,
+		targetsCache: make(map[string]labels.Labels),
+		fanout:       pyroscope.NewFanout(args.ForwardTo, opts.ID, opts.Registerer),
+	}
+
+	// Initialize the cache with provided targets
+	c.refreshCacheFromTargets(args.Targets)
+
+	// Create the receiver appendable that implements both Append and AppendIngest
+	c.exports.Receiver = &enrichAppendable{component: c}
+
+	opts.OnStateChange(c.exports)
+
+	return c, nil
+}
+
+// enrichAppendable implements pyroscope.Appendable to handle both Append and AppendIngest
+type enrichAppendable struct {
+	component *Component
+}
+
+func (e *enrichAppendable) Appender() pyroscope.Appender {
+	return e
+}
+
+func (e *enrichAppendable) Append(ctx context.Context, lbls labels.Labels, samples []*pyroscope.RawSample) error {
+	enrichedLabels := e.component.enrichLabels(lbls)
+	return e.component.fanout.Appender().Append(ctx, enrichedLabels, samples)
+}
+
+func (e *enrichAppendable) AppendIngest(ctx context.Context, profile *pyroscope.IncomingProfile) error {
+	enrichedLabels := e.component.enrichLabels(profile.Labels)
+
+	// Create enriched profile
+	enrichedProfile := &pyroscope.IncomingProfile{
+		RawBody:     profile.RawBody,
+		ContentType: profile.ContentType,
+		URL:         profile.URL,
+		Labels:      enrichedLabels,
+	}
+
+	return e.component.fanout.Appender().AppendIngest(ctx, enrichedProfile)
+}
+
+// Run implements component.Component.
+func (c *Component) Run(ctx context.Context) error {
+	<-ctx.Done()
+	return nil
+}
+
+func (c *Component) refreshCacheFromTargets(targets []discovery.Target) {
+	c.cacheMutex.Lock()
+	defer c.cacheMutex.Unlock()
+
+	c.targetsCache = make(map[string]labels.Labels, len(targets))
+
+	for _, target := range targets {
+		labelPairs := make([]labels.Label, 0)
+		target.ForEachLabel(func(k, v string) bool {
+			labelPairs = append(labelPairs, labels.Label{Name: k, Value: v})
+			return true
+		})
+
+		labelSet := labels.New(labelPairs...)
+		if matchValue := labelSet.Get(c.args.TargetMatchLabel); matchValue != "" {
+			c.targetsCache[matchValue] = labelSet
+		}
+	}
+}
+
+func (c *Component) enrichLabels(lbls labels.Labels) labels.Labels {
+	c.mut.RLock()
+	matchLabel := c.args.ProfilesMatchLabel
+	if matchLabel == "" {
+		matchLabel = c.args.TargetMatchLabel
+	}
+	labelsToCopy := c.args.LabelsToCopy
+	c.mut.RUnlock()
+
+	// Get the source value to match against discovered targets
+	sourceValue := lbls.Get(matchLabel)
+	if sourceValue == "" {
+		return lbls
+	}
+
+	// Look up matching target
+	c.cacheMutex.RLock()
+	targetLabels, found := c.targetsCache[sourceValue]
+	c.cacheMutex.RUnlock()
+
+	if !found {
+		return lbls
+	}
+
+	// Copy labels from target to profile labels
+	newLabelsBuilder := labels.NewBuilder(lbls)
+	if len(labelsToCopy) == 0 {
+		// If no specific labels are requested, copy all labels
+		targetLabels.Range(func(lbl labels.Label) {
+			newLabelsBuilder.Set(lbl.Name, lbl.Value)
+		})
+	} else {
+		// Copy only requested labels
+		for _, labelName := range labelsToCopy {
+			if value := targetLabels.Get(labelName); value != "" {
+				newLabelsBuilder.Set(labelName, value)
+			}
+		}
+	}
+
+	return newLabelsBuilder.Labels()
+}
+
+func (c *Component) Name() string {
+	return "pyroscope.enrich"
+}
+
+func (c *Component) Ready() bool {
+	return true
+}
+
+func (c *Component) Update(args component.Arguments) error {
+	newArgs := args.(Arguments)
+
+	c.mut.Lock()
+	c.args = newArgs
+	c.mut.Unlock()
+
+	// Update the targets cache with new targets
+	c.refreshCacheFromTargets(newArgs.Targets)
+
+	return nil
+}
+
+func (c *Component) Exports() component.Exports {
+	return &c.exports
+}
diff --git a/internal/component/pyroscope/enrich/enrich_test.go b/internal/component/pyroscope/enrich/enrich_test.go
new file mode 100644
index 00000000000..266239baf48
--- /dev/null
+++ b/internal/component/pyroscope/enrich/enrich_test.go
@@ -0,0 +1,208 @@
+package enrich
+
+import (
+	"context"
+	"testing"
+
+	"github.com/go-kit/log"
+	"github.com/prometheus/client_golang/prometheus"
+	"github.com/prometheus/prometheus/model/labels"
+	"github.com/stretchr/testify/require"
+
+	"github.com/grafana/alloy/internal/component"
+	"github.com/grafana/alloy/internal/component/discovery"
+	"github.com/grafana/alloy/internal/component/pyroscope"
+)
+
+func TestEnricher(t *testing.T) {
+	// Create basic component options
+	opts := component.Options{
+		Logger:        log.NewNopLogger(),
+		OnStateChange: func(e component.Exports) {},
+		Registerer: prometheus.NewRegistry(),
+	}
+
+	tests := []struct {
+		name           string
+		args           Arguments
+		inputLabels    labels.Labels
+		expectedLabels labels.Labels
+	}{
+		{
+			name: "label enrichment with target_labels and profiles_match_label",
+			args: Arguments{
+				Targets: []discovery.Target{
+					discovery.NewTargetFromMap(map[string]string{
+						"service": "test-service",
+						"env":     "prod",
+						"owner":   "team-a",
+						"foo":     "bar",
+					}),
+				},
+				TargetMatchLabel:   "service",
+				ProfilesMatchLabel: "service_name",
+				LabelsToCopy:       []string{"env", "owner"},
+			},
+			inputLabels: labels.FromStrings(
+				"service_name", "test-service",
+			),
+			// foo:bar is not added as it is not in the target labels.
+			expectedLabels: labels.FromStrings(
+				"service_name", "test-service",
+				"env", "prod",
+				"owner", "team-a",
+			),
+		},
+		{
+			name: "no match found. Copy profiles as is.",
+			args: Arguments{
+				Targets: []discovery.Target{
+					discovery.NewTargetFromMap(map[string]string{
+						"service": "different-service",
+						"env":     "prod",
+					}),
+				},
+				TargetMatchLabel:   "service",
+				ProfilesMatchLabel: "service_name",
+				LabelsToCopy:       []string{"env"},
+			},
+			inputLabels: labels.FromStrings(
+				"service_name", "test-service",
+				"foo", "bar",
+			),
+			expectedLabels: labels.FromStrings(
+				"service_name", "test-service",
+				"foo", "bar",
+			),
+		},
+		{
+			name: "copy all labels when target_labels is empty",
+			args: Arguments{
+				Targets: []discovery.Target{
+					discovery.NewTargetFromMap(map[string]string{
+						"service": "test-service",
+						"env":     "prod",
+						"owner":   "team-b",
+						"region":  "us-west",
+					}),
+				},
+				TargetMatchLabel: "service",
+				// ProfilesMatchLabel intentionally omitted as 'service' label exists in both.
+			},
+			inputLabels: labels.FromStrings(
+				"service", "test-service",
+			),
+			expectedLabels: labels.FromStrings(
+				"service", "test-service",
+				"env", "prod",
+				"owner", "team-b",
+				"region", "us-west",
+			),
+		},
+		{
+			name: "match using target_match_label when profiles_match_label is not specified",
+			args: Arguments{
+				Targets: []discovery.Target{
+					discovery.NewTargetFromMap(map[string]string{
+						"service": "test-service",
+						"env":     "prod",
+						"owner":   "team-c",
+					}),
+				},
+				TargetMatchLabel: "service",
+				// ProfilesMatchLabel intentionally omitted as 'service' label exists in both.
+				LabelsToCopy: []string{"env", "owner"},
+			},
+			inputLabels: labels.FromStrings(
+				"service", "test-service", // matches target_match_label
+				"original", "label",
+			),
+			expectedLabels: labels.FromStrings(
+				"service", "test-service",
+				"original", "label",
+				"env", "prod",
+				"owner", "team-c",
+			),
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			var receivedLabels labels.Labels
+			var receivedSamples []*pyroscope.RawSample
+
+			// Synchronous appendable – enrichment occurs inline; no goroutines needed.
+			testAppendable := pyroscope.AppendableFunc(func(_ context.Context, lbls labels.Labels, samples []*pyroscope.RawSample) error {
+				receivedLabels = lbls
+				receivedSamples = samples
+				return nil
+			})
+
+			// Build component with forward target.
+			tt.args.ForwardTo = []pyroscope.Appendable{testAppendable}
+			comp, err := New(opts, tt.args)
+			require.NoError(t, err)
+
+			testSamples := []*pyroscope.RawSample{{
+				ID:         "test-id",
+				RawProfile: []byte("test profile data"),
+			}}
+
+			// Invoke Append synchronously.
+			err = comp.exports.Receiver.Appender().Append(context.Background(), tt.inputLabels, testSamples)
+			require.NoError(t, err)
+
+			// Assert results directly.
+			require.Equal(t, tt.expectedLabels, receivedLabels)
+			require.Equal(t, testSamples, receivedSamples)
+		})
+	}
+}
+
+func TestUpdate(t *testing.T) {
+	testAppendable := pyroscope.AppendableFunc(func(ctx context.Context, lbls labels.Labels, samples []*pyroscope.RawSample) error {
+		return nil
+	})
+
+	comp, err := New(component.Options{
+		Logger:        log.NewNopLogger(),
+		OnStateChange: func(e component.Exports) {},
+		Registerer: prometheus.NewRegistry(),
+	}, Arguments{
+		ForwardTo: []pyroscope.Appendable{testAppendable},
+	})
+	require.NoError(t, err)
+
+	// Test updating targets
+	newTargets := []discovery.Target{
+		discovery.NewTargetFromMap(map[string]string{
+			"service": "new-service",
+			"env":     "prod",
+		}),
+	}
+
+	err = comp.Update(Arguments{
+		Targets:            newTargets,
+		TargetMatchLabel:   "service",
+		ProfilesMatchLabel: "service_name",
+		LabelsToCopy:       []string{"env"},
+		ForwardTo:          []pyroscope.Appendable{testAppendable},
+	})
+	require.NoError(t, err)
+}
+
+func TestName(t *testing.T) {
+	testAppendable := pyroscope.AppendableFunc(func(ctx context.Context, lbls labels.Labels, samples []*pyroscope.RawSample) error {
+		return nil
+	})
+
+	comp, err := New(component.Options{
+		Logger:        log.NewNopLogger(),
+		OnStateChange: func(e component.Exports) {},
+		Registerer: prometheus.NewRegistry(),
+	}, Arguments{
+		ForwardTo: []pyroscope.Appendable{testAppendable},
+	})
+	require.NoError(t, err)
+	require.Equal(t, "pyroscope.enrich", comp.Name())
+}

From 74c425d14bfb959584530fad4d21a12ac588e266 Mon Sep 17 00:00:00 2001
From: Andre Ziviani <7469258+AndreZiviani@users.noreply.github.com>
Date: Sat, 8 Nov 2025 10:00:27 -0300
Subject: [PATCH 2/2] chore: Improve docs

Co-authored-by: Clayton Cornell <131809008+clayton-cornell@users.noreply.github.com>
---
 .github/ISSUE_TEMPLATE/blank.yaml             |  1 +
 .github/ISSUE_TEMPLATE/bug_report.yaml        |  1 +
 .github/ISSUE_TEMPLATE/docs.yaml              |  1 +
 .github/ISSUE_TEMPLATE/feature_request.yaml   |  1 +
 .github/ISSUE_TEMPLATE/proposal.yaml          |  1 +
 .../components/pyroscope/pyroscope.enrich.md  | 33 ++++++++-----------
 .../component/pyroscope/enrich/enrich_test.go |  6 ++--
 7 files changed, 21 insertions(+), 23 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/blank.yaml b/.github/ISSUE_TEMPLATE/blank.yaml
index 6a7a0d1a6b0..3a7d1090503 100644
--- a/.github/ISSUE_TEMPLATE/blank.yaml
+++ b/.github/ISSUE_TEMPLATE/blank.yaml
@@ -181,6 +181,7 @@ body:
       - prometheus.scrape
       - prometheus.write.queue
       - pyroscope.ebpf
+      - pyroscope.enrich
       - pyroscope.java
       - pyroscope.receive_http
       - pyroscope.relabel
diff --git a/.github/ISSUE_TEMPLATE/bug_report.yaml b/.github/ISSUE_TEMPLATE/bug_report.yaml
index 7fc726d80fc..f57ef1e7a7d 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.yaml
+++ b/.github/ISSUE_TEMPLATE/bug_report.yaml
@@ -181,6 +181,7 @@ body:
       - prometheus.scrape
       - prometheus.write.queue
       - pyroscope.ebpf
+      - pyroscope.enrich
       - pyroscope.java
       - pyroscope.receive_http
       - pyroscope.relabel
diff --git a/.github/ISSUE_TEMPLATE/docs.yaml b/.github/ISSUE_TEMPLATE/docs.yaml
index e69a0a34300..7d180e92151 100644
--- a/.github/ISSUE_TEMPLATE/docs.yaml
+++ b/.github/ISSUE_TEMPLATE/docs.yaml
@@ -184,6 +184,7 @@ body:
       - prometheus.scrape
       - prometheus.write.queue
       - pyroscope.ebpf
+      - pyroscope.enrich
       - pyroscope.java
       - pyroscope.receive_http
       - pyroscope.relabel
diff --git a/.github/ISSUE_TEMPLATE/feature_request.yaml b/.github/ISSUE_TEMPLATE/feature_request.yaml
index 1f0956bd518..21249baed98 100644
--- a/.github/ISSUE_TEMPLATE/feature_request.yaml
+++ b/.github/ISSUE_TEMPLATE/feature_request.yaml
@@ -181,6 +181,7 @@ body:
       - prometheus.scrape
       - prometheus.write.queue
       - pyroscope.ebpf
+      - pyroscope.enrich
       - pyroscope.java
       - pyroscope.receive_http
       - pyroscope.relabel
diff --git a/.github/ISSUE_TEMPLATE/proposal.yaml b/.github/ISSUE_TEMPLATE/proposal.yaml
index 1adf8f6b83f..33957786843 100644
--- a/.github/ISSUE_TEMPLATE/proposal.yaml
+++ b/.github/ISSUE_TEMPLATE/proposal.yaml
@@ -181,6 +181,7 @@ body:
       - prometheus.scrape
       - prometheus.write.queue
       - pyroscope.ebpf
+      - pyroscope.enrich
       - pyroscope.java
       - pyroscope.receive_http
       - pyroscope.relabel
diff --git a/docs/sources/reference/components/pyroscope/pyroscope.enrich.md b/docs/sources/reference/components/pyroscope/pyroscope.enrich.md
index 6ea115b35ce..ee70c299e40 100644
--- a/docs/sources/reference/components/pyroscope/pyroscope.enrich.md
+++ b/docs/sources/reference/components/pyroscope/pyroscope.enrich.md
@@ -5,11 +5,16 @@ labels:
   stage: experimental
   products:
     - oss
+  tags:
+    - text: Community
+      tooltip: This component is developed, maintained, and supported by the Alloy user community.
 title: pyroscope.enrich
 ---
 
 # `pyroscope.enrich`
 
+{{< docs/shared lookup="stability/community.md" source="alloy" version="<ALLOY_VERSION>" >}}  
+
 {{< docs/shared lookup="stability/experimental.md" source="alloy" version="<ALLOY_VERSION>" >}}
 
 `pyroscope.enrich` enriches profiles with additional labels from service discovery targets.
@@ -34,10 +39,10 @@ You can use the following arguments with `pyroscope.enrich`:
 | `forward_to`           | `list(ProfilesReceiver)` | List of receivers to send enriched profiles to.                                               |         | yes      |
 | `target_match_label`   | `string`                 | The label from discovered targets to match against.                                           |         | yes      |
 | `targets`              | `list(Target)`           | List of targets from a discovery component.                                                   |         | yes      |
-| `labels_to_copy`       | `list(string)`           | List of labels to copy from discovered targets to profiles. If empty, all labels are copied. |         | no       |
+| `labels_to_copy`       | `list(string)`           | List of labels to copy from discovered targets to profiles. If empty, all labels are copied.  |         | no       |
 | `profiles_match_label` | `string`                 | The label from incoming profiles to match against discovered targets.                         |         | no       |
 
-If `profiles_match_label` isn't provided, `target_match_label` is used for matching profile labels.
+If `profiles_match_label` isn't provided, the component uses `target_match_label` for matching profile labels.
 
 ## Blocks
 
@@ -58,19 +63,7 @@ The following fields are exported and can be referenced by other components:
 
 ## Debug information
 
-`pyroscope.enrich` exposes debug information about its state and enrichment activity.
-
-The following fields are available:
-
-| Field                    | Type        | Description                                                                |
-| ------------------------ | ----------- | -------------------------------------------------------------------------- |
-| `targets_cached`         | `int`       | The number of discovery targets currently cached for enrichment.           |
-| `profiles_processed`     | `uint64`    | The total number of profiles processed by the component.                   |
-| `profiles_enriched`      | `uint64`    | The number of profiles that were successfully enriched with target labels. |
-| `profiles_unmatched`     | `uint64`    | The number of profiles that couldn't be matched to a target.               |
-| `last_enrichment_time`   | `time.Time` | The timestamp of the last successful enrichment.                           |
-| `last_unmatched_value`   | `string`    | The match label value of the most recent unmatched profile.                |
-| `recent_matches`         | `list`      | The 10 most recent successful matches with timestamp and labels added.     |
+`pyroscope.enrich` doesn't expose debug information.
 
 ## Debug metrics
 
@@ -148,13 +141,13 @@ The component matches profiles to discovered targets and enriches them with addi
 
 1. For each profile, it looks up the value of `profiles_match_label` from the profile's labels, or `target_match_label` if `profiles_match_label` isn't specified.
 1. It matches this value against the `target_match_label` in discovered targets.
-1. If a match is found, it copies the requested `labels_to_copy` from the discovered target to the profile. If `labels_to_copy` is empty, all labels are copied.
-1. The profile, enriched or unchanged, is forwarded to the configured receivers.
+1. When it finds a match, it copies the requested `labels_to_copy` from the discovered target to the profile. If `labels_to_copy` is empty, it copies all labels.
+1. The component forwards the profile, enriched or unchanged, to the configured receivers.
 
 {{< admonition type="caution" >}}
-By default, `pyroscope.enrich` is ready as soon as it starts, even if no targets are discovered.
-If profiles are sent to this component before the metadata is synced, they're passed through as-is, without enrichment.
-This is most likely to impact `pyroscope.enrich` on startup for a short time before the discovery components send a new list of targets.
+By default, `pyroscope.enrich` is ready as it starts, even if discovery doesn't find targets.
+If you send profiles to this component before the metadata synchronizes, the component passes them through as-is, without enrichment.
+This is most likely to impact `pyroscope.enrich` on startup for a short time before discovery components send a list of targets.
 {{< /admonition >}}
 
 <!-- START GENERATED COMPATIBLE COMPONENTS -->
diff --git a/internal/component/pyroscope/enrich/enrich_test.go b/internal/component/pyroscope/enrich/enrich_test.go
index 266239baf48..ccac111193c 100644
--- a/internal/component/pyroscope/enrich/enrich_test.go
+++ b/internal/component/pyroscope/enrich/enrich_test.go
@@ -19,7 +19,7 @@ func TestEnricher(t *testing.T) {
 	opts := component.Options{
 		Logger:        log.NewNopLogger(),
 		OnStateChange: func(e component.Exports) {},
-		Registerer: prometheus.NewRegistry(),
+		Registerer:    prometheus.NewRegistry(),
 	}
 
 	tests := []struct {
@@ -167,7 +167,7 @@ func TestUpdate(t *testing.T) {
 	comp, err := New(component.Options{
 		Logger:        log.NewNopLogger(),
 		OnStateChange: func(e component.Exports) {},
-		Registerer: prometheus.NewRegistry(),
+		Registerer:    prometheus.NewRegistry(),
 	}, Arguments{
 		ForwardTo: []pyroscope.Appendable{testAppendable},
 	})
@@ -199,7 +199,7 @@ func TestName(t *testing.T) {
 	comp, err := New(component.Options{
 		Logger:        log.NewNopLogger(),
 		OnStateChange: func(e component.Exports) {},
-		Registerer: prometheus.NewRegistry(),
+		Registerer:    prometheus.NewRegistry(),
 	}, Arguments{
 		ForwardTo: []pyroscope.Appendable{testAppendable},
 	})