Transition

Transition (transition)

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

Transform json

Minimal example

actions:
  - transition:
      watch: ""

JSON

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

Contents

• Minimal example

• Fields

• General

• Output

• Input

• Behaviour

• Diagnostics

• Persistence

Fields

Field	Type	Required	Description
watch Input	field (string)	✅	Field whose transitions are tracked. Examples: data_field
description General	string		Describe this step.
condition General	lua-expression (string)		Only run this action when the Lua condition evaluates to true. Examples: 2 * count()
marker Output	string		Marker written to new transition events.
time-field Input	field (string)		Field providing event timestamps. Examples: data_field
input-time Input	field (string)		Alternate field containing event timestamps (legacy alias). Examples: data_field
group-by Input	field (string)		Group transitions independently by this field. Examples: data_field
max-age Behaviour	duration (string)		Drop keys that have not changed within this duration.
max-age-marker Behaviour	string		Optional marker emitted when a key exceeds max-age.
threshold-count Behaviour	number (integer)		Require this many consecutive observations in the new state before emitting. Examples: 42, 1.2e-10
elapsed-output-field Output	field (string)		Field containing milliseconds since the previous transition. Examples: data_field
value-at-last-change-output-field Output	field (string)		Field capturing the previous value before the change. Examples: data_field
time-at-last-change-output-field Output	field (string)		Field capturing the timestamp of the last change. Examples: data_field
time-at-last-change-output-format Output	time-format (string)		Format string used when writing timestamps.
threshold-count-output-field Diagnostics	field (string)		Field capturing the current threshold counter value. Examples: data_field
candidate-transition-time-output-field Diagnostics	field (string)		Field recording the candidate transition time when still counting. Examples: data_field
persistent-state-file Persistence	path (string)		Optional on-disk snapshot of the transition state. Examples: /path/to/file, c:\users\joe\data\file.txt

General

Show fields

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

Output

Show fields

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.

Input

Show fields

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

Behaviour

Show fields

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

Show fields

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

Persistence

Show fields

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