Prerequisites

For more information, see Zuora System Health prerequisites.

Access Aggregate Query API (AQuA) dashboard

To access the Aggregate Query API (AQuA) dashboard, navigate to Administration > System Health > Aggregate Query API (AQuA) in the left navigation menu.

View data in the AQuA dashboard

The AQuA dashboard is located under the Administration > System Health section in the left navigation menu. The dashboard contains a Data Summary section and five tabs that display the usage, failures, performance, processing jobs, and top executed queries data separately.

The Data Summary section provides an overview of the AQuA query data within the last seven days and the change percentage compared to the previous interval.

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

• Configure filters
• View the trend chart

Configure filters

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

• In the upper right of the dashboard, click the Filters icon.
• Use the Timeframe, Start Time, and End Time fields to specify the time range.These fields are available only on the Overview, Failures, Performance, and Top Executed Queries tabs.
• Use the Job Status field to specify the query job status.This field is available only on the Overview, Failures, Performance, and Processing Jobs tabs.
• Use the Job ID field to filter a specific query job.This field is available only on the Overview, Failures, Performance, and Processing Jobs tabs.
• Use the Mode field to filter a specific execution mode.This field is available only on the Overview and Failures tabs.
• Use the Execution Time Range field to specify the execution time.This field is available only on the Performance tab.
• Use the Query field to specify the query expression.This field is available only on the Top Executed Queries tab.
• Click Apply to apply the filter or click Reset to go back to the default filter configuration.

View trend chart

• Select the time interval of the charts by using the interval radio buttons in the upper right of the chart.Note that available interval options vary based on the length of the selected time range.
• Each bar in the chart represents query jobs issued in that time interval. The bar might be divided into multiple colored segments based on a subcategory that varies depending on the tab. The subcategory values can be seen at the bottom of the chart. You can click the subcategory values to filter query jobs as needed.The following table describes details of the trend chart on different tabs:

  Tab name	Value in each bar	Subcategory	Available subcategory values
  Overview	Processed AQuA query jobs	Job status	Completed Error Aborted Cancelled
  Failures	Failed AQuA query jobs	Job status	Error Aborted
  Performance	Processed AQuA query jobs	Execution time range

• When hovering over each bar, you can view the breakdown data of that time range, which contains the change percentage compared to the previous interval.
• The Processing Jobs and Top Executed Queries tabs do not provide a trend chart.
• Use the table below the trend chart to view detailed data within the selected time range.
  • By default, the table displays all the items within the specified time range. To narrow down the scope to a specific interval, click a bar in the chart. To go back to the global time-range set in the filter, click Reset next to the specific time range displayed above the chart.
  • Click the ID in the Job ID column to view the detail page of a specific query job.
  • Click the number in the Execution Count column of the table on the Top Executed Queries tab to view all query jobs based on a specific query expression.
  • Click the download icon to download the table as a CSV file.
  • Click a header field to sort the data.