OBSDOCS-1146: Documentation for the group-by-attribute processor

Signed-off-by: Ruben Vargas <[email protected]>

Author: rubenvp8510

observability/otel/otel-collector/otel-collector-processors.adoc

@@ -397,18 +397,18 @@ config: |
 You can optionally create an `attribute_source` configuration, which defines where to look for the attribute in `from_attribute`. The allowed value is `context` to search the context, which includes the HTTP headers, or `resource` to search the resource attributes.
 
 [id="cumulativetodelta-processor_{context}"]
-== Cumulative to Delta Processor
+== Cumulative-to-Delta Processor
 
-This processor converts monotonic, cumulative-sum, and histogram metrics to monotonic delta metrics.
+The Cumulative-to-Delta Processor processor converts monotonic, cumulative-sum, and histogram metrics to monotonic delta metrics.
 
 You can filter metrics by using the `include:` or `exclude:` fields and specifying the `strict` or `regexp` metric name matching.
 
 This processor does not convert non-monotonic sums and exponential histograms.
 
-:FeatureName: The Cumulative to Delta Processor
+:FeatureName: The Cumulative-to-Delta Processor
 include::snippets/technology-preview.adoc[]
 
-.Example of an OpenTelemetry Collector custom resource with an enabled Cumulative to Delta Processor
+.Example of an OpenTelemetry Collector custom resource with an enabled Cumulative-to-Delta Processor
 [source,yaml]
 ----
 # ...
@@ -430,3 +430,26 @@ config: |
 <2> Defines a value provided in the `metrics` field as a `strict` exact match or `regexp` regular expression.
 <3> Lists the metric names, which are exact matches or matches for regular expressions, of the metrics to be converted to delta metrics. If a metric matches both the `include` and `exclude` filters, the `exclude` filter takes precedence.
 <4> Optional: Configures which metrics to exclude. When omitted, no metrics are excluded from conversion to delta metrics.
+
+[id="groupbyattrsprocessor-processor_{context}"]
+== Group-by-Attributes Processor
+
+The Group-by-Attributes Processor groups all spans, log records, and metric datapoints that share the same attributes by reassigning them to a Resource that matches those attributes.
+
+:FeatureName: The Group-by-Attributes Processor
+include::snippets/technology-preview.adoc[]
+
+At minimum, configuring this processor involves specifying an array of attribute keys to be used to group spans, log records, or metric datapoints together, as in the following example:
+
+[source,yaml]
+----
+# ...
+processors:
+  groupbyattrs:
+    keys: # <1>
+      - <key1> # <2>
+      - <key2>
+# ...
+----
+<1> Specifies attribute keys to group by.
+<2> If a processed span, log record, or metric datapoint contains at least one of the specified attribute keys, it is reassigned to a Resource that shares the same attribute values; and if no such Resource exists, a new one is created. If none of the specified attribute keys is present in the processed span, log record, or metric datapoint, then it remains associated with its current Resource. Multiple instances of the same Resource are consolidated.