rtctk::componentFramework::DurationMonitor< ClockType > Class Template Reference

Monitors min, mean and max duration and publishes them to OLDB. More...

#include <rtctk/componentFramework/durationMonitor.hpp>

Classes
struct	Result

Public Member Functions
	DurationMonitor (ComponentMetricsIf &metrics, const std::string &desc, const std::string &prefix="")
	Construct instance.
void	Tick (std::chrono::duration< double, std::micro > elapsed) noexcept
	Method to be called repeatedly from within the hot loop that should be measured.
Result	GetValue () const
	Method to get the measured durations in microseconds.
void	Reset ()
	Method to reset the monitor.

Detailed Description

template<typename ClockType = std::chrono::steady_clock>
class rtctk::componentFramework::DurationMonitor< ClockType >

Monitors min, mean and max duration and publishes them to OLDB.

Thread Safety

thread-compatible

Template Parameters

ClockType

clock type to enable unit testing

Constructor & Destructor Documentation

DurationMonitor()

template<typename ClockType = std::chrono::steady_clock>

rtctk::componentFramework::DurationMonitor< ClockType >::DurationMonitor ( ComponentMetricsIf & metrics, const std::string & desc, const std::string & prefix = "" )

inline

Construct instance.

Parameters

[in,out]	metrics	The metrics service object to which the counter will be published.
[in]	desc	Textual description of the counter.
[in]	prefix	Optional prefix for counter location in OLDB (needed if multiple instances are required).

Member Function Documentation

GetValue()

template<typename ClockType = std::chrono::steady_clock>

Result rtctk::componentFramework::DurationMonitor< ClockType >::GetValue ( ) const

inline

Method to get the measured durations in microseconds.

Useful if the measured value is also needed for other purpose, e.g. when it should also show up in statistics log messages, etc.

There is no guarantee that all three values stem from the same cycle.

Thread Safety

thread-safe

Reset()

template<typename ClockType = std::chrono::steady_clock>

void rtctk::componentFramework::DurationMonitor< ClockType >::Reset ( )

inline

Method to reset the monitor.

Method must only be called from single thread (same as Tick)!!

Tick()

template<typename ClockType = std::chrono::steady_clock>

void rtctk::componentFramework::DurationMonitor< ClockType >::Tick ( std::chrono::duration< double, std::micro > elapsed )

inlinenoexcept

Method to be called repeatedly from within the hot loop that should be measured.

Monitors the duration every ten seconds and writes results to performance counters that are published to ODLB by the metrics service thread.

Method must only be called from single thread!!

---

The documentation for this class was generated from the following file:

• componentFramework/services/metrics/src/include/rtctk/componentFramework/durationMonitor.hpp