• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1/*
2 * Copyright (C) 2018 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 *      http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17syntax = "proto2";
18option optimize_for = LITE_RUNTIME;
19
20package perfetto.protos;
21
22// When editing this file run ./tools/gen_tracing_cpp_headers_from_protos.py
23// to reflect changes in the corresponding C++ headers.
24
25message ProcessStatsConfig {
26  enum Quirks {
27    QUIRKS_UNSPECIFIED = 0;
28
29    // This has been deprecated and ignored as per 2018-05-01. Full scan at
30    // startup is now disabled by default and can be re-enabled using the
31    // |scan_all_processes_on_start| arg.
32    DISABLE_INITIAL_DUMP = 1 [deprecated = true];
33
34    DISABLE_ON_DEMAND = 2;
35  }
36
37  repeated Quirks quirks = 1;
38
39  // If enabled all processes will be scanned and dumped when the trace starts.
40  optional bool scan_all_processes_on_start = 2;
41
42  // If enabled thread names are also recoded (this is redundant if sched_switch
43  // is enabled).
44  optional bool record_thread_names = 3;
45
46  // If > 0 samples counters (see process_stats.proto) from
47  // /proc/pid/status and oom_score_adj every X ms.
48  // This is required to be > 100ms to avoid excessive CPU usage.
49  // TODO(primiano): add CPU cost for change this value.
50  optional uint32 proc_stats_poll_ms = 4;
51
52  // If empty samples stats for all processes. If non empty samples stats only
53  // for processes matching the given string in their argv0 (i.e. the first
54  // entry of /proc/pid/cmdline).
55  // TODO(primiano): implement this feature.
56  // repeated string proc_stats_filter = 5;
57
58  // This is required to be either = 0 or a multiple of |proc_stats_poll_ms|
59  // (default: |proc_stats_poll_ms|). If = 0, will be set to
60  // |proc_stats_poll_ms|. Non-multiples will be rounded down to the nearest
61  // multiple.
62  optional uint32 proc_stats_cache_ttl_ms = 6;
63}
64