# TracingConfig
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Summary:[Nested Classes](https://developer.android.com/reference/android/webkit/TracingConfig#nestedclasses)\|[Constants](https://developer.android.com/reference/android/webkit/TracingConfig#constants)\|[Methods](https://developer.android.com/reference/android/webkit/TracingConfig#pubmethods)\|[Inherited Methods](https://developer.android.com/reference/android/webkit/TracingConfig#inhmethods)
# TracingConfig
*** ** * ** ***
[Kotlin](https://developer.android.com/reference/kotlin/android/webkit/TracingConfig "View this page in Kotlin")\|Java
`
public
class
TracingConfig
`
`
extends `[Object](https://developer.android.com/reference/java/lang/Object)`
``
`
|---|------------------------------|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.webkit.TracingConfig |
*** ** * ** ***
Holds tracing configuration information and predefined settings.
## Summary
| ### Nested classes ||
|----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ` class` | [TracingConfig.Builder](https://developer.android.com/reference/android/webkit/TracingConfig.Builder) Builder used to create[TracingConfig](https://developer.android.com/reference/android/webkit/TracingConfig)objects. |
| ### Constants ||
|-------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `int` | [CATEGORIES_ALL](https://developer.android.com/reference/android/webkit/TracingConfig#CATEGORIES_ALL) Predefined set of categories, includes all categories enabled by default in chromium. |
| `int` | [CATEGORIES_ANDROID_WEBVIEW](https://developer.android.com/reference/android/webkit/TracingConfig#CATEGORIES_ANDROID_WEBVIEW) Predefined set of categories typically useful for analyzing WebViews. |
| `int` | [CATEGORIES_FRAME_VIEWER](https://developer.android.com/reference/android/webkit/TracingConfig#CATEGORIES_FRAME_VIEWER) Predefined set of categories for studying difficult rendering performance problems. |
| `int` | [CATEGORIES_INPUT_LATENCY](https://developer.android.com/reference/android/webkit/TracingConfig#CATEGORIES_INPUT_LATENCY) Predefined set of categories for analyzing input latency issues. |
| `int` | [CATEGORIES_JAVASCRIPT_AND_RENDERING](https://developer.android.com/reference/android/webkit/TracingConfig#CATEGORIES_JAVASCRIPT_AND_RENDERING) Predefined set of categories for analyzing javascript and rendering issues. |
| `int` | [CATEGORIES_NONE](https://developer.android.com/reference/android/webkit/TracingConfig#CATEGORIES_NONE) Indicates that there are no predefined categories. |
| `int` | [CATEGORIES_RENDERING](https://developer.android.com/reference/android/webkit/TracingConfig#CATEGORIES_RENDERING) Predefined set of categories for analyzing rendering issues. |
| `int` | [CATEGORIES_WEB_DEVELOPER](https://developer.android.com/reference/android/webkit/TracingConfig#CATEGORIES_WEB_DEVELOPER) Predefined set of categories typically useful for web developers. |
| `int` | [RECORD_CONTINUOUSLY](https://developer.android.com/reference/android/webkit/TracingConfig#RECORD_CONTINUOUSLY) Record trace events continuously using an internal ring buffer. |
| `int` | [RECORD_UNTIL_FULL](https://developer.android.com/reference/android/webkit/TracingConfig#RECORD_UNTIL_FULL) Record trace events until the internal tracing buffer is full. |
| ### Public methods ||
|-------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ` `[List](https://developer.android.com/reference/java/util/List)`<`[String](https://developer.android.com/reference/java/lang/String)`>` | ` `[getCustomIncludedCategories](https://developer.android.com/reference/android/webkit/TracingConfig#getCustomIncludedCategories())`() ` Returns the list of included custom category patterns for this configuration. |
| ` int` | ` `[getPredefinedCategories](https://developer.android.com/reference/android/webkit/TracingConfig#getPredefinedCategories())`() ` Returns a bitmask of the predefined category sets of this configuration. |
| ` int` | ` `[getTracingMode](https://developer.android.com/reference/android/webkit/TracingConfig#getTracingMode())`() ` Returns the tracing mode of this configuration. |
| ### Inherited methods |
|-----------------------|---|
| From class` `[java.lang.Object](https://developer.android.com/reference/java/lang/Object)` ` |--------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` `[Object](https://developer.android.com/reference/java/lang/Object) | ` `[clone](https://developer.android.com/reference/java/lang/Object#clone())`() ` Creates and returns a copy of this object. | | ` boolean` | ` `[equals](https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object))`(`[Object](https://developer.android.com/reference/java/lang/Object)` obj) ` Indicates whether some other object is "equal to" this one. | | ` void` | ` `[finalize](https://developer.android.com/reference/java/lang/Object#finalize())`() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. | | ` final `[Class](https://developer.android.com/reference/java/lang/Class)`` | ` `[getClass](https://developer.android.com/reference/java/lang/Object#getClass())`() ` Returns the runtime class of this`Object`. | | ` int` | ` `[hashCode](https://developer.android.com/reference/java/lang/Object#hashCode())`() ` Returns a hash code value for the object. | | ` final void` | ` `[notify](https://developer.android.com/reference/java/lang/Object#notify())`() ` Wakes up a single thread that is waiting on this object's monitor. | | ` final void` | ` `[notifyAll](https://developer.android.com/reference/java/lang/Object#notifyAll())`() ` Wakes up all threads that are waiting on this object's monitor. | | ` `[String](https://developer.android.com/reference/java/lang/String) | ` `[toString](https://developer.android.com/reference/java/lang/Object#toString())`() ` Returns a string representation of the object. | | ` final void` | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long,%20int))`(long timeoutMillis, int nanos) ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long))`(long timeoutMillis) ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait())`() ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*. | ||
## Constants
### CATEGORIES_ALL
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int CATEGORIES_ALL
```
Predefined set of categories, includes all categories enabled by default in chromium. Use with caution: this setting may produce large trace output.
Constant Value: 1 (0x00000001)
### CATEGORIES_ANDROID_WEBVIEW
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int CATEGORIES_ANDROID_WEBVIEW
```
Predefined set of categories typically useful for analyzing WebViews. Typically includes "android_webview" and "Java" categories.
Constant Value: 2 (0x00000002)
### CATEGORIES_FRAME_VIEWER
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int CATEGORIES_FRAME_VIEWER
```
Predefined set of categories for studying difficult rendering performance problems. Typically includes "blink", "compositor", "gpu", "renderer.scheduler", "v8" and some other compositor categories which are disabled by default.
Constant Value: 64 (0x00000040)
### CATEGORIES_INPUT_LATENCY
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int CATEGORIES_INPUT_LATENCY
```
Predefined set of categories for analyzing input latency issues. Typically includes "input", "renderer.scheduler" categories.
Constant Value: 8 (0x00000008)
### CATEGORIES_JAVASCRIPT_AND_RENDERING
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int CATEGORIES_JAVASCRIPT_AND_RENDERING
```
Predefined set of categories for analyzing javascript and rendering issues. Typically includes "blink", "compositor", "gpu", "renderer.scheduler" and "v8" categories.
Constant Value: 32 (0x00000020)
### CATEGORIES_NONE
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int CATEGORIES_NONE
```
Indicates that there are no predefined categories.
Constant Value: 0 (0x00000000)
### CATEGORIES_RENDERING
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int CATEGORIES_RENDERING
```
Predefined set of categories for analyzing rendering issues. Typically includes "blink", "compositor" and "gpu" categories.
Constant Value: 16 (0x00000010)
### CATEGORIES_WEB_DEVELOPER
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int CATEGORIES_WEB_DEVELOPER
```
Predefined set of categories typically useful for web developers. Typically includes "blink", "compositor", "renderer.scheduler" and "v8" categories.
Constant Value: 4 (0x00000004)
### RECORD_CONTINUOUSLY
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int RECORD_CONTINUOUSLY
```
Record trace events continuously using an internal ring buffer. Default tracing mode. Overwrites old events if they exceed buffer capacity. Uses less memory than the[RECORD_UNTIL_FULL](https://developer.android.com/reference/android/webkit/TracingConfig#RECORD_UNTIL_FULL)mode. Depending on the implementation typically allows up to 64k events to be stored.
Constant Value: 1 (0x00000001)
### RECORD_UNTIL_FULL
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int RECORD_UNTIL_FULL
```
Record trace events until the internal tracing buffer is full. Typically the buffer memory usage is larger than[RECORD_CONTINUOUSLY](https://developer.android.com/reference/android/webkit/TracingConfig#RECORD_CONTINUOUSLY). Depending on the implementation typically allows up to 256k events to be stored.
Constant Value: 0 (0x00000000)
## Public methods
### getCustomIncludedCategories
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public List getCustomIncludedCategories ()
```
Returns the list of included custom category patterns for this configuration.
| Returns ||
|----------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------|
| [List](https://developer.android.com/reference/java/util/List)`<`[String](https://developer.android.com/reference/java/lang/String)`>` | Empty list if no custom category patterns are specified. This value cannot be`null`.
|
### getPredefinedCategories
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int getPredefinedCategories ()
```
Returns a bitmask of the predefined category sets of this configuration.
| Returns ||
|-------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `int` | Bitmask of predefined category sets. Value is either`0`or a combination of[CATEGORIES_NONE](https://developer.android.com/reference/android/webkit/TracingConfig#CATEGORIES_NONE),[CATEGORIES_ALL](https://developer.android.com/reference/android/webkit/TracingConfig#CATEGORIES_ALL),[CATEGORIES_ANDROID_WEBVIEW](https://developer.android.com/reference/android/webkit/TracingConfig#CATEGORIES_ANDROID_WEBVIEW),[CATEGORIES_WEB_DEVELOPER](https://developer.android.com/reference/android/webkit/TracingConfig#CATEGORIES_WEB_DEVELOPER),[CATEGORIES_INPUT_LATENCY](https://developer.android.com/reference/android/webkit/TracingConfig#CATEGORIES_INPUT_LATENCY),[CATEGORIES_RENDERING](https://developer.android.com/reference/android/webkit/TracingConfig#CATEGORIES_RENDERING),[CATEGORIES_JAVASCRIPT_AND_RENDERING](https://developer.android.com/reference/android/webkit/TracingConfig#CATEGORIES_JAVASCRIPT_AND_RENDERING), and[CATEGORIES_FRAME_VIEWER](https://developer.android.com/reference/android/webkit/TracingConfig#CATEGORIES_FRAME_VIEWER)
|
### getTracingMode
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int getTracingMode ()
```
Returns the tracing mode of this configuration.
| Returns ||
|-------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `int` | The tracing mode of this configuration. Value is[RECORD_UNTIL_FULL](https://developer.android.com/reference/android/webkit/TracingConfig#RECORD_UNTIL_FULL), or[RECORD_CONTINUOUSLY](https://developer.android.com/reference/android/webkit/TracingConfig#RECORD_CONTINUOUSLY)
|