Full documentation for SonarQube has moved to a new location: http://docs.sonarqube.org/display/SONAR

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info
iconfalse
titleTable of Contents
Table of Contents

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

Info
titleThe 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 component 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 components that have not been analyzed within the last 30 days.

AlertFilter by alert level (Error | Warning | Ok).
Available since SonarQube 3.7. 

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 components based on the last build date.
Format: YYYY-MM-DD (2012-01-31)
Example: only display components that have been analyzed since January 31st, 2012.

Favourites only

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

Key

Filters components 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 components to those where a specific measure is greater than or less than a certain threshold.
Up to three "Metric" criteria can be defined.

Name

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

 

Info
titleLimitation 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 > General Settings > Database Cleaner and set the Clean history data of directories/packages property to true.

Filters

Saving Search Query as Filter

To save a search query as a filter, click on the Save link on the top right corner.

To create a shared filter, check the 

Displaying Filter

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

Managing Filters

Once several 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: