Add customized log entries to the activity log by using a Log node in the message flow.
About this task
You can customize activity log entries by adding one or more Log nodes to a flow, with a variety of log levels, custom
messages, and custom fields.
Procedure
To configure a Log node in a flow, complete the following
steps:
- Add a Log node at the stage in the flow where you
want to capture relevant data from previous nodes or provide contextual information that you want to
send to the activity log.
- On the Basic tab of the node, click
Configure.
The Connector Discovery wizard opens, which you use to
define the entry to be added to the activity log.
- Set the Log level by either selecting one of the predefined levels
or by specifying a Custom value:
- Select the Log level from the following options:
- Error
- Log information about an unexpected situation or error in the flow. Errors are generally emitted
when an operation fails. This option results in an activity log entry at level
error
.
- Info
- Log an informational message at that step in the flow. This option results in an activity log
entry at level
info
.
- Debug
- Log detailed information for debugging purposes. This option results in an activity log entry at
level
info
with a debug
tag.
- Use the Custom field to specify a custom value (such as a JSONata
mapping) that references a field in the activity log entry, and which resolves to either
error
, info
, or debug
. This value is inserted as
a tag into the log entry. You can use this option to log a custom entry about something significant
that does not necessarily result in an HTTP error code being returned.
- In the Message detail field, specify the entry that you want to be
added to the activity log.
You can specify a hard-coded message (such as "Processing new
ServiceNow incident"), values set by mapping inputs, or both. To use mapping, click the
Insert mapping icon and then select an input from the displayed list of
available mappings. For example, you might want to include the
Flow name
, the
Flow invocation time
, and the
Integration server name
. For
example:
- Optionally, you can define additional fields to include in the log entry, by adding
properties in the Custom message fields section:
- Click Add property in the Custom message
fields section to display the property editor.
- Specify the property name and the data type of the property.
Any custom message fields that you define will appear as tags in the generated
activity log entry.
- Click Save to save the settings and return them to the Log node.