Skip to content

Expand Events

Expand Events (expand-events)

expand a single JSON document into multiple JSON events.

Transform json

Minimal example

actions:
- expand-events:
skip-list: []
JSON
{
"actions": [
{
"expand-events": {
"skip-list": []
}
}
]
}

Contents

Fields

FieldTypeRequiredDescription
skip-list Outputregex[] (string)JSON Pointer patterns (regex) to skip flattening when event-expand.
Examples: \d+[A-Z]*
description Generalstringdescribe this step.
condition Generallua-expression (string)Only run this action if the specified condition is met.
Examples: 2 * count()
suppress-warnings Warningsboolean (bool)Suppress warnings generated by this action.
input-field Inputfield (string)Field containing the payload to expand.
Examples: data_field
remove Outputboolean (bool)Remove the source field after expansion.
output-split-field Outputfield (string)Field used to emit each expanded record.
Examples: data_field
exclude-non-empty-arrays Outputboolean (bool)Exclude all arrays that are not empty after expansion.

General

Show fields
FieldTypeRequiredDescription
descriptionstringdescribe this step.
conditionlua-expression (string)Only run this action if the specified condition is met.
Examples: 2 * count()

Warnings

Show fields
FieldTypeRequiredDescription
suppress-warningsboolean (bool)Suppress warnings generated by this action.

Input

Show fields
FieldTypeRequiredDescription
input-fieldfield (string)Field containing the payload to expand.
Examples: data_field

Output

Show fields
FieldTypeRequiredDescription
skip-listregex[] (string)JSON Pointer patterns (regex) to skip flattening when event-expand.
Examples: \d+[A-Z]*
removeboolean (bool)Remove the source field after expansion.
output-split-fieldfield (string)Field used to emit each expanded record.
Examples: data_field
exclude-non-empty-arraysboolean (bool)Exclude all arrays that are not empty after expansion.