Transform
Modify output from a preceding node in the runbook into a JSON format that Riverbed IQ Ops can use to provide input to another node. For example, transform the response from an HTTP Query node into a JSON format that Riverbed IQ Ops can use to display data in visualizations such as tables and charts.
A Transform node can follow and take input from these node types in a runbook sequence:
-
Decision Branch
-
HTTP Query
-
Transform
A Transform node can output data to these node types in a runbook sequence:
-
Decision Branch
-
Visualization
-
Transform
Properties
Node Label — Type an informative name for the Transform node. You can keep the system-provided default of "Transform" if you wish.
Debug — Select Debug if you want to receive debug data when the node executes.
Debug View
When debug is enabled for a Transform node, you can view detailed debug information in the Debug Runbook Flow dialog. The Transform node provides a specialized Inspect tab that organizes transform debug data into structured sections.
The Inspect tab displays transform input/output data with automatic validation of the rendered Liquid template against the expected output data format. The debug view includes:
-
Error and Warning banners: When a transform error is reported, an error banner is displayed at the top using red/danger styling for immediate visibility. Validation findings are displayed as warning banners with yellow/orange background.
-
Inbound Entity Section: The input data that was passed to the transform node. This section is collapsed by default and includes a copy button to quickly copy the content.
-
Rendered Template Section: The output data after the Liquid template has been rendered. This section is expanded by default and includes a copy button to quickly copy the content.
All sections are collapsible and are displayed only if data is available for them. For more information about debug views, see Runbook Debugging Features.
Output Data Definition Method
Select whether you want to manually define the transform output data definition or use a variable to define the output data definition.
Output Data Definition
Specify which data (properties and/or metrics) you want to forward to other runbook nodes via JSON.
Output Data Format — Choose Summarized or Time Series.
Output Data Properties — Choose a property to output and specify its data type and units. Click Add Property if you want to output more than one.
-
Name
-
Type
-
Unit
-
Add Property
Output Data Metrics — Choose a metric to output and specify its data type and units. (For Time Series output, you must have at least one metric.) Click Add Metric if you want to output more than one.
-
Name
-
Type
-
Unit
-
Add Metric
Transform Template
Type the Liquid template to use for generating JSON output. Click the Output Data Example tab to show a preview of what the Liquid template's output will look like.
Runbook Compatibility
Incident, Lifecycle, On-Demand, External (Webhook), Subflow