- Introduction
- Getting started
- Process modeling
- Process implementation
- Process operations
- Understanding Process operations
- Working with instance management
- Variables and element filtering
- Process monitoring
- Process optimization
- Reference information
Maestro user guide
Variables and element filtering
Filters
Variable filtering lets process owners and analysts filter process instances by variable values captured during execution (for example, invoice amount, region, or outcome). Use variable filters to segment execution results, troubleshoot behavior, and analyze business outcomes — not just technical metadata.
You can apply both basic filters (such as version and date range) and advanced filters (element- and variable-level filters) to refine the data shown on the Monitoring tab.
Filter the dashboard by:
- Version: Select the project version to visualize.
- Date range: Select the time period for which Maestro displays data.
- Status: Filter instances by status.
- Active instances: Running, Paused, Faulted
- Inactive instances: Cancelled, Completed
- All filters: Open the full filter panel and see all filtering options available for the selected process.
Configure element and variable filters
Use the Configure filtering option on the Monitoring tab to define advanced filters based on executed elements and process variables.
Filter by element
Filter data to show only process instances that executed a specific BPMN element. Maestro only lists elements that at least one instance executed.
Filter by variable
To filter by variables, configure variable filters directly from the Monitoring view.
-
From the Monitoring tab, select Configure filtering.
-
In the dialog, select the Variable field and choose one or more variables from the process variable list.
-
Select Select to open the Variable filter builder.
-
In the Variable filter builder:
- Choose whether all conditions or any condition must match.
- Add one or more variable conditions.
- Select an operator based on the variable type, such as equals, contains, starts with, ends with, not equal, is null, or is not null.
- Provide the comparison value.
-
Save the configuration to apply the filter to the Monitoring view.
- You configure variable filtering from the Monitoring view. Maestro does not require any canvas-level configuration to make variables available for filtering.
- The variable selector lists variables defined in the deployed process version. If a variable does not appear, verify that the correct version is selected in Monitoring.
- Element filters only list elements that at least one instance executed.
- Variable filters persist after you enable them and remain active until you remove them.
- Variable filtering applies only to instances that run after you enable the filter.
