perfprofd/binder_interface/perfprofd_config.proto

   1
   2 syntax = "proto2";
   3
   4 option java_package = "android.perfprofd";
   5
   6 option optimize_for = LITE_RUNTIME;
   7
   8 package android.perfprofd;
   9
  10 // The configuration for a profiling session.
  11 message ProfilingConfig {
  12   // Average number of seconds between perf profile collections (if
  13   // set to 100, then over time we want to see a perf profile
  14   // collected every 100 seconds). The actual time within the interval
  15   // for the collection is chosen randomly.
  16   optional uint32 collection_interval_in_s = 1;
  17
  18   // Use the specified fixed seed for random number generation (unit
  19   // testing)
  20   optional uint32 use_fixed_seed = 2;
  21
  22   // Number of times to iterate through main
  23   // loop. Value of zero indicates that we should loop forever.
  24   optional uint32 main_loop_iterations = 3;
  25
  26   // Destination directory (where to write profiles). This location
  27   // chosen since it is accessible to the uploader service.
  28   optional string destination_directory = 4;
  29   // Config directory (where to read configs).
  30   optional string config_directory = 5;
  31   // Full path to 'perf' executable.
  32   optional string perf_path = 6;
  33
  34   // Desired sampling period (passed to perf -c option). Small
  35   // sampling periods can perturb the collected profiles, so enforce
  36   // min/max.
  37   optional uint32 sampling_period = 7;
  38   // Length of time to collect samples (number of seconds for 'perf
  39   // record -a' run).
  40   optional uint32 sample_duration_in_s = 8;
  41
  42   // If this parameter is non-zero it will cause perfprofd to
  43   // exit immediately if the build type is not userdebug or eng.
  44   // Currently defaults to 1 (true).
  45   optional bool only_debug_build = 9;
  46
  47   // If the "mpdecision" service is running at the point we are ready
  48   // to kick off a profiling run, then temporarily disable the service
  49   // and hard-wire all cores on prior to the collection run, provided
  50   // that the duration of the recording is less than or equal to the value of
  51   // 'hardwire_cpus_max_duration'.
  52   optional bool hardwire_cpus = 10;
  53   optional uint32 hardwire_cpus_max_duration_in_s = 11;
  54
  55   // Maximum number of unprocessed profiles we can accumulate in the
  56   // destination directory. Once we reach this limit, we continue
  57   // to collect, but we just overwrite the most recent profile.
  58   optional uint32 max_unprocessed_profiles = 12;
  59
  60   // If set to 1, pass the -g option when invoking 'perf' (requests
  61   // stack traces as opposed to flat profile).
  62   optional bool stack_profile = 13;
  63
  64   // Control collection of various additional profile tags
  65   optional bool collect_cpu_utilization = 14;
  66   optional bool collect_charging_state = 15;
  67   optional bool collect_booting = 16;
  68   optional bool collect_camera_active = 17;
  69
  70   // The pid of the process to profile. May be negative, in which case
  71   // the whole system will be profiled.
  72   optional int32 process = 18;
  73
  74   // Whether to use a symbolizer on-device.
  75   optional bool use_elf_symbolizer = 19;
  76
  77   // Whether to send the result to dropbox.
  78   optional bool send_to_dropbox = 20;
  79 };