4 option java_package = "android.perfprofd";
6 option optimize_for = LITE_RUNTIME;
8 package android.perfprofd;
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;
18 // Use the specified fixed seed for random number generation (unit
20 optional uint32 use_fixed_seed = 2;
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;
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;
34 // Desired sampling period (passed to perf -c option). Small
35 // sampling periods can perturb the collected profiles, so enforce
37 optional uint32 sampling_period = 7;
38 // Length of time to collect samples (number of seconds for 'perf
40 optional uint32 sample_duration_in_s = 8;
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;
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;
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;
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;
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;
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;
74 // Whether to use a symbolizer on-device.
75 optional bool use_elf_symbolizer = 19;
77 // Whether to send the result to dropbox.
78 optional bool send_to_dropbox = 20;