Bucket

Bucket (bucket)

Assign numeric values to named buckets using ordered thresholds.

Transform json

Minimal example

actions:
  - bucket:
      field: ""

JSON

{
  "actions": [
    {
      "bucket": {
        "field": ""
      }
    }
  ]
}

Contents

• Minimal example

• Fields

• Schema

A ✓ marks a field that accepts a context variable such as {{ VARIABLE }}.

Fields

Field	Type	Required	Description
description	string		describe this step.
condition	lua-expression (string)		Only run this action if the specified condition is met. Examples: 2 * count()
field	field (string)	✅	Field containing the numeric value to evaluate. Examples: data_field
buckets	Buckets[]		Ordered bucket rules; the first matching rule wins.
default-label	string		Label applied when no rule matches.
output-field	field (string)		Field that receives the bucket label (defaults to overwriting the source field). Examples: data_field
emit-bounds ✓	boolean (bool)		Emit the numeric bounds alongside the bucket label. Default: false

Schema

• Buckets Fields

Buckets Fields

Field	Type	Required	Description
min ✓	number (string)		Inclusive lower bound when provided (parsed as a floating point value). Examples: 42, 1.2e-10
min-exclusive ✓	number (string)		Exclusive lower bound when provided. Examples: 42, 1.2e-10
max ✓	number (string)		Inclusive upper bound when provided. Examples: 42, 1.2e-10
max-exclusive ✓	number (string)		Exclusive upper bound when provided. Examples: 42, 1.2e-10
label	string	✅	Label applied when the bucket matches.