APM Insight Business Transaction widget
- Overview
- Accessing the APM Insight Business Transaction widget
- Selecting resource type
- Selecting metric type and metrics
- Chart types
- Graph types (grouping)
- Aggregation options
- Time period selection
- Resource selection
- Preview
- Saving widgets
- Dashboard rendering
- Editing widgets
- Deleting widgets
Overview
APM Insight Business Transaction widget lets you add custom metric visualization widgets to any dashboard in Applications Manager. Each widget displays performance trends and statistics for the resources you monitor, showing how metrics like Response Time, Throughput, and Error Rate change over time through interactive charts and summary values.
Build widgets by selecting resources (Applications, Instances, Transactions), choosing metrics to track, picking a graph type (Individual, Stacked, Consolidated), and applying an aggregation method (Average, Min, Max, Sum, Count) over a configurable time period. The builder currently supports APM Insight metrics (Application Performance Monitoring).
With APM Insight Business Transaction widget, you can visualize:
- Metric trends: Line, Area, and Bar charts that plot metric values over a selected time period, helping you spot patterns, spikes, and degradations.
- Metric statistics: Text widgets that display a single aggregated number (Average, Minimum, Maximum, Sum, or Count) for quick health checks without a chart.
- Multi-resource comparison: View metrics across multiple resources side-by-side (Individual), combined into one aggregated line (Consolidated), or layered on top of each other (Stacked).
Accessing the APM Insight Business Transaction widget
To open the APM Insight Business Transaction widget:
- Navigate to any Dashboard under the Home tab.
- Click Actions → Add Metric Widget(s).
The APM Insight Business Transaction widget page loads with empty filter dropdowns. Configure the filters step by step to define your widget.
The builder walks you through a guided filter flow. Each selection narrows the next:
- Resource Type - What kind of resource? (Application, Instance, Transaction)
- Metric Type - Which metric category? (Top Level, Transaction, Second Level)
- Metrics - Which metrics to plot? (select one or more)
- Chart Type - How to visualize? (Line, Area, Bar, or Text)
- Graph Type - How to group resources? (Individual, Consolidated, or Stacked)
- Aggregation - How to summarize? (Average, Maximum, Minimum, Sum, or Count)
- Time Period - Over what range? (Last 30 Minutes to Last 7 Days, or Custom)
- Resources - Which specific resources? (pick individually or use Advanced Filters)
Once configured, preview your widgets with live data, then save. Up to 10 widgets per session can be added to the dashboard in one go.
Note:
- Users with Admin and Delegated Admin roles can access the APM Insight Business Transaction widget.
- Users with a Demo role can configure and preview widgets, but saving is blocked.
Selecting resource type
The resource type defines the category of monitored entities whose metrics the widget will display. Select a resource type from the Resource Type dropdown to begin configuring the widget.
| Resource Type | Description |
|---|---|
| APM Insight Application | Application-level monitoring - the top-level entity in APM Insight. Metrics include Response Time, Throughput, Error Rate, and Apdex Score. |
| APM Insight Instance | Individual application instances (JVMs, Node.js processes). Metrics include Heap Usage, CPU Time, GC Count, and Thread Count. |
| APM Insight Transaction | Web transactions (URLs, API endpoints) within an application. Metrics include Transaction Response Time, Error Count, and Call Count. |
Selecting metric type and metrics
Metric type
After selecting a resource type, choose a Metric Type to filter the available metrics:
- Top Level Metrics: High-level performance metrics such as Response Time, Throughput, and Error Rate.
- Transaction: Transaction-specific metrics that track individual web transactions and API endpoints.
- Second Level Metrics: Deeper performance metrics for detailed analysis beyond the top-level indicators.
Changing the metric type resets the metrics dropdown and reloads it with the relevant options.
Metrics
Select one or more metrics from the Metrics dropdown. The dropdown supports multi-select, allowing you to choose multiple metrics to visualize in a single session.
Note:
- You can select up to 10 metrics at a time. Once the limit is reached, additional options are disabled until you deselect an existing metric.
- The total number of widgets produced (based on the combination of metrics, resources, and graph type) must not exceed 10.
Chart types
The APM Insight Business Transaction widget supports four chart types, each suited for different visualization needs. Select a chart type from the Chart Type dropdown.
| Chart Type | Description | Best For |
|---|---|---|
| Line | Displays time-series data as continuous lines connecting data points over time. Uses a continuous time axis with crosshair tooltips. | Trend analysis, multi-metric comparison |
| Area | Similar to Line charts, but with a semi-transparent fill (40% opacity) under the curve. Provides a visual sense of volume. | Volume trends, stacked resource comparison |
| Bar | Renders data as vertical bars at each time interval. Uses discrete (ordinal) time labels on the x-axis. | Discrete interval comparison |
| Text | Displays a single aggregated numeric value (no chart). Shows a large centered number with the metric unit. The widget is wider (3 columns) than chart widgets. | KPI dashboards, single-value monitoring |
Aggregation availability by chart type
| Feature | Line | Area | Bar | Text |
|---|---|---|---|---|
| Time-series data | Yes | Yes | Yes | No |
| Aggregate data | No | No | No | Yes |
| Multiple series | Yes | Yes | Yes | No |
| 95th percentile threshold | Yes | Yes | No | No |
| Legend table (Min/Max/Avg) | Yes | Yes | Yes | No |
| SUM aggregation | No | No | No | Yes |
| COUNT aggregation | No | No | No | Yes |
Graph types (grouping)
The graph type determines how resources are grouped in the chart and directly affects how many widgets are created. Select a graph type from the Graph Type dropdown.
| Graph Type | Description | Widgets Created |
|---|---|---|
| Individual | Each widget shows data for one resource. A separate widget is created for every metric and resource combination. | Metrics × Resources Example: 2 metrics × 3 resources = 6 widgets |
| Consolidated | All selected resources are merged into one aggregated series per metric. Creates one widget per metric. | Metrics Example: 2 metrics × 3 resources = 2 widgets |
| Stacked | Resources are rendered as stacked layers within a single chart. Creates one widget per metric. | Metrics Example: 2 metrics × 3 resources = 2 widgets |
Widget count decomposition example (2 metrics × 3 resources, Individual graph type):
| Widget | Metric | Resource | Chart |
|---|---|---|---|
| Widget 1 | Response Time | app-server-01 | Line |
| Widget 2 | Response Time | app-server-02 | Line |
| Widget 3 | Response Time | web-proxy-03 | Line |
| Widget 4 | Request Count | app-server-01 | Line |
| Widget 5 | Request Count | app-server-02 | Line |
| Widget 6 | Request Count | web-proxy-03 | Line |
Note:
- The total number of widgets per session must not exceed 10. If the combination exceeds the limit, a validation error is displayed and you must reduce your selection.
- For Text chart type, the Stacked option is not available. Only Individual and Consolidated are shown.
Aggregation options
The aggregation type determines how multiple data points are combined when computing values across time buckets. Select an aggregation from the Aggregation dropdown.
| Aggregation | Description | Use Case |
|---|---|---|
| Average | Mean value across the bucket interval. | Response time trends (smooths out spikes) |
| Maximum | Highest value in each time bucket. | Peak detection, worst-case monitoring |
| Minimum | Lowest value in each time bucket. | Baseline monitoring |
| Sum | Total sum of values in each time bucket. Available only for Text chart type. | Request count, error count |
| Count | Number of data points in each time bucket. Available only for Text chart type. | Activity frequency monitoring |
Time period selection
The time period controls the date/time range for which metric data is fetched. Select a preset range or specify a custom period from the Time Period dropdown.
Preset ranges
| Time Period | Range |
|---|---|
| Last 30 Minutes | Now − 30 minutes to Now |
| Last 1 Hour | Now − 1 hour to Now |
| Last 3 Hours | Now − 3 hours to Now |
| Last 6 Hours | Now − 6 hours to Now |
| Last 12 Hours | Now − 12 hours to Now |
| Last 24 Hours | Now − 24 hours to Now |
| Yesterday | Yesterday 00:00 to 23:59 |
| Last 7 Days | Now − 7 days to Now |
| Custom Range | User-defined start and end date/time |
Dashboard-level time period override
When a dashboard has its own time period set, the dashboard time period overrides the individual widget's saved time period at render time. If the dashboard time period is set to Widget Level Period, each widget uses its own saved time period.
Resource selection
Choose which specific resources the widget should display data for. There are two modes of resource selection:
Manual selection
Pick specific resources from the Resources dropdown. Select one or more resources to include in the widget.
Advanced Filters
Toggle the Advanced Filters option to define dynamic filter criteria instead of selecting resources manually. When Advanced Filters are enabled, the manual resource dropdown is hidden.
Advanced Filters let you build search criteria using conditions such as:
- Name equals - Match resources with an exact name (e.g., name = "MyApp").
- Name contains - Match resources containing a keyword (e.g., name contains "Server").
- Name not equals - Exclude resources by name.
You can combine multiple filter conditions using AND / OR operators to build complex criteria.
After defining the filter criteria, the system resolves matching resources dynamically. A message indicates the number of matched resources (e.g., "5 resource(s) matched the filter criteria."). Click View Resources to see the matching resources in a data table with columns for display name, type, IP address, resource ID, and probe display name.
Note:
- When Advanced Filters are used, the criteria is re-evaluated each time the widget renders on the dashboard. New resources that match the criteria in the future are automatically included.
- A mandatory TYPE filter is auto-added based on the selected resource type and cannot be removed.
- If the criteria matches 0 resources, an informational message is displayed: "No resources found matching the selected criteria. Adjust your advanced filters and try again."
Preview
Before saving, click the Preview button to see how the widgets will look with live data. The builder decomposes your selection into individual preview cards based on the graph type and displays each one with a chart.
- Individual: One preview card per metric × resource combination.
- Consolidated: One preview card per metric, showing the merged aggregated series.
- Stacked: One preview card per metric, showing stacked resource layers.
- Text: One preview card per metric, showing a single numeric value.
If you change any configuration after previewing, an overlay message appears on the preview cards: "Configuration changed. Click Preview to update." Click Preview again to refresh with the updated configuration.
Note:
- Preview is a read-only operation - no data is written to the database.
- If a preview card fails to load data, an error message is shown on the affected card while other cards render normally.
- All required fields must be filled before previewing. If any required field is empty, a validation error is displayed.
Saving widgets
After configuring and previewing the widgets, click Save to create all the widgets in a single operation. The widgets are added to the current dashboard and automatically positioned at the bottom of the existing layout.
Widget display names are auto-generated based on the graph type:
| Graph Type | Name Pattern | Example |
|---|---|---|
| Individual | MetricName - ResourceName | Response Time - App-1 |
| Consolidated | MetricName (Consolidated) | Response Time (Consolidated) |
| Stacked | MetricName | Response Time |
Note:
- All required fields (Resource Type, Metric Type, Metric, Chart Type, Graph Type, Aggregation, Time Period, and Resources) must be filled before saving.
- The total number of widgets must not exceed 10 per save operation.
- Saving is blocked for users with the Demo role.
Dashboard rendering
After saving, widgets render on the dashboard with their configured chart type and data. Each widget fetches live metric data for the selected resources and time period.
Interactive features
The following interactive features are available on rendered chart widgets (Line, Area, and Bar):
- Runtime chart type switching: Switch between Line, Area, and Bar chart types directly on the widget without editing the widget configuration.
- Data point markers: Toggle data point markers on or off to show individual data points on the chart.
- Table view: Switch to a table view to see the raw data values instead of the chart.
Statistics table
For time-series chart widgets (Line, Area, and Bar), a statistics table is displayed below the chart showing per-series metrics:
| Statistic | Description |
|---|---|
| Min | Minimum value across all data points in the series. |
| Max | Maximum value across all data points in the series. |
| Average | Mean of all data points in the series. |
| 95th Percentile | Value below which 95% of data falls. Useful for identifying outlier performance. |
Editing widgets
To edit an existing widget, click the Edit icon on the widget. The edit form opens with all fields pre-populated from the saved configuration.
Locked and editable fields
During editing, certain fields are locked and cannot be changed:
| Field | Editable? | Notes |
|---|---|---|
| Resource Type | No (Locked) | Cannot be changed after creation. |
| Metric Type | No (Locked) | Cannot be changed after creation. |
| Metric | Yes (Single-select only) | Switches to single-select mode in edit. You cannot add additional metrics. |
| Chart Type | Yes | You can switch between Line, Area, Bar, and Text. |
| Graph Type (Individual) | No (Locked) | Individual graph type is locked and cannot be changed. |
| Graph Type (Stacked/Consolidated) | Yes | You can switch between Stacked and Consolidated. |
| Aggregation | Yes | You can change the aggregation method. |
| Time Period | Yes | You can change the time period. |
| Advanced Filters | No (Locked) | Search criteria cannot be modified after creation. |
Deleting widgets
To remove a widget from the dashboard, click the Delete icon on the widget. The widget and its configuration are permanently removed from the dashboard.
If the deleted widget used Advanced Filters with a unique search criteria, the criteria is also cleaned up. If other widgets share the same search criteria, the criteria is preserved.
