Send Docs Feedback

Business transactions

What does this dashboard tell me?

The Business Transactions Dashboard lets you monitor and visually compare traffic for specific API patterns across multiple API proxies. This information helps you understand changes in API traffic that might be caused by specific business, marketing, or partner events.

For example, suppose that your marketing team hosts a program that drives customers to a specific site. The URI pattern for that site will experience an increase in traffic, giving the team a way to measure the impact of the program in real time.   

The Business Transactions dashboard

Data delay interval
After API calls are made to proxies, it takes about 12 minutes for the data to appear in dashboards, custom reports, and management API calls.


What does this dashboard measure?

Metric Description
Traffic Also known as throughput. The number of API requests and resulting responses seen by the organization.
Average Response Time The time an API takes to respond to an incoming request.
Error Rate The fraction of all API requests that are unsuccessful, that is, the request does not deliver a response as desired by the end user.
Average Data Exchange The size of request and response. That is, the amount of data that is transferred in both directions as a request for an API, and as a response that is generated and delivered to the calling entity.

How do I set up this dashboard?

The Business Transactions dashboard requires the following setup steps:

  1. In the API Management menu, select API Proxies from the APIs menu. 
  2. In the API Proxies page, select the proxy you wish to measure. 
  3. On the far right, select the Performance tab. You will the data comparing the various proxies and URI Patterns. To set the URI patterns to compare, click the "Compare" button on the left-hand side of the page. From there, you can manage the patterns to compare. To add a pattern, click +Pattern. To remove a pattern, click the X associated to that pattern. For more details on configuring URI Patterns, see "Monitoring the performance of individual URIs in an API proxy".
  4. After adding a pattern, click the checkmark button to add the pattern. 
  5. From the Analytics menu, select Business Transaction Dashboard.
  6. Click the configuration (gear) icon next to the Business Transactions heading. The URI patterns for all APIs in your organization are listed there.
  7. Select the URI patterns you wish to compare and specify a date range.
  8. Click Save.

Add URI patterns from as many APIs as you wish.

Monitoring the performance of individual URIs in an API proxy

Patterns are compared to the path suffix. They should begin with a forward slash and can include the asterisk (*) wildcard to match a path segment.

For example, given a proxy base path of /v1/inventory and resource paths of:

  • /1
  • /abc/123
  • /abc/123/xyz
  • /abc/456/dec

...the full URL paths the clients use will be /v1/inventory/1 or /v1/inventory/abc/123/dec and so on. You will specify patterns to match only the path suffix, or resource paths. For example, you can specify these as patterns:

  • /1 - Collects metrics on the /1 URI
  • /abc/123/* - Collects metrics on any URI beginning with /abc/123, with a following segment
  • /abc/*/dec - Collects metrics on the /abc/123/dec and /abc/456/dec URIs

What else do I need to know about this dashboard?

This dashboard uses standard controls, like the date and data aggregation selectors, hovering over graphs for more context, and so on. To learn more, see Using the analytics dashboards.

Help or comments?