Embed a single sample in histogram metadata.

base/metrics/histogram_samples.cc

 // 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.
 
 #include "base/metrics/histogram_samples.h"
 
+#include <limits>
+
 #include "base/compiler_specific.h"
 #include "base/pickle.h"
 
 namespace base {
 
 namespace {
 
+// A shorthand constant for the max value of size_t.
+const size_t kSizeMax = std::numeric_limits<size_t>::max();

[Alexei Svitkine (slow), 2017/04/18 20:52:20]

Nit: Can this be constexpr?

[bcwhite, 2017/04/19 18:13:02]

Done.

+
+// A constant stored in an AtomicSingleSample (as_atomic) to indicate that the
+// sample is "disabled" and no further accumulation should be done with it.
+const int32_t kDisabledSingleSample = -1;

[Alexei Svitkine (slow), 2017/04/18 20:52:19]

Nit: constexpr

[bcwhite, 2017/04/19 18:13:02]

Done.

+
 class SampleCountPickleIterator : public SampleCountIterator {
  public:
   explicit SampleCountPickleIterator(PickleIterator* iter);
 
   bool Done() const override;
   void Next() override;
   void Get(HistogramBase::Sample* min,
            HistogramBase::Sample* max,
            HistogramBase::Count* count) const override;
 
@@ skipping 28 matching lines @@
                                     HistogramBase::Sample* max,
                                     HistogramBase::Count* count) const {
   DCHECK(!Done());
   *min = min_;
   *max = max_;
   *count = count_;
 }
 
 }  // namespace
 
+static_assert(sizeof(HistogramSamples::AtomicSingleSample) ==
+                  sizeof(subtle::Atomic32),
+              "AtomicSingleSample isn't 32 bits");
+
+HistogramSamples::SingleSample HistogramSamples::AtomicSingleSample::Load()
+    const {
+  AtomicSingleSample single_sample = subtle::Acquire_Load(&as_atomic);
+  if (single_sample.as_atomic == kDisabledSingleSample)
+    single_sample.as_atomic = 0;

[Alexei Svitkine (slow), 2017/04/18 20:52:20]

This seems like a strange thing to do. Wouldn't it be better for this to return
false and take the single_sample as a ptr - so that the caller can check for
failure - rather than sillently give them 0's?

[bcwhite, 2017/04/19 18:13:02]

When a value is "extracted", it becomes zero.  When it's extracted/disabled,
it's still zero to the outside even though a different "flag" value is held
inside.

+  return single_sample.as_parts;
+}
+
+HistogramSamples::SingleSample HistogramSamples::AtomicSingleSample::Extract(
+    bool disable) {
+  AtomicSingleSample single_sample = subtle::NoBarrier_AtomicExchange(
+      &as_atomic, disable ? kDisabledSingleSample : 0);
+  if (single_sample.as_atomic == kDisabledSingleSample)
+    single_sample.as_atomic = 0;
+  return single_sample.as_parts;
+}
+
+bool HistogramSamples::AtomicSingleSample::Accumulate(
+    HistogramBase::Sample value,
+    HistogramBase::Count count) {
+  if (count == 0)
+    return true;
+
+  // Convert the parameters to 16-bit variables because it's all 16-bit below.
+  if (value < std::numeric_limits<int16_t>::min() ||
+      value > std::numeric_limits<int16_t>::max() ||
+      count < std::numeric_limits<int16_t>::min() ||
+      count > std::numeric_limits<int16_t>::max()) {
+    return false;
+  }
+  int16_t value16 = static_cast<int16_t>(value);
+  int16_t count16 = static_cast<int16_t>(count);
+
+  // A local, unshared copy of the single-sample is necessary so the parts
+  // can be manipulated without worrying about atomicity.
+  AtomicSingleSample single_sample;
+
+  subtle::Atomic32 existing, found;

[Alexei Svitkine (slow), 2017/04/18 20:52:20]

Nit: Separate lines.

[bcwhite, 2017/04/19 18:13:02]

Done.

+  do {
+    existing = subtle::Acquire_Load(&as_atomic);
+    if (existing == kDisabledSingleSample)

[Alexei Svitkine (slow), 2017/04/18 20:52:20]

if Load() returned a bool and took a param, then this could use that rather than
doing its own Acquire_load()

[bcwhite, 2017/04/19 18:13:02]

Load() returns the parts structure.  This needs the atomic value for later
comparison.

+      return false;
+    single_sample.as_atomic = existing;
+    if (single_sample.as_atomic != 0) {
+      if (single_sample.as_parts.value != value16)

[Alexei Svitkine (slow), 2017/04/18 20:52:20]

Nit: Add a comment for semantic meaning of this check.

[bcwhite, 2017/04/19 18:13:02]

Done.

+        return false;
+      // Make sure counts don't overflow.
+      if (count16 < 0) {

[Alexei Svitkine (slow), 2017/04/18 20:52:20]

Instead of your own checks, can you use base/numerics/safe_math.h?

I think you can do CheckAdd() and check .IsValid() on the result.

[bcwhite, 2017/04/19 18:13:02]

Done.

+        if (single_sample.as_parts.count <
+            std::numeric_limits<int16_t>::min() - count16) {
+          return false;
+        }
+      } else {
+        if (single_sample.as_parts.count >
+            std::numeric_limits<int16_t>::max() - count16) {
+          return false;
+        }
+      }
+    } else {
+      single_sample.as_parts.value = value16;

[Alexei Svitkine (slow), 2017/04/18 20:52:20]

Nit: Add a comment here mentioning no need to check for count overflow here
since it was checked at the start of the function.

[bcwhite, 2017/04/19 18:13:02]

Done.

+    }
+
+    single_sample.as_parts.count += count16;
+    if (single_sample.as_parts.count == 0)
+      single_sample.as_atomic = 0;
+    else if (single_sample.as_atomic == kDisabledSingleSample)
+      return false;
+    found = subtle::Release_CompareAndSwap(&as_atomic, existing,
+                                           single_sample.as_atomic);
+  } while (found != existing);
+
+  return true;
+}
+
+HistogramSamples::LocalMetadata::LocalMetadata() {
+  // This is the same way it's done for persistent metadata since no ctor
+  // is called for the data members in that case.

[Alexei Svitkine (slow), 2017/04/18 20:52:20]

This adds a requirement that all members must be valid and make sense when all
0's. For example, this precludes expanding Metadata with objects that can't
support this.

Please add a comment about that - e.g. above Metadata struct, to clearly state
this requirement.

[bcwhite, 2017/04/19 18:13:02]

Done (in the .h file for "struct Metadata").

+  memset(this, 0, sizeof(*this));
+}
+
 // Don't try to delegate behavior to the constructor below that accepts a
 // Matadata pointer by passing &local_meta_. Such cannot be reliably passed
 // because it has not yet been constructed -- no member variables have; the
 // class itself is in the middle of being constructed. Using it to
 // initialize meta_ is okay because the object now exists and local_meta_
 // is before meta_ in the construction order.
 HistogramSamples::HistogramSamples(uint64_t id)
     : meta_(&local_meta_) {
   meta_->id = id;
 }
 
 HistogramSamples::HistogramSamples(uint64_t id, Metadata* meta)
     : meta_(meta) {
   DCHECK(meta_->id == 0 || meta_->id == id);
 
   // It's possible that |meta| is contained in initialized, read-only memory
   // so it's essential that no write be done in that case.
   if (!meta_->id)
     meta_->id = id;
 }
 
 HistogramSamples::~HistogramSamples() {}
 
 void HistogramSamples::Add(const HistogramSamples& other) {
-  IncreaseSum(other.sum());
-  subtle::NoBarrier_AtomicIncrement(&meta_->redundant_count,
-                                    other.redundant_count());
+  IncreaseSumAndCount(other.sum(), other.redundant_count());
   bool success = AddSubtractImpl(other.Iterator().get(), ADD);
   DCHECK(success);
 }
 
 bool HistogramSamples::AddFromPickle(PickleIterator* iter) {
   int64_t sum;
   HistogramBase::Count redundant_count;
 
   if (!iter->ReadInt64(&sum) || !iter->ReadInt(&redundant_count))
     return false;
 
-  IncreaseSum(sum);
-  subtle::NoBarrier_AtomicIncrement(&meta_->redundant_count,
-                                    redundant_count);
+  IncreaseSumAndCount(sum, redundant_count);
 
   SampleCountPickleIterator pickle_iter(iter);
   return AddSubtractImpl(&pickle_iter, ADD);
 }
 
 void HistogramSamples::Subtract(const HistogramSamples& other) {
-  IncreaseSum(-other.sum());
-  subtle::NoBarrier_AtomicIncrement(&meta_->redundant_count,
-                                    -other.redundant_count());
+  IncreaseSumAndCount(-other.sum(), -other.redundant_count());
   bool success = AddSubtractImpl(other.Iterator().get(), SUBTRACT);
   DCHECK(success);
 }
 
 bool HistogramSamples::Serialize(Pickle* pickle) const {
   if (!pickle->WriteInt64(sum()))
     return false;
   if (!pickle->WriteInt(redundant_count()))
     return false;
 
   HistogramBase::Sample min;
   HistogramBase::Sample max;
   HistogramBase::Count count;
   for (std::unique_ptr<SampleCountIterator> it = Iterator(); !it->Done();
        it->Next()) {
     it->Get(&min, &max, &count);
     if (!pickle->WriteInt(min) ||
         !pickle->WriteInt(max) ||
         !pickle->WriteInt(count))
       return false;
   }
   return true;
 }
 
-void HistogramSamples::IncreaseSum(int64_t diff) {
-#ifdef ARCH_CPU_64_BITS
-  subtle::NoBarrier_AtomicIncrement(&meta_->sum, diff);
-#else
-  meta_->sum += diff;
-#endif
+bool HistogramSamples::AccumulateSingleSample(HistogramBase::Sample value,
+                                              HistogramBase::Count count) {
+  if (single_sample().Accumulate(value, count)) {
+    // Success. Update the (separate) sum and redundant-count.
+    IncreaseSumAndCount(static_cast<int64_t>(value) * count, count);
+    return true;
+  }
+  return false;
 }
 
-void HistogramSamples::IncreaseRedundantCount(HistogramBase::Count diff) {
-  subtle::NoBarrier_AtomicIncrement(&meta_->redundant_count, diff);
+void HistogramSamples::IncreaseSumAndCount(int64_t sum,
+                                           HistogramBase::Count count) {
+#ifdef ARCH_CPU_64_BITS
+  subtle::NoBarrier_AtomicIncrement(&meta_->sum, sum);
+#else
+  meta_->sum += sum;
+#endif
+  subtle::NoBarrier_AtomicIncrement(&meta_->redundant_count, count);
 }
 
 SampleCountIterator::~SampleCountIterator() {}
 
 bool SampleCountIterator::GetBucketIndex(size_t* index) const {
   DCHECK(!Done());
   return false;
 }
 
+SingleSampleIterator::SingleSampleIterator(HistogramBase::Sample min,
+                                           HistogramBase::Sample max,
+                                           HistogramBase::Count count)
+    : SingleSampleIterator(min, max, count, kSizeMax) {}
+
+SingleSampleIterator::SingleSampleIterator(HistogramBase::Sample min,
+                                           HistogramBase::Sample max,
+                                           HistogramBase::Count count,
+                                           size_t bucket_index)
+    : min_(min), max_(max), bucket_index_(bucket_index), count_(count) {}
+
+SingleSampleIterator::~SingleSampleIterator() {}
+
+bool SingleSampleIterator::Done() const {
+  return count_ == 0;
+}
+
+void SingleSampleIterator::Next() {
+  DCHECK(!Done());
+  count_ = 0;
+}
+
+void SingleSampleIterator::Get(HistogramBase::Sample* min,
+                               HistogramBase::Sample* max,
+                               HistogramBase::Count* count) const {
+  DCHECK(!Done());
+  if (min != nullptr)
+    *min = min_;
+  if (max != nullptr)
+    *max = max_;
+  if (count != nullptr)
+    *count = count_;
+}
+
+bool SingleSampleIterator::GetBucketIndex(size_t* index) const {
+  DCHECK(!Done());
+  if (bucket_index_ == kSizeMax)
+    return false;
+  *index = bucket_index_;
+  return true;
+}
+
 }  // namespace base