artdaq_utilities  v1_04_03
MetricManager.hh
1 #ifndef artdaq_DAQrate_MetricManager_hh
2 #define artdaq_DAQrate_MetricManager_hh
3 
4 // MetricManager class definition file
5 // Author: Eric Flumerfelt
6 // Last Modified: 11/14/2014
7 //
8 // MetricManager loads a user-specified set of plugins, sends them their configuration,
9 // and sends them data as it is recieved. It also maintains the state of the plugins
10 // relative to the application state.
11 
12 #include "artdaq-utilities/Plugins/MetricPlugin.hh"
13 #include "artdaq-utilities/Plugins/MetricData.hh"
14 #include "fhiclcpp/fwd.h"
15 #include "messagefacility/MessageLogger/MessageLogger.h"
16 
17 #include <sstream>
18 #include <queue>
19 #include <condition_variable>
20 #include <atomic>
21 #include <boost/thread.hpp>
22 
23 namespace artdaq
24 {
25  class MetricManager;
26 }
27 
34 {
35 public:
39  MetricManager();
40 
44  MetricManager(MetricManager const&) = delete;
45 
51  virtual ~MetricManager() noexcept;
52 
57  MetricManager& operator=(MetricManager const&) = delete;
58 
69  void initialize(fhicl::ParameterSet const& pset, std::string prefix = "");
70 
74  void do_start();
75 
79  void do_stop();
80 
84  void do_pause();
85 
89  void do_resume();
90 
98  void reinitialize(fhicl::ParameterSet const& pset, std::string prefix = "");
99 
103  void shutdown();
104 
118  void sendMetric(std::string const& name, std::string const& value, std::string const& unit, int level, MetricMode mode, std::string const& metricPrefix = "", bool useNameOverride = false);
119 
133  void sendMetric(std::string const& name, int const& value, std::string const& unit, int level, MetricMode mode, std::string const& metricPrefix = "", bool useNameOverride = false);
134 
148  void sendMetric(std::string const& name, double const& value, std::string const& unit, int level, MetricMode mode, std::string const& metricPrefix = "", bool useNameOverride = false);
149 
163  void sendMetric(std::string const& name, float const& value, std::string const& unit, int level, MetricMode mode, std::string const& metricPrefix = "", bool useNameOverride = false);
164 
178  void sendMetric(std::string const& name, long unsigned int const& value, std::string const& unit, int level, MetricMode mode, std::string const& metricPrefix = "", bool useNameOverride = false);
179 
184  void setPrefix(std::string prefix) { prefix_ = prefix; }
185 
190  bool Initialized() { return initialized_; }
191 
196  bool Running() { return running_; }
197 
202  bool Active() { return active_; }
203 
208  bool metricQueueEmpty();
209 
215  size_t metricQueueSize(std::string name = "");
216 
217 private:
218  void sendMetricLoop_();
219 
220  void startMetricLoop_();
221 
222  std::vector<std::unique_ptr<artdaq::MetricPlugin>> metric_plugins_;
223  boost::thread metric_sending_thread_;
224  std::mutex metric_mutex_;
225  std::condition_variable metric_cv_;
226  int metric_send_interval_ms_;
227 
228  bool initialized_;
229  bool running_;
230  bool active_;
231  std::string prefix_;
232 
233  //https://stackoverflow.com/questions/228908/is-listsize-really-on
234  // e10 does NOT properly have std::list::size as O(1)!!! Keep track of size separately while we still support e10.
235  typedef std::unique_ptr<MetricData> metric_data_ptr;
236  typedef std::pair<size_t, std::list<metric_data_ptr>> queue_entry;
237 
238  std::unordered_map<std::string, queue_entry> metric_queue_;
239  std::mutex metric_queue_mutex_;
240  std::atomic<size_t> missed_metric_calls_;
241  size_t metric_queue_max_size_;
242  size_t metric_queue_notify_size_;
243 };
244 
245 #endif /* artdaq_DAQrate_MetricManager_hh */
void reinitialize(fhicl::ParameterSet const &pset, std::string prefix="")
Reinitialize all MetricPlugin Instances.
void shutdown()
Call the destructors for all configured MetricPlugin instances.
void initialize(fhicl::ParameterSet const &pset, std::string prefix="")
Initialize the MetricPlugin instances.
bool Initialized()
Returns whether the MetricManager has been initialized (configured)
void sendMetric(std::string const &name, std::string const &value, std::string const &unit, int level, MetricMode mode, std::string const &metricPrefix="", bool useNameOverride=false)
Send a metric with the given parameters to any MetricPlugins with a threshold level &gt;= to level...
MetricMode
The Mode of the metric indicates how multiple metric values should be combined within a reporting int...
Definition: MetricData.hh:30
size_t metricQueueSize(std::string name="")
Return the size of the named metric queue
MetricManager()
Construct an instance of the MetricManager class.
void do_start()
Perform startup actions for each configured MetricPlugin.
bool Running()
Returns whether the MetricManager is running (accepting metric calls)
void do_stop()
Stop sending metrics to the MetricPlugin instances.
virtual ~MetricManager() noexcept
MetricManager destructor.
The MetricManager class handles loading metric plugins and asynchronously sending metric data to them...
MetricManager & operator=(MetricManager const &)=delete
Copy Assignment operator is deleted.
void setPrefix(std::string prefix)
Sets the prefix prepended to all metrics without useNameOverride set.
bool Active()
Returns whether any Metric Plugins are defined and configured
void do_resume()
Resume metric sending. Currently a No-Op.
bool metricQueueEmpty()
Returns whether the metric queue is completely empty
void do_pause()
Pause metric sending. Currently a No-Op.