Skip to content

Thresholds View

A threshold configuration specifies threshold values for metric. It influences how metric values are displayed, for example, in the dashboard. A threshold configuration is identified by its name and consists of thresholds structured in groups. Threshold configurations are project-independent. The Thresholds view gives an overview of all existing threshold configurations:

Thresholds Page

These actions are available for a threshold profile:

Opens the edit dialog for the threshold configuration. The dialog is the same as the creation dialog except that the threshold configuration name can not be changed.
Copies the threshold configuration
Deletes the threshold configuration
Exports the threshold configuration. The exported file can be imported with the “Import Thresholds” button
Exports the documentation of the profile
Lets you configure access rights for this profile

To create a new threshold configuration, you have to select Thresholds in the Project Configuration perspective sidebar. This will lead you to the Thresholds page which offers the Create new Thresholds button. This opens the Create Threshold Profile View:

Threshold Profile View

In this view, you have to choose a name for the threshold configuration and add metric groups to the threshold configuration. Next, you can add metrics to the metric groups. Each metric is shown in one line. The arrow next to the metric name explains in what direction the metric is assessed. If the arrow points down, low values indicate good values and vice versa.

The field Custom Name allows you to use another name than the metric's name when displaying the metric, for example, in the dashboard. Unless two rows with the same metric exist, the custom name is optional and the metric's name will be displayed in case the custom name is not specified.

The fields Yellow and Red enable you to specify thresholds. Depending on the metric, the fields can be either filled with an arbitrary numeric value or a percentage value (as number between 0 and 1). It is also possible to specify only one of the thresholds or none (in which case no thresholds will be displayed). Note that some metrics are not supposed to be assessed (such as »Lines of Code«); it is not possible to specify thresholds for those.

The field Sub Path allows restricting the assessment and validity of the thresholds to a certain part of a project. The sub path can be used to assess different parts of a project differently (e.g., restrict the threshold to the production code by excluding test code). It is also possible to use a path that points to an architecture component.