Skip to main content

APIs dashboard

Zuora

APIs dashboard

Zuora System Health dashboard for API (API dashboard) collects and displays data about API usage, failure, performance, and concurrency limit in near real time. It enables you to view all the APIs in your Zuora tenant within the last 7 days. You can leverage this dashboard to identify and troubleshoot request errors or issues that are related to performance or concurrency limits.

For more information about the System Health feature, see Zuora System Health.

Prerequisites

For more information, see Zuora System Health prerequisites.

API metrics

The following table provides definitions of the API metrics.

Metric

Description

API Usage

The number of API requests issued within a specified time range, and details of each of the requests.

  • The numbers of successful requests and failed requests by operation.
  • Detailed information about the requests, such as request time, request ID, HTTP method, and the path of each request.

API Failures

All the failed API requests issued within the specified time range.

Besides the detailed information of the failed requests, you can also view the response code and response body of each of the failed requests.

API Performance

The response time data of the API requests within a specified time range. Available metrics include the following:

  • P95: 95th percentile of the response time data
  • P90: 90th percentile of the response time data
  • P50: 50th percentile of the response time data

API Concurrency Limit

The concurrency limits data by request types within a specified time range.

  • The trend charts in the API Concurrency Limit tab display the maximum concurrency data of the selected intervals. For example, when Day is selected as the interval, the chart displays the maximum number of concurrent requests each day within the specified time range. 
  • The minimum unit of the interval is minute, which means when setting the interval to Minute, the charts display the maximum concurrency per minute.
  • See Concurrent request limit types for more information about request types.
  • You can use the Concurrency Top API Insights table to view detailed information about the maximum concurrency of the selected time range. The following information is available:

    • API Description
    • HTTP Method
    • Tracing Identifier
    • Total Requests
    • Avg Execution Time
    • Total Execution Time
    • Concurrency Limit Type

Note that the Tracing Identifier column displays prefixes of the values specified in the Zuora-Track-Id headers of the API requests. For example, for any API requests triggered by the Workflow service, the prefix “WF” will be displayed as the tracing identifier. If Zuora-Track-Id is not specified in the request, the Tracing Identifier field will display "--".

 

The API data for requests not issued to standard Zuora API endpoints are unavailable in the API dashboard.

View data in the APIs dashboard

The API dashboard is located under the System Health section in the left navigation. It contains four tabs that display the API usage, failures, performance, and concurrency limits data separately. 

After you open a tab in the dashboard, take the following steps to view the data:

1. Configure filters.

You can customize the data to be displayed by using the filters.

  • Click the Filters icon to expand the filter in the upper right of the dashboard.
  • Use the Time Frame, Start Time, and End Time fields to specify the time range. 
  • Use the API list to select the API operation you want to view. The drop-down list automatically lists the APIs issued in the specified time range.
  • Use the Response Code field to select a type of error code. This field is only available for the Failures data tab.
  • Use the Request ID field to specify the exact API request you want to view.
  • Use the Tracing Identifier field to select API requests with certain Zuora-Track-Id prefixes, which are the fields before the first hyphen in the tracking IDs. For example, if the tracking ID of the request is MUT-2e605612-3e5a-468f-b542-32268e07db0e”, the tracing identifier will be “MUT”. Selecting “MUT” in the Tracing Identifier filter will filter out all the requests that have a tracking ID starting with “MUT” .
  • Click Apply to apply the filters, or click Reset to go back to the default filter configuration.

Note that the available filtering fields vary depending on which data tab you are viewing. But when switching between two tabs, the values remain the same for the shared fields of these two tabs. 

2. Use the Summary pane to get an overview of the data.

The Summary pane displays a summary of the selected data. For example, on the Overview tab, Summary displays the following metrics of the selected API requests: 

  • Total number of requests that are issued.
  • Number of successful requests
  • Number of errored requests
  • Error rate

3. View the trend charts.

  • Select the time interval of the trend charts using the interval radio buttons on the top right of the chart. 

Note that available interval options vary based on the length of the selected time range. When the range is greater than 60 hours, only the Day interval is enabled.

  • When hovering over each time interval, you can view the breakdown data of that time range, which displays the change percentage compared to the previous interval.
  • On the Concurrency Limit tab, you can view when the concurrency exceeded the limit on the trend charts. You can click a time interval on one of the trend charts to view detailed information about all the API requests that constitute the maximum concurrency of that specified time interval in the table below.
  • For the Performance and Concurrency Limit tabs, you can choose to hide or display lines on the charts by clicking the corresponding icons of the lines.

4. Use the table below the bar chart to view detailed data within the selected time range. 

  • By default, the table displays all the data that meets the filtering conditions. You can narrow the scope down to a specific interval by clicking a bar in the chart.

Note that the Summary pane will be automatically updated to display the summary of the selected data set.

  • On the Overview and Failures tabs, you can view details of API errors, such as the HTTP status code and the response body, by clicking Details of a failed request.
  • For the  Concurrency Limit tab, after you’ve selected a time interval on any of the four trend charts, the table will display data on the maximum concurrency of the selected time interval. Initially, the table displays API operations that happened within the maximum concurrency minute. You can click the Total Requests field of an operation to view details of all the requests of that operation.
  • Use the filter on the top right of the table to list the data you want to view. When you finish configuring the filter, click Apply. Click Clear to reset the configuration.

You can use the filter to retrieve a specific API error by its request ID or filter by response code or HTTP method.

  • You can download the table as a CSV file by clicking the download icon  in the upper right of the table.
  • Some columns can be used to sort the data. You can click the header of a column to see if the data can be sorted by it.