Skip to main content
Version: v6

Add new flows

Each folder can hold one or more 'flows'. These are message chains, an aggregation of all the messages that can be linked to the same incoming message. Flows are the functional representation of the message with an optional context property name and / or optional context property value.

Add/Edit a flow

create flow

Flow propertyRequiredDescription
1 Flow NameyesA case sensitive name that describe the client interaction (example: ex. invoice request, invoice approval, …)
2 FolderyesThe location of where to save the flow. Flows are always structured in folders.
3 MappingnoThe mapping that is used to 'map' flow traces to this flow. The DSAV mapping are special business properties that are treated differently during flow trace importing, loaded from 'tracked properties, for instance, when using importing them via Logic Apps.). A dedicated WorkflowName is added in those cases as well to map the flow traces of the Logic App workflow more easily to the flow.
4 Business PropertiesnoAdditional properties to describe the flow. These are only here to provide metadata and are not used in the flow tracing.
5 Advanced Settingsno
  • Connected Dashboard: if the flow has multiple Dashboards and it needs to connect to another Dashboard then this needs to be checked. For this setting to apply, the Connected Dashboard needs to be enabled by your Admin through the settings page of the Dashboard in order to switch on this feature.
  • Show milestone and event text: Checking this option will enable the flow milestone and event text data to be displayed.
  • Custom resubmit/resume URLs: Check these options and provide the necessary URLs to use your own resume and resubmit logic.

Permissions

To allow only certain users/groups to access the flows, you can assign permissions to the folder where the flow is located (available roles). System admins are automatically assigned to every folder available.

folder1

Choose the desired group from the first drop down menu. Only enabled Non Admin groups will be listed. Then, choose the role you want the group to have for that specific folder.

folder1

Alerting

warning

To manage alerts within Flows, make sure the necessary role assignments are set in your Invictus installation.

edit/delete flow

Alert propertyDescription
1 Alert NameThe name for the rule, must be unique per flow. (Name will automatically have the flow name added as a prefix to it.)
2 Severity

Identifies the severity of the alert:

  • Critical
  • Error
  • Warning
  • Informational
  • Verbose
3 Schedule
  • Frequency: how often the rule is executed - value must be between the range of 5-1440.
  • Time window: range that Azure uses, the logs for the last x minutes - value must be between the range of 5-2880.
4 TriggerThe Threshold value together with the Threshold Operator (Equal/GreaterThan/LessThan) defines when the alert rule should be triggered.
5 Throttling
  • Suppress alerts (minutes): suppress alerts for x minutes if alerts for a rule have been triggered.
6 Query

This value is used to select which type of query the alert rule will have AzureResultCount/InvictusActivityCheck/InvictusErrorCheck - AzureResultCount lets the user enter custom script which is accepted by the Azure Rule Syntax. The ones starting with Invictus... are pre-made scripts for the user to select without having to modify.

Invictus Activity Check

This query type will filter logs on Azure Logs by the InvictusImportJobFlowActivityAlert property. The backend will log activity for any flows that are active every hour. An example of how the alert settings for this flow could be set:

  • Frequency: 60
  • Time Window: 60
  • Trigger Threshold Operator: LessThan
  • Threshold: 0

This will create a rule to run every 60 minutes, scans the logs for the last 60 minutes and if the returned value is less than the threshold, it means that the flow is inactive, thus triggers the alert on Azure.

note

Please note that the backend will not increment the activity for each message that is processed for a flow. This simply sends a single log per hour for each flow that is active, the count might be higher than one per hour due to scaling situations and multi-threaded scenarios. The logging frequency for the backend can be increased by reducing the following value: FlowActivityIntervalInMinutes. This can be passed to the Bicep template during deployment.

Invictus Error Check

This query type will filter logs on Azure Logs by the "InvictusImportJobFlowErrorAlert" property. The backend will log a message for each Flow that triggers an error. An example of how the alert settings for this flow could be set:

  • Frequency: 10
  • Time Window: 10
  • Trigger Threshold Operator: GreaterThan
  • Threshold: 0 This will create a rule to run every 10 minutes, scans the logs for the last 10 minutes and if the returned value is greater than the threshold, it means that the flow has failed messages, thus triggers the alert on Azure.
AzureResultCount

This will enable custom scripts with the Azure Alert syntax. If you require further information about this type of syntax please refer to the official documentation by Microsoft.

7 RecipientsThe email recipients to notify when the alert rule is triggered.