Transaction

Transaction (`transaction`)

Sessionize related events using start/end markers and optional summary fields.

Stateful Transform json

actions:
  - transaction: {}

JSON

{
  "actions": [
    {
      "transaction": {}
    }
  ]
}

Field	Type	Required	Description
`use-document-marker` ✓	`boolean` (`bool`)		Treat document boundaries as transaction markers. Default: `false`

Field	Type	Required	Description
`start`	`string`		Field/pattern (e.g. “type:start”) that opens a transaction.
`end`	`string`		Field/pattern that closes a transaction.

Field	Type	Required	Description
`description`	`string`		Describe this step.
`condition`	`lua-expression` (`string`)		Only run this action when the Lua condition evaluates to true. Examples: `2 * count()`

Field	Type	Required	Description
`group-by`	`field` (`string`)		Group sessions independently by this field. Examples: `data_field`

Field	Type	Description
`marker`	`string`	Marker placed on emitted transaction envelopes.
`common-fields`	`string[]`	Common fields copied from each record to the transaction envelope.
`combined-output` ✓	`boolean` (`bool`)	Emit a single combined event for the session instead of individual events. Default: `false`
`combined-payload` ✓	`boolean` (`bool`)	When true, attach the payload array under `_payload`. Default: `false`

Field	Type	Required	Description
`session-summary`	`Transaction Session Summary`		Optional session summary output (counts, durations, numeric stats).

Field	Type	Required	Description
`timeout-field`	`string`		Marker emitted when upstream stalled events close an open transaction.
`idle-timeout`	`duration` (`string`)		Idle timeout that auto-closes sessions without explicit end markers (e.g. “5m”).

Field	Type	Required	Description
`field`	`field` (`string`)	✅	Field to analyse across the session. Examples: `data_field`
`ops`	`Transaction Session Metric Operation[]`		Operations to compute for the numeric field. Allowed values: `min`, `max`, `sum`, `mean`, `stddev`
`prefix`	`string`		Optional prefix applied to emitted metric fields.

Field	Type	Description
`event-count-field`	`field` (`string`)	Output field containing the number of events in the session. Examples: `data_field`
`duration-field`	`field` (`string`)	Output field containing the session duration in milliseconds. Examples: `data_field`
`numeric-fields`	`Transaction Session Numeric Field[]`	Numeric fields to summarise with the configured operations.