Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The Time Machine is made of two generic widgets that can be instantiated and configured in any dashboard.

Timeline Widget

The Timeline widget provides the capability to display a chart containing historical data of up to 3 metrics. Passing your mouse over the timeline will display the different values.

...

This widget can be customized: 

History Table Widget

The History Table widget provides the capability to display a table with the historical data up to 10 metrics:

...

This widget can be customized: 

Default Dashboard

Info
titleAvailabe since Sonar 3.0.

 

A default Time Machine dashboard comes out-of-the-box when installing Sonar. This is a combination of Timeline and History Table widgets:

Tendencies

What are Tendencies?

The tendencies are arrows that are displayed next to metrics in the dashboards. Those arrows show the trend for the measure.

How to Read Tendencies?

Sonar uses 5 levels to describe the tendency of a measure. Each level is represented by an arrow:

...

Sonar uses black ( ) arrows to represent tendencies on the quantitative metrics (the ones that are not reflecting quality of the code, for example number of lines of code). 

Sonar uses red ( ) or green ( ) arrows to represent tendencies on the qualitative metrics (the ones that are reflecting quality of the code, for example code coverage). The red is used when the quality decreases, the green when it increases. 

Of course, it is to be noted that if the percentage of duplicated lines decreases it will be represented in green by  because it is considered as an improvement.

How are Tendencies Calculated?

To compute the tendencies, making a simple difference between the last two measures of each metric would not be accurate enough. Therefore Sonar implements a more advanced algorithm: the least squares method. The least squares is a linear regression analysis that helps removing the noise in order to determine a trend on discrete measures. In other words, Sonar takes all the measure taken in the last XX days, checks that the set of measures makes some sense (by testing the correlation rate), determines an estimated slope and displays it using the arrows. 

...

Note
titleAbout deleting snapshots

Deleting a snapshot is a 2-step process:

  • The snapshot must first be removed from the project history by clicking on "Delete snapshot". It won't be displayed anymore in on this "History" page but will still be present in the database.
  • Then the snapshot is really deleted during the next project analysis.

At project level, go to Configuration > History.

For every snapshot, it is possible to manually:

...