2018-12-20 13:11:17 +01:00
|
|
|
# TraceCategoriesAndOptions Object
|
|
|
|
|
|
2021-11-16 05:13:18 +01:00
|
|
|
* `categoryFilter` string - A filter to control what category groups
|
2019-05-06 08:29:01 -07:00
|
|
|
should be traced. A filter can have an optional '-' prefix to exclude
|
2018-12-20 13:11:17 +01:00
|
|
|
category groups that contain a matching category. Having both included
|
|
|
|
|
and excluded category patterns in the same list is not supported. Examples:
|
|
|
|
|
`test_MyTest*`, `test_MyTest*,test_OtherStuff`, `-excluded_category1,-excluded_category2`.
|
2021-11-16 05:13:18 +01:00
|
|
|
* `traceOptions` string - Controls what kind of tracing is enabled,
|
2018-12-20 13:11:17 +01:00
|
|
|
it is a comma-delimited sequence of the following strings:
|
|
|
|
|
`record-until-full`, `record-continuously`, `trace-to-console`, `enable-sampling`, `enable-systrace`,
|
|
|
|
|
e.g. `'record-until-full,enable-sampling'`.
|
|
|
|
|
The first 3 options are trace recording modes and hence mutually exclusive.
|
|
|
|
|
If more than one trace recording modes appear in the `traceOptions` string,
|
|
|
|
|
the last one takes precedence. If none of the trace recording modes are
|
|
|
|
|
specified, recording mode is `record-until-full`.
|
|
|
|
|
The trace option will first be reset to the default option (`record_mode` set
|
|
|
|
|
to `record-until-full`, `enable_sampling` and `enable_systrace`
|
|
|
|
|
set to `false`) before options parsed from `traceOptions` are applied on it.
|
