src/components/metrics/proto/histogram_event.proto

   1 // Copyright 2014 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4 //
   5 // Histogram-collected metrics.
   6
   7 syntax = "proto2";
   8
   9 option optimize_for = LITE_RUNTIME;
  10
  11 package metrics;
  12
  13 // Next tag: 4
  14 message HistogramEventProto {
  15   // The name of the histogram, hashed.
  16   optional fixed64 name_hash = 1;
  17
  18   // The sum of all the sample values.
  19   // Together with the total count of the sample values, this allows us to
  20   // compute the average value.  The count of all sample values is just the sum
  21   // of the counts of all the buckets.
  22   optional int64 sum = 2;
  23
  24   // The per-bucket data.
  25   message Bucket {
  26     // Each bucket's range is bounded by min <= x < max.
  27     // It is valid to omit one of these two fields in a bucket, but not both.
  28     // If the min field is omitted, its value is assumed to be equal to max - 1.
  29     // If the max field is omitted, its value is assumed to be equal to the next
  30     // bucket's min value (possibly computed per above).  The last bucket in a
  31     // histogram should always include the max field.
  32     optional int64 min = 1;
  33     optional int64 max = 2;
  34
  35     // The bucket's index in the list of buckets, sorted in ascending order.
  36     // This field was intended to provide extra redundancy to detect corrupted
  37     // records, but was never used.  As of M31, it is no longer sent by Chrome
  38     // clients to reduce the UMA upload size.
  39     optional int32 bucket_index = 3 [deprecated = true];
  40
  41     // The number of entries in this bucket.
  42     optional int64 count = 4;
  43   }
  44   repeated Bucket bucket = 3;
  45 }