Transition

Transition (transition)

Track field transitions, elapsed time since last change, and optional state metadata.

Stateful Transform json

Minimal example

actions:
  - transition:
      watch: ""

JSON

{
  "actions": [
    {
      "transition": {
        "watch": ""
      }
    }
  ]
}

Contents

• Minimal example

• Behaviour

• Diagnostics

• General

• Input

• Output

• Persistence

Behaviour

Behaviour

Field	Type	Required	Description
max-age	duration (string)		Drop keys that have not changed within this duration.
max-age-marker	string		Optional marker emitted when a key exceeds max-age.
threshold-count	number (integer)		Require this many consecutive observations in the new state before emitting. Examples: 42, 1.2e-10

Diagnostics

Diagnostics

Field	Type	Required	Description
threshold-count-output-field	field (string)		Field capturing the current threshold counter value. Examples: data_field
candidate-transition-time-output-field	field (string)		Field recording the candidate transition time when still counting. Examples: data_field

General

General

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()

Input

Input

Field	Type	Required	Description
watch	field (string)	✅	Field whose transitions are tracked. Examples: data_field
time-field	field (string)		Field providing event timestamps. Examples: data_field
input-time	field (string)		Alternate field containing event timestamps (legacy alias). Examples: data_field
group-by	field (string)		Group transitions independently by this field. Examples: data_field

Output

Output

Field	Type	Required	Description
marker	string		Marker written to new transition events.
elapsed-output-field	field (string)		Field containing milliseconds since the previous transition. Examples: data_field
value-at-last-change-output-field	field (string)		Field capturing the previous value before the change. Examples: data_field
time-at-last-change-output-field	field (string)		Field capturing the timestamp of the last change. Examples: data_field
time-at-last-change-output-format	time-format (string)		Format string used when writing timestamps.

Persistence

Persistence

Field	Type	Required	Description
persistent-state-file	path (string)		Optional on-disk snapshot of the transition state. Examples: /path/to/file, c:\users\joe\data\file.txt