This page documents the new Measures service that replaces the Filters service. |
The Measures service provides a way to quickly execute all kinds of queries on project measures. You can for example get:
The search query can then be saved as a filter to be displayed on dashboards.
The Measures service can be accessed through the top bar:
To add criteria to the search query, click on More criteria and select a criterion. As many criteria as you wish can be added.
Set the criteria and click on the Search button to display the results.
Note that only the first 1,000 results of the query are retrieved. |
Criteria | Description |
|---|---|
What? | Drop-down list to select the types of resource to search for: projects, views, files, developers, etc. |
Age | Same as the Date criterion but a period has to be set instead of a date. |
Components of project | If the What? criterion is empty, only direct children will be displayed. |
Date | Filters resources based on the last build date. |
Favourites only | If checked, only resources flagged as favourites will be displayed. |
Key | Filters resources whose key matches a given pattern
|
Language | Drop-down list to select the languages to filter on. |
| Metric | Filters resources whose a given measure is greater than or less than a certain threshold. Up to three "Metric" criteria can be defined. |
Name | Filters resources whose name contains a given string. |
The results can be displayed either as list or treemap. The display can be changed through the Display as link on the top right corner:
Then by clicking on Change Columns (for list display) or Change Treemap (for treemap display), display details can be configured: list of measures (value or variation), ordering of the columns, sort, etc.
Note that variations cannot be displayed at file level (as all previous data are purged at file level during an analysis). By default, data are also purged at package/module level. Thus variations cannot be displayed at this level by default. To change this behavior, log in as an administrator, go to Settings > Configuration > General Settings > Database Cleaner and set the Clean history data of directories/packages property to true. |
To save a search query as a measure filter, click on the Save link on the top right corner.
To create a shared measure filter, check the
Measure filters can be displayed on dashboards in the following dedicated widgets: Measure Filter as List or Measure Filter as Treemap.
Once several measure filters have been created, it becomes necessary to manage them: edit, copy, delete, share, flag as favourite, etc. To do so, click on the Manage link in the left menu:
