git.sesse.net Git - nageru/blob - metrics.h

   1 #ifndef _METRICS_H
   2 #define _METRICS_H 1
   3
   4 // A simple global class to keep track of metrics export in Prometheus format.
   5 // It would be better to use a more full-featured Prometheus client library for this,
   6 // but it would introduce a dependency that is not commonly packaged in distributions,
   7 // which makes it quite unwieldy. Thus, we'll package our own for the time being.
   8
   9 #include <atomic>
  10 #include <map>
  11 #include <memory>
  12 #include <mutex>
  13 #include <string>
  14 #include <vector>
  15
  16 class Histogram;
  17
  18 // Prometheus recommends the use of timestamps instead of “time since event”,
  19 // so you can use this to get the number of seconds since the epoch.
  20 // Note that this will be wrong if your clock changes, so for non-metric use,
  21 // you should use std::chrono::steady_clock instead.
  22 double get_timestamp_for_metrics();
  23
  24 class Metrics {
  25 public:
  26         enum Type {
  27                 TYPE_COUNTER,
  28                 TYPE_GAUGE,
  29                 TYPE_HISTOGRAM,  // Internal use only.
  30         };
  31
  32         void add(const std::string &name, std::atomic<int64_t> *location, Type type = TYPE_COUNTER)
  33         {
  34                 add(name, {}, location, type);
  35         }
  36
  37         void add(const std::string &name, std::atomic<double> *location, Type type = TYPE_COUNTER)
  38         {
  39                 add(name, {}, location, type);
  40         }
  41
  42         void add(const std::string &name, Histogram *location)
  43         {
  44                 add(name, {}, location);
  45         }
  46
  47         void add(const std::string &name, const std::vector<std::pair<std::string, std::string>> &labels, std::atomic<int64_t> *location, Type type = TYPE_COUNTER);
  48         void add(const std::string &name, const std::vector<std::pair<std::string, std::string>> &labels, std::atomic<double> *location, Type type = TYPE_COUNTER);
  49         void add(const std::string &name, const std::vector<std::pair<std::string, std::string>> &labels, Histogram *location);
  50
  51         std::string serialize() const;
  52
  53 private:
  54         static std::string serialize_name(const std::string &name, const std::vector<std::pair<std::string, std::string>> &labels);
  55
  56         enum DataType {
  57                 DATA_TYPE_INT64,
  58                 DATA_TYPE_DOUBLE,
  59                 DATA_TYPE_HISTOGRAM,
  60         };
  61         struct MetricKey {
  62                 MetricKey(const std::string &name, const std::vector<std::pair<std::string, std::string>> labels)
  63                         : name(name), labels(labels), serialized(serialize_name(name, labels))
  64                 {
  65                 }
  66
  67                 bool operator< (const MetricKey &other) const
  68                 {
  69                         return serialized < other.serialized;
  70                 }
  71
  72                 const std::string name;
  73                 const std::vector<std::pair<std::string, std::string>> labels;
  74                 const std::string serialized;
  75         };
  76         struct Metric {
  77                 DataType data_type;
  78                 union {
  79                         std::atomic<int64_t> *location_int64;
  80                         std::atomic<double> *location_double;
  81                         Histogram *location_histogram;
  82                 };
  83         };
  84
  85         mutable std::mutex mu;
  86         std::map<std::string, Type> types;  // Ordered the same as metrics, assuming no { signs in names (which are illegal).
  87         std::map<MetricKey, Metric> metrics;
  88         std::vector<Histogram> histograms;
  89
  90         friend class Histogram;
  91 };
  92
  93 class Histogram {
  94 public:
  95         void init(const std::vector<double> &bucket_vals);
  96         void init_uniform(size_t num_buckets);  // Sets up buckets 0..(N-1).
  97         void init_geometric(double min, double max, size_t num_buckets);
  98         void count_event(double val);
  99         std::string serialize(const std::string &name, const std::vector<std::pair<std::string, std::string>> &labels) const;
 100
 101 private:
 102         // Bucket <i> counts number of events where val[i - 1] < x <= val[i].
 103         // The end histogram ends up being made into a cumulative one,
 104         // but that's not how we store it here.
 105         struct Bucket {
 106                 double val;
 107                 std::atomic<int64_t> count{0};
 108         };
 109         std::unique_ptr<Bucket[]> buckets;
 110         size_t num_buckets;
 111         std::atomic<double> sum{0.0};
 112         std::atomic<int64_t> count_after_last_bucket{0};
 113 };
 114
 115 extern Metrics global_metrics;
 116
 117 #endif  // !defined(_METRICS_H)