Pull Model dashboard

Overview

The Pull Model dashboard gives you an aggregate, visual view of your business process data queried from external data sources — Azure Application Insights, Log Analytics, or Azure Data Explorer (ADX). Where the Tracking tab shows individual transaction instances, the dashboard surfaces trends: transaction volumes over time, top property values, and resource-level counts — all rendered as charts across a configurable time window.

Each Pull Model business process has its own set of dashboards. Each dashboard is made up of widgets you define, with each widget backed by a query against a connected data source or a configured transaction.

Business value

Dashboards answer operational questions at a glance — how many transactions completed in the last 24 hours, which resource is generating the most activity, whether volumes are trending up or down — without requiring you to query the Tracking view manually. Teams can build dashboards tailored to their specific KPIs and share a consistent view of integration health across the business process.

How it works

A dashboard contains one or more widgets. Each widget is configured with a querying type, a data source or transaction, a report type, and a chart type. When the dashboard loads, BAM executes the widget queries and renders the results as charts.

To get started, navigate to your Pull Model business process and select the Dashboard tab.

Widget configuration

Each widget is configured through the Widget configuration panel. Click + Add widget to open the panel.

Querying type

Widgets support two querying types: Transaction and Resource.

Transaction — queries data using a pre-configured transaction defined in this business process as the base. Select a transaction from the Select transaction dropdown. You can optionally refine the query using the Query field.

Resource — queries a data source directly. Select the resource type from the Resource type dropdown: Application insight, Log analytics, or Azure data explorer.

Report type

Each widget renders its query results using one of the following report types:

Chart type

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.

Property name

For the Transaction querying type, the Property name field lets you select which query result property to use as the data dimension for the widget (for example, timestamp for time-based plots).

Prerequisites

Required permissions

Steps

Use the following steps to create a dashboard and add widgets. Navigate to your Pull Model business process and select the Dashboard tab to get started.

Create a dashboard

Creating a dashboard gives you a named canvas to which you can add widgets.

1. Select the Dashboard tab within your business process.
2. Click Name your dashboard and enter a display name.
3. Click + Add widget to add the first widget.

Add a widget

Adding a widget defines a query and visualization for one data dimension on the dashboard.

1. Click + Add widget to open the Widget configuration panel.
2. Enter a Name for the widget.
3. Select the Querying type:
   • Transaction — select a transaction from the Select transaction dropdown. Optionally enter a value in the Query field to filter results.
   • Resource — select the Resource type (Application insight, Log analytics, or Azure data explorer), then select the specific resource from the dropdown that appears.
4. Select a Report type — Time series, Top chart, Multi time series, or Count.
5. For the Transaction querying type, select a Property name to use as the data dimension.
6. Select a Chart type — Line, Bar, or Column.
7. Click + Add widget to save the widget to the dashboard.

Delete a widget

1. Locate the widget on the dashboard.
2. Click the delete or remove option on the widget.
3. Confirm the deletion.

Troubleshooting

1. Widget shows no data after saving
   Cause: The selected transaction may have no instances in the queried time window, or the data source may not be returning results for the configured query.
   Fix: Verify that the transaction has recent instances in the Tracking tab. For Resource widgets, confirm the selected resource is connected and returning data. Check that the query is valid and returns results when executed in App Insights, Log Analytics, or ADX directly.

2. Transaction dropdown is empty when configuring a widget
   Cause: No transactions have been configured in this business process yet.
   Fix: Configure at least one transaction under the Transactions tab before adding Transaction-type widgets to the dashboard.

3. Resource type dropdown shows no resources
   Cause: No data sources of the selected type have been connected to the BAM environment.
   Fix: Confirm the data source is registered and accessible from the BAM service principal. See the service principal setup article for the Pull Model.

4. Widget renders but chart appears empty
   Cause: The report type or property name may not match the structure of the query results.
   Fix: Review the selected Property name and ensure it corresponds to a column returned by the transaction or resource query. Switch the Report type to Count to verify data is being returned at all.

5. Dashboard does not reflect recent transaction activity
   Cause: Pull Model data is retrieved on a schedule. The dashboard reflects data available at the last query execution interval.
   Fix: This is expected behavior. The dashboard updates as new query results become available. No action required unless data is missing beyond the expected query interval.

Related articles

• Understanding the Pull Model
• Managing business transactions
• Push Model dashboard
• Push Model vs Pull Model