summaryrefslogtreecommitdiffstats
path: root/base/metrics/histogram_flattener.h
blob: b5fe9766566b2afe832d3fc1975f9aa2a09a83d9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
// Copyright (c) 2012 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef BASE_METRICS_HISTOGRAM_FLATTENER_H_
#define BASE_METRICS_HISTOGRAM_FLATTENER_H_

#include <map>
#include <string>

#include "base/macros.h"
#include "base/metrics/histogram.h"

namespace base {

class HistogramSamples;

// HistogramFlattener is an interface used by HistogramSnapshotManager, which
// handles the logistics of gathering up available histograms for recording.
// The implementors handle the exact lower level recording mechanism, or
// error report mechanism.
class BASE_EXPORT HistogramFlattener {
 public:
  virtual void RecordDelta(const HistogramBase& histogram,
                           const HistogramSamples& snapshot) = 0;

  // Will be called each time a type of Inconsistency is seen on a histogram,
  // during inspections done internally in HistogramSnapshotManager class.
  virtual void InconsistencyDetected(HistogramBase::Inconsistency problem) = 0;

  // Will be called when a type of Inconsistency is seen for the first time on
  // a histogram.
  virtual void UniqueInconsistencyDetected(
      HistogramBase::Inconsistency problem) = 0;

  // Will be called when the total logged sample count of a histogram
  // differs from the sum of logged sample count in all the buckets.  The
  // argument |amount| is the non-zero discrepancy.
  virtual void InconsistencyDetectedInLoggedCount(int amount) = 0;

 protected:
  HistogramFlattener() {}
  virtual ~HistogramFlattener() {}

 private:
  DISALLOW_COPY_AND_ASSIGN(HistogramFlattener);
};

}  // namespace base

#endif  // BASE_METRICS_HISTOGRAM_FLATTENER_H_