Thank you for your feedback.
Form temporarily unavailable. Please try again or contact docfeedback@servicenow.com to submit your comments.
Versions
  • London
  • Kingston
  • Jakarta
  • Istanbul
  • Helsinki
  • Geneva
  • Store
Close

Flow execution details

Flow execution details

View runtime information about a flow directly from the design environment such as the current state, actions run, and values produced. Open related records from embedded Now Platform editors or in a new tab.

Each time a flow runs, the system stores information about the configuration and runtime values produced, which process analysts can view from the Flow Designer design environment Flow Executions tab. Select a flow execution to open its associated execution details page.

To disable the flow execution details, add the com.snc.process_flow.reporting.enabled system property to the System Properties [sys_properties] table and set the value to false. If disabled, details are not saved for actions in the flow. However, the flow context record and related log messages are available. If a flow runs while the property is false, execution details are never available for the flow, even if the property value changes. If a flow runs while the property is true, execution details are always available for the flow, even if the property value changes.

Figure 1. Sample execution details of the VTB Sample Flow
Sample execution details
Each execution details page displays:
  • Calling source
  • Flow state
  • Related record options
  • Flow Statistics

Calling source

The calling source lists what started a flow or subflow.

Source Description
Flow Designer Test The flow started because a user selected the Test option from the Flow Designer interface. The flow trigger conditions were ignored.
CRUD Trigger The flow started when the record-based trigger conditions were met.
Scheduled Trigger The flow started when the schedule-based trigger conditions were met.
Metric Trigger The flow started when the MetricBase trigger conditions of a MetricBase application were met.
Service Catalog Trigger The flow started when a Service Catalog item was requested.
Script The flow started from an API method call in a script, such as a business rule.
Background Script The flow started from an API method call in the Scripts - Background module.

Flow state

All active flows are in one of these states.

Completed
The flow successfully ran all actions. The flow statistics display configuration and run-time details for each action.
Waiting
The flow paused on an action that is waiting for some condition to be met before continuing. The flow statistics display configuration and run-time details for completed actions and configuration details for any actions waiting for a condition to be met. Flows in the Waiting state display a Cancel Flow UI action in the header.
Error
The flow stopped with an error. The flow statistics display configuration and run-time details for completed actions and configuration details for the action that produced the error. Flows in the Error state display a Go to error UI action in the header.

Related record options

From the Execution details page, you can access records related to the current flow.

Refresh Flow Data
Use this option to update flow runtime data.
Open Flow
Use this option to make configuration changes and publish a new instance of the flow. Changing the flow configuration does not change any currently active flow.
Open Context Record
Use this option to view the flow state, run duration, and related log entries from a standard form view. This option opens the context record in a new tab.
Open Flow Logs
Use this link to view detailed log information about each action. This link opens the log entries list in a new tab.
Open Current Record
For flows that have a record-based trigger, use this link to view the triggering record in a pop-up window.
Open Action
Use this link to make configuration changes and publish a new instance of the action. Changing the action configuration does not change any currently active flow. This link is unavailable for ServiceNow-provided core actions.

Flow statistics

Use flow statistics to see configuration details and run-time values for each flow component. Clicking a trigger or action expands the row and displays configuration and run-time details about it.

Figure 2. Sample flow statistics of the VTB Sample Flow
Sample flow statistics

The following types of execution details are available.

Integration Metadata
Use Integration Metadata to view transaction data such as connection and credential used, target host, and payload size. Integration Metadata only displays for integration steps and requires a separate IntegrationHub subscription. For more information, see Integration steps.
Configuration Details
Use the list of input variables to identify any configuration errors with the action. Each variable has its own row displaying its name, data type, configuration settings, and run-time value. The configuration settings display dynamic values as pills. The run-time values display generated records as a link.
Output Data
Use the list of output variables to identify any configuration errors with the action.
Logs
Use the log entries to identify potential processing or performance issues. Each log entry has its own row displaying the creation date, log level, and log message. If the action does not generate any logs, the statistics displays the string No Logs.
Steps

Use the list of steps to identify any configuration errors with the action. Each step has its own row displaying the variable name, data type, configuration settings, and run-time value. Core actions do not display steps because users cannot change their configuration.

Change the com.snc.process_flow.reporting.serialized.val_size_limit system property to truncate runtime values in the flow execution details step configuration. To learn more, see Flow Designer system properties.

Run duration
Use the run duration to identify potential processing or performance issues. Each action and step displays the duration in milliseconds. System quota rules prevent any action from running longer than a minute.

Embedded text viewer

Flow Designer displays large text-based configuration and runtime output records such as email output, XML payloads, or script steps using an embedded text viewer. The embedded text viewer can format text as HTML, plain text, or color-coded JavaScript. For script steps, the text viewer highlights code lines containing errors.

Figure 3. Sample text view of a script step
Sample script

Viewing results for each item in flow logic

Flow Designer displays a selector control to view the configuration and run-time results for each item processed by flow logic. Select a record number to see its configuration and run-time details.

Figure 4. Sample flow statistics for each item in flow logic
For Each flow logic