Skip to end of metadata
Go to start of metadata
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:

Search

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

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.
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.

Date

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.

Key

Filters resources whose key matches a given pattern

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

Language

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.

Name

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.

Filters

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:

 

Labels
  • None