# GroupBy
**Source definition:** [`src/bitdrift/public/unary/workflows/v1/workflow.proto#L20-L56`]()
| Field | Type | Description |
|---|---|---|
| values | array of [bitdrift.public.unary.workflows.v1.GroupBy.Value](#bitdrift.public.unary.workflows.v1.GroupBy.Value "bitdrift.public.unary.workflows.v1.GroupBy.Value")
up to 100 items | Dimensions to collect for each emitted metric. Each entry adds one or more dimensions. For example, grouping an error-count time series by `error_type` makes that error type value available alongside the charted metric data. |
Example
```json
{
"values": [
{
"log_body": false
}
]
}
```
# GroupBy.StateValue
**Source definition:** [`src/bitdrift/public/unary/workflows/v1/workflow.proto#L21-L30`]()
| Field | Type | Description |
|---|---|---|
| scope | [bitdrift.public.unary.workflows.v1.StateScope](bitdrift_public_unary_workflows_v1_StateScope.md "bitdrift.public.unary.workflows.v1.StateScope")
must be a defined enum value | The scope of the state value to read when producing the group-by dimension. |
| key | string
up to 100 chars | The key of the state value to read within the selected scope. |
Example
```json
{
"key": "example-key",
"scope": "FEATURE_FLAG_EXPOSURE"
}
```
# GroupBy.Value
**Source definition:** [`src/bitdrift/public/unary/workflows/v1/workflow.proto#L35-L50`]()
One additional dimension to attach to emitted metrics for a chart time series. Exactly one
source must be chosen. Each emitted metric will include the extracted value under the
resulting dimension name so that value is available alongside the charted series.
| Field | Type | Description |
|---|---|---|
| field_key | string
up to 100 charsonly one of field_key, or log_body, state_value can be set | The value of the named log field from the event that produced the metric. The field name also becomes the dimension name on the emitted metric. |
| log_body | boolonly one of log_body, or field_key, state_value can be set | The full log message body as the dimension value. This only applies to log events. |
| state_value | [bitdrift.public.unary.workflows.v1.GroupBy.StateValue](#bitdrift.public.unary.workflows.v1.GroupBy.StateValue "bitdrift.public.unary.workflows.v1.GroupBy.StateValue")only one of state_value, or field_key, log_body can be set | A value read from state using the provided scope and key. The key becomes the dimension name on the emitted metric. |
Example
```json
{
"log_body": false
}
```