summaryrefslogtreecommitdiffstats
path: root/components/metrics/leak_detector/leak_analyzer.h
blob: bf98c6ca3740fc0420973ac3ef3d5b35939fa84b (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
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
// Copyright 2015 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 COMPONENTS_METRICS_LEAK_DETECTOR_LEAK_ANALYZER_H_
#define COMPONENTS_METRICS_LEAK_DETECTOR_LEAK_ANALYZER_H_

#include <stdint.h>

#include <map>
#include <vector>

#include "base/macros.h"
#include "components/metrics/leak_detector/custom_allocator.h"
#include "components/metrics/leak_detector/leak_detector_value_type.h"
#include "components/metrics/leak_detector/ranked_list.h"
#include "components/metrics/leak_detector/stl_allocator.h"

namespace metrics {
namespace leak_detector {

// This class looks for possible leak patterns in allocation data over time.
// Not thread-safe.
class LeakAnalyzer {
 public:
  using ValueType = LeakDetectorValueType;

  // This class uses CustomAllocator to avoid recursive malloc hook invocation
  // when analyzing allocs and frees.
  template <typename Type>
  using Allocator = STLAllocator<Type, CustomAllocator>;

  LeakAnalyzer(uint32_t ranking_size, uint32_t num_suspicions_threshold);
  ~LeakAnalyzer();

  // Take in a RankedList of allocations, sorted by count. Removes the contents
  // of |ranked_list| to be stored internally, which is why it is not passed in
  // as a const reference.
  void AddSample(RankedList ranked_list);

  // Used to report suspected leaks. Reported leaks are sorted by ValueType.
  const std::vector<ValueType, Allocator<ValueType>>& suspected_leaks() const {
    return suspected_leaks_;
  }

 private:
  // Analyze a list of allocation count deltas from the previous iteration. If
  // anything looks like a possible leak, update the suspicion scores.
  void AnalyzeDeltas(const RankedList& ranked_deltas);

  // Returns the count for the given value from the previous analysis in
  // |count|. Returns true if the given value was present in the previous
  // analysis, or false if not.
  bool GetPreviousCountForValue(const ValueType& value, uint32_t* count) const;

  // Look for the top |ranking_size_| entries when analyzing leaks.
  const uint32_t ranking_size_;

  // Report suspected leaks when the suspicion score reaches this value.
  const uint32_t score_threshold_;

  // A mapping of allocation values to suspicion score. All allocations in this
  // container are suspected leaks. The score can increase or decrease over
  // time. Once the score  reaches |score_threshold_|, the entry is reported as
  // a suspected leak in |suspected_leaks_|.
  std::map<ValueType,
           uint32_t,
           std::less<ValueType>,
           Allocator<std::pair<const ValueType, uint32_t>>>
      suspected_histogram_;

  // Array of allocated values that passed the suspicion threshold and are being
  // reported.
  std::vector<ValueType, Allocator<ValueType>> suspected_leaks_;

  // The most recent allocation entries, since the last call to AddSample().
  RankedList ranked_entries_;
  // The previous allocation entries, from before the last call to AddSample().
  RankedList prev_ranked_entries_;

  DISALLOW_COPY_AND_ASSIGN(LeakAnalyzer);
};

}  // namespace leak_detector
}  // namespace metrics

#endif  // COMPONENTS_METRICS_LEAK_DETECTOR_LEAK_ANALYZER_H_