Sonar collects a maximum of measures in an automated manner but this is sometimes not possible: information is not available for collection, measure is computed by a human, etc. Whatever the reason, Sonar provides a service to inject those measures manually and benefit from other services (Dashboard, TimeMachine, etc.): the Manual Measures service. The so-entered metrics are going to be picked during the next analysis of the project and be converted to "normal" measures.
Managing Manual Metrics
As for automated collected measures, a manual measure is collected on metric. The first thing is therefore to create the metric you want to save your measure against. In order to do so, sign in to Sonar, click on configuration at the top right of the page and choose Manual Metrics entry in the left menu:
As soon as it is created, a new metric will be available to enter manual measures.
Managing Manual Measures
Manual measures can be entered at any level of the project, i.e. project, module or package. To add a measure, sign in and go to the dashboard of the desired component and enter the Manual Measures left menu entry. You are presented with a table containing the latest measure entered for each metric:
The orange marker means that no analysis has been run since the manual measure has been entered and therefore it will not appear on the resource.
From there, you have the ability to edit or delete an existing measure or enter a new one:
Whatever action is taken on a manual measure will be picked by the next analysis of the component.
Displaying Manual Measures
In order to display Manual Measures on the dashboard, you can use the Custom Widget.
Log in and go to one of your dashboard, click on Configure Widgets and choose the Custom Widget:
You should then configure it to display the desired metrics:
And you get the new widget on the dashboard: