Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 11 Next »

Table of Contents

Since version 3.4


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 recently inspected projects
  • the projects with blocker and critical violations
  • the projects with bad coverage on added/changed code within the 10 past days
  • etc.

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.

The first 1,000 results are retrieved


Note that only the first 1,000 results of the query are retrieved.

Available Criteria




Drop-down list to select the types of resource to search for: projects, views, files, developers, etc.


Same as the Date criterion but a period has to be set instead of a date.
Example: only display resources that have not been analyzed within the last 30 days.

Components of project

If the What? criterion is empty, only direct children will be displayed.
If the What? criterion is not empty, all the sub-components (of any sub-levels) of the What? type will be displayed.


Filters resources based on the last build date.
Format: YYYY-MM-DD (2012-01-31)
Example: only display resources that have been analyzed since January 31st, 2012.

Favourites only

If checked, only resources flagged as favourites will be displayed.


Filters resources whose key matches a given pattern

  • * to match zero or more characters
  • ? to match any single character


Drop-down list to select the languages to filter on.

MetricFilters resources whose a given measure is greater than or less than a certain threshold.
Up to three "Metric" criteria can be defined.


Filters resources whose name contains a given string.

Results Display Configuration

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.


Limitation on variations


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.


Saving Search Query as Measure Filter

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 

Displaying Measure Filter

Measure filters can be displayed on dashboards in the following dedicated widgets: Measure Filter as List or Measure Filter as Treemap.

Managing Measure Filters

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:


  • No labels