components/metrics/proto/call_stack_profile.proto

   1 // Copyright 2015 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 // Call stack sample data for a given profiling session.
   6
   7 syntax = "proto2";
   8
   9 option optimize_for = LITE_RUNTIME;
  10 option java_outer_classname = "CallStackProfileProtos";
  11 option java_package = "org.chromium.components.metrics";
  12
  13 package metrics;
  14
  15 // Next tag: 5
  16 message CallStackProfile {
  17   // Describes an entry in the callstack.
  18   message Entry {
  19     // Instruction pointer subtracted by module base.
  20     optional uint64 address = 1;
  21
  22     // Index to the module identifier in |module_ids| of CallStackProfile.
  23     optional int32 module_id_index = 2;
  24   }
  25
  26   // A sample consisting of one or more callstacks with the same stack frames
  27   // and instruction pointers.
  28   message Sample {
  29     // The callstack. Sample.entries[0] represents the call on the top of the
  30     // stack.
  31     repeated Entry entry = 1;
  32
  33     // Number of times this stack signature occurs.
  34     optional int64 count = 2;
  35   }
  36
  37   // Uniquely identifies a module.
  38   message ModuleIdentifier {
  39     // A hash that uniquely identifies a particular program version with high
  40     // probability. This is parsed from headers of the loaded module.
  41     // For binaries generated by GNU tools:
  42     //   Contents of the .note.gnu.build-id field.
  43     // On Windows:
  44     //   GUID + AGE in the debug image headers of a module.
  45     optional string build_id = 1;
  46
  47     // MD5Sum Prefix of the module name. This is the same hashing scheme as used
  48     // to hash UMA histogram names.
  49     optional fixed64 name_md5_prefix = 2;
  50   }
  51
  52   // The callstack and counts.
  53   repeated Sample sample = 1;
  54
  55   // List of module ids found in this sample.
  56   repeated ModuleIdentifier module_id = 2;
  57
  58   // Duration of this profile.
  59   optional int32 profile_duration_ms = 3;
  60
  61   // Time between samples.
  62   optional int32 sampling_period_ms = 4;
  63 }