Dashboards

Dashboards are a convenient way to view all the important information about your project in one place. Using dashboards, you can quickly assess the status of your test cases and observe various trends to determine if there are problems that require further attention.

Each dashboard is a set of widgets — information panels that cover different aspects of your project. This can range from the total number of test cases in your project to the daily time spent running test cases with a specific tag.

Newly-created projects in Allure TestOps don't have a default dashboard, but you can quickly create one from a template.

Creating dashboards

To create a dashboard:

1. Open your project.
2. Go to Dashboards.
3. Choose a method for creating a dashboard: from a template or from scratch.

Dashboards created from templates contain a predefined set of widgets, which can be customized. Dashboards created from scratch have no widgets, you have to add them manually.

You can configure more than one dashboard for your project. To add another dashboard, click + in the dashboard tab bar. You can reorder the tabs in the tab bar by dragging them, like you can do in a web browser.

To rename or delete the current dashboard, click ⋯ in the upper-right corner of the screen.

Automation dashboard

When creating a dashboard, you can select the Automation template, which consists of four widgets:

• Test Case Pie Chart (Automation) — shows the current ratio of manual and automated test cases in your project.
• Automation Trend — shows how the automation ratio changed over time.
• Low Performing Tests (Longest Running Tests) — shows a list of test cases sorted by their execution time in descending order.
• Test Case Tree Map Chart (Test Coverage) — shows the distribution between automated and manual test cases using a specific tree of your project.

You can find more information on all available widget types in the subsection below.

Data display period

By default, most widgets display data only for the last 14 days. Because of this, if you have not run tests in the last 2 weeks, some widgets may be empty.

When entering an AQL query in widget settings, the number displayed is the number of found results for all time, not just the current period. This number may differ from the data displayed by a widget.

To change the data display period:

1. In the Dashboards section, select a dashboard.

2. Under the dashboard tab bar, click Last 14 days and select an option from the drop-down list:

   • Last 7/14/30 days — show data for the last 7, 14, or 30 days.
   • Custom — show data for a specific period.

3. If you selected the custom period, click the drop-down list on the right to select the period.

   The custom period cannot exceed 30 days.

Some widgets display data for all time, regardless of the period selected. Such widgets are labeled All time on a dashboard.

Adding widgets to dashboards

To add a new widget to a dashboard:

1. In the Dashboards section, select an existing dashboard or create a new one.
2. Click + Widget in the upper-right corner of the screen (or right-click the dashboard name and select Add widget).
3. Choose a widget from the list and configure it.
4. After you finish configuring the widget, click Add widget.

You can change the name of a widget to something more descriptive, which can be especially useful if you specified an AQL query to filter test cases or launches.

Widgets on a dashboard can be moved around and resized:

• To change the position of a widget, drag its title to the desired position.
• To change the size of a widget, drag its border.

To edit, remove, or duplicate a widget, click ⋯ in the upper-right corner of the widget or right-click anywhere on it.

Available widgets

Allure TestOps supports the following widgets:

• Text Block

  A simple widget that displays static text. You can use it to describe the contents of a dashboard, for keeping notes, etc.

• Launch Analytics

  Widget provides daily statistics on your launches for the current period, such as the total number of launches/results that day, the average execution time, etc.

  You can additionally filter the test cases and launches that will be used to calculate the statistics using AQL. For example, if you want to include only test cases that have the web tag, use the following query in the Test cases query field: tag = "web".

• Launch Trend (by date)

  Widget shows the distribution of launches by their result (test passed, test failed, etc.) over the last days, weeks, or months.

  You can filter the test cases and launches for this widget using AQL. For example, if you want to include only test cases created by the user John, use the following query in the Test cases query field: role["Owner"] = "John".

• Test Case Pie Chart

  Widget displays the automation ratio, the workflow status ratio, or the launch result ratio of your test cases as a pie chart. You can filter the test cases for this widget using AQL.

• Automation Trend

  Widget shows how the automation ratio changed over the current period. You can filter both the test cases and the launches for this widget using AQL.

• Low Performing Tests

  Widget displays a list of test cases with either the lowest success rate or the longest execution time. You can filter both the test cases and the launches for this widget using AQL.

• Test Case Tree Map Chart

  Widget displays the automation ratio of your test cases using the specified tree of your project. For example, if you select the Suites tree, the widget will display the automation ratio for each of your test suites. You can additionally filter the test cases for this widget using AQL.

• Launches

  Widget displays all launches for the current period as a list. You can filter the launches for this widget using AQL.

• Last Launch Pie Chart

  Widget shows test results from the last launch of the current period as a pie chart. You can select the launch to be displayed using AQL. For example, type tag = "smoke" into the Launches query field to select the last launch of a test case with the smoke tag.

• Launch Trend (by launches)

  Widget displays all launches for the current period as a bar chart. You can filter the launches for this widget using AQL.

Cloning dashboards

You can use existing dashboards as templates to create dashboards in the current or other projects.

To clone dashboards in the current project:

1. Select a dashboard in the Dashboards section.
2. Click ⋯ in the upper-right corner of the screen or right-click the dashboard name.
3. Select Clone to → This project. The dashboard copy will be added to the current project.

To clone dashboards to other projects:

1. Select a dashboard in the Dashboards section.
2. Click ⋯ in the upper-right corner of the screen or right-click the dashboard name.
3. Select Clone to → Another project.
4. Select a project to which the dashboard should be cloned.
5. Check the Preserve AQL settings box if you want to keep the AQL queries configured in the widget settings.
6. Click Clone. The dashboard copy will be added to the target project.