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.
For more information, see Zuora System Health prerequisites.
The following table provides definitions of the API metrics.
The number of API requests issued within a specified time range, and details of each of the requests.
Note that the Track ID column displays the values specified in the
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.
The response time data of the API requests within a specified time range. Available metrics include the following:
API Concurrency Limit
The concurrency limits data by request types within a specified time range.
Note that the Tracing Identifier column displays prefixes of the values specified in the
Note that you can configure notifications based on the API Failures, API Performance, or API Concurrency metrics. For more information, see Standard events for Zuora Central Platform.
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-Idprefixes, 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 also use the Response Time field to specify the range of the response time.
- 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.
- For operations that are triggered by Workflow, you can go to the Workflow Run pages by clicking the track ID of the operations in the API details table.