# TestLogging

API Documentation: | `TestLogging`

Options that determine which test events get logged, and at which detail.

### Properties

Property | Description
`displayGranularity` | The display granularity of the events to be logged. For example, if set to 0, a method-level event will be displayed as "Test Run > Test Worker x > org.SomeClass > org.someMethod". If set to 2, the same event will be displayed as "org.someClass > org.someMethod".
`events` | The events to be logged.
`exceptionFormat` | The format to be used for logging test exceptions. Only relevant if `showStackTraces` is `true`.
`maxGranularity` | The maximum granularity of the events to be logged. Typically, 0 corresponds to the Gradle-generated test suite for the whole test run, 1 corresponds to the Gradle-generated test suite for a particular test JVM, 2 corresponds to a test class, and 3 corresponds to a test method. These values will vary if user-defined suites are executed.
`minGranularity` | The minimum granularity of the events to be logged. Typically, 0 corresponds to the Gradle-generated test suite for the whole test run, 1 corresponds to the Gradle-generated test suite for a particular test JVM, 2 corresponds to a test class, and 3 corresponds to a test method. These values will vary if user-defined suites are executed.
`showCauses` | Tells whether causes of exceptions that occur during test execution will be logged. Only relevant if `showExceptions` is `true`.
`showExceptions` | Tells whether exceptions that occur during test execution will be logged. Typically these exceptions coincide with a "failed" event.
`showStackTraces` | Tells whether stack traces of exceptions that occur during test execution will be logged.
`showStandardStreams` | Tells whether output on standard out and standard error will be logged. Equivalent to checking if both log events `TestLogEvent.STANDARD_OUT` and `TestLogEvent.STANDARD_ERROR` are set.
`stackTraceFilters` | The set of filters to be used for sanitizing test stack traces.

### Property details

#### `int` `displayGranularity`

The display granularity of the events to be logged. For example, if set to 0, a method-level event will be displayed as "Test Run > Test Worker x > org.SomeClass > org.someMethod". If set to 2, the same event will be displayed as "org.someClass > org.someMethod".

-1 denotes the highest granularity and corresponds to an atomic test.

#### ``Set`<`TestLogEvent`>` `events`

The events to be logged.

#### `TestExceptionFormat` `exceptionFormat`

The format to be used for logging test exceptions. Only relevant if `showStackTraces` is `true`.

#### `int` `maxGranularity`

The maximum granularity of the events to be logged. Typically, 0 corresponds to the Gradle-generated test suite for the whole test run, 1 corresponds to the Gradle-generated test suite for a particular test JVM, 2 corresponds to a test class, and 3 corresponds to a test method. These values will vary if user-defined suites are executed.

-1 denotes the highest granularity and corresponds to an atomic test.

#### `int` `minGranularity`

The minimum granularity of the events to be logged. Typically, 0 corresponds to the Gradle-generated test suite for the whole test run, 1 corresponds to the Gradle-generated test suite for a particular test JVM, 2 corresponds to a test class, and 3 corresponds to a test method. These values will vary if user-defined suites are executed.

-1 denotes the highest granularity and corresponds to an atomic test.

#### `boolean` `showCauses`

Tells whether causes of exceptions that occur during test execution will be logged. Only relevant if `showExceptions` is `true`.

#### `boolean` `showExceptions`

Tells whether exceptions that occur during test execution will be logged. Typically these exceptions coincide with a "failed" event.

#### `boolean` `showStackTraces`

Tells whether stack traces of exceptions that occur during test execution will be logged.

#### `boolean` `showStandardStreams`

Tells whether output on standard out and standard error will be logged. Equivalent to checking if both log events `TestLogEvent.STANDARD_OUT` and `TestLogEvent.STANDARD_ERROR` are set.

#### ``Set`<`TestStackTraceFilter`>` `stackTraceFilters`

The set of filters to be used for sanitizing test stack traces.

### Script blocks

No script blocks

### Methods

No methods