[Diagnostics] Add diagnostics of execution time and periodicity of the controllers and controller_manager

[saikishor]

This PR aims to add diagnostics to the controller_manager and the loaded controllers regarding their periodicity and execution time.

Needs: ros-controls/realtime_tools#192

The diagnostics should kinda look like the following screenshots (The following are only to look at the summary):

[christophfroehlich]

I successfully tested the new diagnostics with the demos (synchronous controllers), but as I haven't used them much a note for myself (would have been valid with #1764 already)

• per default, /diagnostics is sent with 1Hz by the Updater, we don't set a different value in the CM's constructor
• diagnostics_updater_ lives in a non RT-thread, and so do also the callback methods.

One comment as we are adding more and more parameters: Would it make sense to use generate_parameter_library also for the CM? I think we can't use it for the per-controller parameters because maps do not work well here, and there is no way to "namespace" parameters with GPL. But for the others?

[saikishor]

@christophfroehlich yes, I thought of using the GPL for this, but I wanted to see your opinion here before taking any decision. I'm open to having this

[codecov]

Codecov Report

Attention: Patch coverage is 74.28571% with 63 lines in your changes missing coverage. Please review.

Project coverage is 87.76%. Comparing base (da167e7) to head (faf9c75).
Report is 1 commits behind head on master.

Files with missing lines	Patch %	Lines
controller_manager/src/controller_manager.cpp	59.28%	49 Missing and 8 partials ⚠️
...ontroller_manager/test/test_controller_manager.cpp	93.75%	5 Missing ⚠️
...roller_interface/src/controller_interface_base.cpp	94.11%	0 Missing and 1 partial ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #1871      +/-   ##
==========================================
- Coverage   87.99%   87.76%   -0.24%     
==========================================
  Files         121      122       +1     
  Lines       12398    12609     +211     
  Branches     1105     1120      +15     
==========================================
+ Hits        10910    11066     +156     
- Misses       1083     1130      +47     
- Partials      405      413       +8     

Flag	Coverage Δ
unittests	87.76% <74.28%> (-0.24%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines	Coverage Δ
...controller_interface/controller_interface_base.hpp	92.30% <ø> (ø)
.../include/controller_manager/controller_manager.hpp	100.00% <ø> (ø)
...ger/include/controller_manager/controller_spec.hpp	100.00% <100.00%> (ø)
controller_manager/src/ros2_control_node.cpp	77.77% <100.00%> (ø)
...ler_manager/test/test_hardware_management_srvs.cpp	98.57% <100.00%> (+0.01%)	⬆️
...roller_interface/src/controller_interface_base.cpp	82.47% <94.11%> (-2.90%)	⬇️
...ontroller_manager/test/test_controller_manager.cpp	96.10% <93.75%> (-0.15%)	⬇️
controller_manager/src/controller_manager.cpp	76.70% <59.28%> (-1.62%)	⬇️

... and 1 file with indirect coverage changes

---- 🚨 Try these New Features:

• Flaky Tests Detection - Detect and resolve failed and flaky tests

[christophfroehlich]

LGTM. For reference, the doc page looks the following: