Overview
The Push Model dashboard gives you a real-time, aggregate view of your Custom Logging business processes. Where the Tracking page shows individual transaction instances, the dashboard surfaces trends, such as transaction volumes over time, failure rate patterns, and top property values, plotted as charts across a configurable time window.
Each business process has its own set of dashboards, each made up of widgets you define, with each widget backed by a query against your Custom Logging data, a report type, and a chart type.
Business value
Dashboards answer the operational questions you didn't know to ask, such as aggregate transaction health, failure rate trends, and top vendor or sender volumes, without requiring you to query the Tracking page manually. Teams working in supply chain, order processing, or finance can configure dashboards that reflect their specific KPIs. Because dashboards are exportable and importable, proven configurations can be replicated across business processes or shared with other teams.
Prerequisites
- A Push Model (Custom Logging) BAM environment deployed in your Azure subscription.
- At least one business process created in the Turbo360 portal.
Required permissions
| Action | Required permission |
|---|---|
| View dashboards and widgets | View dashboard |
| Create, edit, import, delete dashboards; set default dashboard | Manage dashboard |
How it works
A dashboard contains one or more widgets. Each widget is backed by a Custom Logging query, either against transaction instances or stage instances, and rendered using a selected report type and chart type. You choose whether the dashboard applies a single time window to all widgets (Global time span) or lets each widget control its own window (Widget time span).
When you create a business process, an Analytics Dashboard is automatically generated. This default dashboard includes widgets showing successful and failed transaction counts out of the box.
Widgets are drag-and-drop: you can reposition and resize them freely within the dashboard layout. Clicking a widget navigates you directly to the Tracking page with the query and time frame pre-applied, turning the dashboard into a shortcut for investigation.
Dashboard types
BAM supports two dashboard types, which control how time settings are applied across widgets. You select the type when creating a dashboard.
Global time span
A Global time span dashboard applies a single time window to all its widgets. Time settings appear in the dashboard header and control the data range for every widget simultaneously.
The visualization interval is set per widget during configuration and can be adjusted at any time. You can also specify a custom interval. The maximum supported interval is 30 days.
Time settings are user-specific. A user who customizes the time window sees their value; other users see the default.
Widget time span
A Widget time span dashboard lets each widget define its own time window independently. When this type is selected, a Days field appears in the widget configuration. Enter a value between 1 and 30 to control the data range for that widget.
Widget configuration
Each widget is configured through the Widget configuration panel. Click + Add widget to open it.
Querying type
Push Model widgets support two querying types:
- Transaction: queries data at the transaction instance level. Use this to visualise overall transaction volumes, failure rates, and transaction-level property distributions.
- Stage: queries data at the stage instance level. Use this to visualise activity at individual stage checkpoints within a transaction.
For both types, enter a query in the Query field. The Query dropdown provides saved query options to use as a starting point:
| Option | Description |
|---|---|
| with data | Returns transaction or stage instances that have data in the selected time window. |
| StageQuery | A pre-built query scoped to stage-level data. Available when Stage querying type is selected. |
| default | Returns all records without additional filtering. |
Report types
Each widget renders its query results using one of the following report types:
| Report type | Description |
|---|---|
| Time series | Plots transaction or stage count over time on the X-axis. Use this to visualise volumes and trends over the selected period. |
| Top chart | Ranks the most frequently occurring values for a tracked property. Use this to identify the highest-volume transactions, senders, or property values. |
| Multi time series | Like Time series, but groups results by an additional dimension. Use this to compare activity across transaction names, statuses, or property values simultaneously. |
| Count | Returns a single aggregate count for the queried data set. Use this for at-a-glance KPI widgets such as total failed transactions in the last 24 hours. |
Chart types
The following chart types are available for rendering widget data:
- Line: plots data as a continuous line. Best for time series trends.
- Bar: plots data as horizontal bars. Best for comparisons across categories.
- Column: plots data as vertical columns. Best for time-based volume comparisons.
Group by option
For Multi time series and Top chart report types, you can add a Group by dimension to break down data by a specific attribute:
| Group by | Use when |
|---|---|
| Transaction | You want to display transaction counts broken down by transaction name. |
| Status | You want to show transaction volumes grouped by their status (Success, Failure, InProgress). |
| Property | You want to group by a global or stage property value. Specify the property name in the widget configuration. |
Steps
Use the following steps to create dashboards and manage widgets. Navigate to your Push Model business process and select Dashboard to get started.
Create a dashboard
Creating a dashboard sets up the time span mode and canvas for your widgets.
- Navigate to your business process and select Dashboard.
- Click Add dashboard.
- Enter a name for the dashboard.
- Select the dashboard type: Global time span or Widget time span.
Add a widget
Adding a widget defines a query and visualization for one data dimension on the dashboard.
- Click + Add widget to open the Widget configuration panel.
- Enter a Name for the widget.
- Select the Querying type: Transaction or Stage.
- In the Query field, enter a query or select a saved query from the dropdown (
with data,StageQuery, ordefault). - Select a Report type: Time series, Top chart, Multi time series, or Count.
- For Multi time series or Top chart, optionally configure a Group by dimension.
- Select a Chart type: Line, Bar, or Column.
- Click + Add widget to save.
Edit a widget
Editing a widget lets you update its query, report type, or chart type without recreating it.
- Locate the widget on the dashboard.
- Click the Actions menu on the widget.
- Select Edit.
- Update the configuration as needed.
- Click Save.
Delete a widget
- Locate the widget on the dashboard.
- Click the Actions menu on the widget.
- Select Delete.
- Confirm the deletion.
Import and export a dashboard
Dashboards can be exported as JSON files and re-imported into the same or a different business process, making it easy to replicate or share dashboard configurations.
To export a dashboard:
- Navigate to the Dashboard section of your business process.
- Click Export.
- Enter a name for the exported JSON file.
- Save the file.
To import a dashboard:
- Navigate to the Dashboard section of your business process.
- Click Import.
- Select the JSON dashboard file to import.
- The dashboard is imported and immediately available.
Example scenario
A supply chain operations team tracks an Order Processing business process. They create two widgets on their main dashboard: a Top chart grouped by the SenderId global property to show the top vendors by transaction volume over the past 7 days, and a Multi time series grouped by Status to plot success versus failure rates across all transactions over the same period. When a spike in failures appears on the status widget, the team clicks it to navigate directly to the Tracking page with the failure query and time frame pre-loaded.
Limitations
- Import and export are available for Push Model (Custom Logging) business processes only.
- The Group by option is available for Custom Logging widgets only.
- The maximum data interval for any widget is 30 days.
- Time settings on a Global time span dashboard are user-specific; other users see the default values until they set their own.
Troubleshooting
-
Widget shows no data after creation
Cause: The query returns no results, or the time range does not cover any transaction activity.
Fix: Verify the query against known transaction data in the Tracking page and confirm the time window includes the period when transactions were recorded. -
Import button is not available
Cause: Import/export is only supported for Push Model (Custom Logging) business processes.
Fix: This feature is not available for Pull Model processes. Recreate the dashboard configuration manually. -
Group by option does not appear in widget configuration
Cause: Group by is only available for Multi time series and Top chart report types.
Fix: Switch the Report type to Multi time series or Top chart to access the Group by option. -
Clicking a widget does not navigate to the Tracking page
Cause: The widget uses a Count report type, which does not support click-through navigation.
Fix: Use Time series, Multi time series, or Top chart report types to enable click-through to the Tracking page. -
Exported dashboard does not import correctly into another business process
Cause: The imported dashboard references property names or transactions that do not exist in the target business process.
Fix: After import, review widget configurations and update property names or query references to match the target process.
FAQs
-
Can I have multiple dashboards for the same business process?
Yes. You can create as many dashboards as needed. Each has its own name, type, and widget set. -
What happens to the default Analytics Dashboard if I delete it?
It is not recreated automatically. You will need to create a new dashboard and widgets manually to restore aggregate transaction visibility. -
Can I share a dashboard between business processes?
Dashboards cannot be shared live between processes, but you can export a dashboard as JSON from one process and import it into another. Widget queries may need adjustment to match the target process's property names and transactions.