# Log
# Log
Artifact:[androidx.media3:media3-common](https://developer.android.com/jetpack/androidx/releases/media3)
[View Source](https://cs.android.com/search?q=file:androidx/media3/common/util/Log.java+class:androidx.media3.common.util.Log)
*** ** * ** ***
Kotlin\|[Java](https://developer.android.com/reference/androidx/media3/common/util/Log "View this page in Java")
```
@UnstableApi
class Log
```
*** ** * ** ***
Wrapper around[android.util.Log](https://developer.android.com/reference/android/util/Log.html)which allows to set the log level and to specify a custom log output.
## Summary
| ### Nested types |
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `@`[Documented](https://developer.android.com/reference/java/lang/annotation/Documented.html) `@`[Retention](https://developer.android.com/reference/java/lang/annotation/Retention.html)`(value = `[RetentionPolicy.SOURCE](https://developer.android.com/reference/java/lang/annotation/RetentionPolicy.html#SOURCE)`)` `@`[Target](https://developer.android.com/reference/java/lang/annotation/Target.html)`(value = `[ElementType.TYPE_USE](https://developer.android.com/reference/java/lang/annotation/ElementType.html#TYPE_USE)`)` `@`[IntDef](https://developer.android.com/reference/kotlin/androidx/annotation/IntDef)`(value = )` `annotation `[Log.LogLevel](https://developer.android.com/reference/kotlin/androidx/media3/common/util/Log.LogLevel) Log level for ExoPlayer logcat logging. |
| `interface `[Log.Logger](https://developer.android.com/reference/kotlin/androidx/media3/common/util/Log.Logger) Interface for a logger that can output messages with a tag. |
| ### Constants |
|-------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `const `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html) | [LOG_LEVEL_ALL](https://developer.android.com/reference/kotlin/androidx/media3/common/util/Log#LOG_LEVEL_ALL())` = 0` Log level to log all messages. |
| `const `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html) | [LOG_LEVEL_ERROR](https://developer.android.com/reference/kotlin/androidx/media3/common/util/Log#LOG_LEVEL_ERROR())` = 3` Log level to only log error messages. |
| `const `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html) | [LOG_LEVEL_INFO](https://developer.android.com/reference/kotlin/androidx/media3/common/util/Log#LOG_LEVEL_INFO())` = 1` Log level to only log informative, warning and error messages. |
| `const `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html) | [LOG_LEVEL_OFF](https://developer.android.com/reference/kotlin/androidx/media3/common/util/Log#LOG_LEVEL_OFF())` = 2147483647` Log level to disable all logging. |
| `const `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html) | [LOG_LEVEL_WARNING](https://developer.android.com/reference/kotlin/androidx/media3/common/util/Log#LOG_LEVEL_WARNING())` = 2` Log level to only log warning and error messages. |
| ### Public functions |
|----------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `java-static `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!` | `@`[Pure](https://checkerframework.org/api/org/checkerframework/dataflow/qual/Pure.html) [appendThrowableString](https://developer.android.com/reference/kotlin/androidx/media3/common/util/Log#appendThrowableString(java.lang.String,java.lang.Throwable))`(message: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!, throwable: `[Throwable](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-throwable/index.html)`?)` Appends the result of[getThrowableString](https://developer.android.com/reference/kotlin/androidx/media3/common/util/Log#getThrowableString(java.lang.Throwable))(if non-empty) to`message`. |
| `java-static `[Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | `@`[Pure](https://checkerframework.org/api/org/checkerframework/dataflow/qual/Pure.html) [d](https://developer.android.com/reference/kotlin/androidx/media3/common/util/Log#d(java.lang.String,java.lang.String))`(tag: @`[Size](https://developer.android.com/reference/kotlin/androidx/annotation/Size)`(max = 23) `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!, message: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!)` Logs a debug-level message. |
| `java-static `[Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | `@`[Pure](https://checkerframework.org/api/org/checkerframework/dataflow/qual/Pure.html) [d](https://developer.android.com/reference/kotlin/androidx/media3/common/util/Log#d(java.lang.String,java.lang.String,java.lang.Throwable))`(tag: @`[Size](https://developer.android.com/reference/kotlin/androidx/annotation/Size)`(max = 23) `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!, message: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!, throwable: `[Throwable](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-throwable/index.html)`?)` Logs a debug-level message with an optional associated[Throwable](https://developer.android.com/reference/java/lang/Throwable.html). |
| `java-static `[Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | `@`[Pure](https://checkerframework.org/api/org/checkerframework/dataflow/qual/Pure.html) [e](https://developer.android.com/reference/kotlin/androidx/media3/common/util/Log#e(java.lang.String,java.lang.String))`(tag: @`[Size](https://developer.android.com/reference/kotlin/androidx/annotation/Size)`(max = 23) `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!, message: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!)` Logs an error-level message. |
| `java-static `[Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | `@`[Pure](https://checkerframework.org/api/org/checkerframework/dataflow/qual/Pure.html) [e](https://developer.android.com/reference/kotlin/androidx/media3/common/util/Log#e(java.lang.String,java.lang.String,java.lang.Throwable))`(tag: @`[Size](https://developer.android.com/reference/kotlin/androidx/annotation/Size)`(max = 23) `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!, message: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!, throwable: `[Throwable](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-throwable/index.html)`?)` Logs an error-level message with an optional associated[Throwable](https://developer.android.com/reference/java/lang/Throwable.html). |
| `java-static `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`?` | `@`[Pure](https://checkerframework.org/api/org/checkerframework/dataflow/qual/Pure.html) [getThrowableString](https://developer.android.com/reference/kotlin/androidx/media3/common/util/Log#getThrowableString(java.lang.Throwable))`(throwable: `[Throwable](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-throwable/index.html)`?)` Returns a string representation of a[Throwable](https://developer.android.com/reference/java/lang/Throwable.html)suitable for logging, taking into account whether[setLogStackTraces](https://developer.android.com/reference/kotlin/androidx/media3/common/util/Log#setLogStackTraces(boolean))stack trace logging} is enabled. |
| `java-static `[Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | `@`[Pure](https://checkerframework.org/api/org/checkerframework/dataflow/qual/Pure.html) [i](https://developer.android.com/reference/kotlin/androidx/media3/common/util/Log#i(java.lang.String,java.lang.String))`(tag: @`[Size](https://developer.android.com/reference/kotlin/androidx/annotation/Size)`(max = 23) `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!, message: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!)` Logs an information-level message. |
| `java-static `[Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | `@`[Pure](https://checkerframework.org/api/org/checkerframework/dataflow/qual/Pure.html) [i](https://developer.android.com/reference/kotlin/androidx/media3/common/util/Log#i(java.lang.String,java.lang.String,java.lang.Throwable))`(tag: @`[Size](https://developer.android.com/reference/kotlin/androidx/annotation/Size)`(max = 23) `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!, message: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!, throwable: `[Throwable](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-throwable/index.html)`?)` Logs an information-level message with an optional associated[Throwable](https://developer.android.com/reference/java/lang/Throwable.html). |
| `java-static `[Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [setLogStackTraces](https://developer.android.com/reference/kotlin/androidx/media3/common/util/Log#setLogStackTraces(boolean))`(logStackTraces: `[Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)`)` Sets whether stack traces of[Throwable](https://developer.android.com/reference/java/lang/Throwable.html)s will be logged to logcat. |
| `java-static `[Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [setLogger](https://developer.android.com/reference/kotlin/androidx/media3/common/util/Log#setLogger(androidx.media3.common.util.Log.Logger))`(logger: `[Log.Logger](https://developer.android.com/reference/kotlin/androidx/media3/common/util/Log.Logger)`!)` Sets a custom[Logger](https://developer.android.com/reference/kotlin/androidx/media3/common/util/Log.Logger)as the output. |
| `java-static `[Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | `@`[Pure](https://checkerframework.org/api/org/checkerframework/dataflow/qual/Pure.html) [w](https://developer.android.com/reference/kotlin/androidx/media3/common/util/Log#w(java.lang.String,java.lang.String))`(tag: @`[Size](https://developer.android.com/reference/kotlin/androidx/annotation/Size)`(max = 23) `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!, message: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!)` Logs a warning-level message. |
| `java-static `[Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | `@`[Pure](https://checkerframework.org/api/org/checkerframework/dataflow/qual/Pure.html) [w](https://developer.android.com/reference/kotlin/androidx/media3/common/util/Log#w(java.lang.String,java.lang.String,java.lang.Throwable))`(tag: @`[Size](https://developer.android.com/reference/kotlin/androidx/annotation/Size)`(max = 23) `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!, message: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!, throwable: `[Throwable](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-throwable/index.html)`?)` Logs a warning-level message with an optional associated[Throwable](https://developer.android.com/reference/java/lang/Throwable.html).. |
| ### Public properties |
|-------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `java-static `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html) | `@`[GuardedBy](https://developer.android.com/reference/kotlin/androidx/annotation/GuardedBy)`(value = "lock")` [logLevel](https://developer.android.com/reference/kotlin/androidx/media3/common/util/Log#logLevel()) |
## Constants
### LOG_LEVEL_ALL
```
const val LOG_LEVEL_ALL = 0: Int
```
Log level to log all messages.
### LOG_LEVEL_ERROR
```
const val LOG_LEVEL_ERROR = 3: Int
```
Log level to only log error messages.
### LOG_LEVEL_INFO
```
const val LOG_LEVEL_INFO = 1: Int
```
Log level to only log informative, warning and error messages.
### LOG_LEVEL_OFF
```
const val LOG_LEVEL_OFF = 2147483647: Int
```
Log level to disable all logging.
### LOG_LEVEL_WARNING
```
const val LOG_LEVEL_WARNING = 2: Int
```
Log level to only log warning and error messages.
## Public functions
### appendThrowableString
```
@Pure
java-static fun appendThrowableString(message: String!, throwable: Throwable?): String!
```
Appends the result of[getThrowableString](https://developer.android.com/reference/kotlin/androidx/media3/common/util/Log#getThrowableString(java.lang.Throwable))(if non-empty) to`message`.
### d
```
@Pure
java-static fun d(tag: @Size(max = 23) String!, message: String!): Unit
```
Logs a debug-level message.
| Parameters |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------|
| `tag: @`[Size](https://developer.android.com/reference/kotlin/androidx/annotation/Size)`(max = 23) `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!` | The tag of the message. |
| `message: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!` | The message. |
### d
```
@Pure
java-static fun d(tag: @Size(max = 23) String!, message: String!, throwable: Throwable?): Unit
```
Logs a debug-level message with an optional associated[Throwable](https://developer.android.com/reference/java/lang/Throwable.html).
| Parameters |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|
| `tag: @`[Size](https://developer.android.com/reference/kotlin/androidx/annotation/Size)`(max = 23) `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!` | The tag of the message. |
| `message: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!` | The message. |
| `throwable: `[Throwable](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-throwable/index.html)`?` | The[Throwable](https://developer.android.com/reference/java/lang/Throwable.html)associated with the message, or null if not specified. |
### e
```
@Pure
java-static fun e(tag: @Size(max = 23) String!, message: String!): Unit
```
Logs an error-level message.
| Parameters |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------|
| `tag: @`[Size](https://developer.android.com/reference/kotlin/androidx/annotation/Size)`(max = 23) `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!` | The tag of the message. |
| `message: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!` | The message. |
### e
```
@Pure
java-static fun e(tag: @Size(max = 23) String!, message: String!, throwable: Throwable?): Unit
```
Logs an error-level message with an optional associated[Throwable](https://developer.android.com/reference/java/lang/Throwable.html).
| Parameters |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|
| `tag: @`[Size](https://developer.android.com/reference/kotlin/androidx/annotation/Size)`(max = 23) `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!` | The tag of the message. |
| `message: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!` | The message. |
| `throwable: `[Throwable](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-throwable/index.html)`?` | The[Throwable](https://developer.android.com/reference/java/lang/Throwable.html)associated with the message, or null if not specified. |
### getThrowableString
```
@Pure
java-static fun getThrowableString(throwable: Throwable?): String?
```
Returns a string representation of a[Throwable](https://developer.android.com/reference/java/lang/Throwable.html)suitable for logging, taking into account whether[setLogStackTraces](https://developer.android.com/reference/kotlin/androidx/media3/common/util/Log#setLogStackTraces(boolean))stack trace logging} is enabled.
Stack trace logging may be unconditionally suppressed for some expected failure modes (e.g.,[Throwables](https://developer.android.com/reference/java/lang/Throwable.html)that are expected if the device doesn't have network connectivity) to avoid log spam.
| Parameters |
|---------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------|
| `throwable: `[Throwable](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-throwable/index.html)`?` | The[Throwable](https://developer.android.com/reference/java/lang/Throwable.html). |
| Returns |
|--------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------|
| [String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`?` | The string representation of the[Throwable](https://developer.android.com/reference/java/lang/Throwable.html), or null if`throwable`is null. |
### i
```
@Pure
java-static fun i(tag: @Size(max = 23) String!, message: String!): Unit
```
Logs an information-level message.
| Parameters |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------|
| `tag: @`[Size](https://developer.android.com/reference/kotlin/androidx/annotation/Size)`(max = 23) `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!` | The tag of the message. |
| `message: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!` | The message. |
### i
```
@Pure
java-static fun i(tag: @Size(max = 23) String!, message: String!, throwable: Throwable?): Unit
```
Logs an information-level message with an optional associated[Throwable](https://developer.android.com/reference/java/lang/Throwable.html).
| Parameters |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|
| `tag: @`[Size](https://developer.android.com/reference/kotlin/androidx/annotation/Size)`(max = 23) `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!` | The tag of the message. |
| `message: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!` | The message. |
| `throwable: `[Throwable](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-throwable/index.html)`?` | The[Throwable](https://developer.android.com/reference/java/lang/Throwable.html)associated with the message, or null if not specified. |
### setLogStackTraces
```
java-static fun setLogStackTraces(logStackTraces: Boolean): Unit
```
Sets whether stack traces of[Throwable](https://developer.android.com/reference/java/lang/Throwable.html)s will be logged to logcat. Stack trace logging is enabled by default.
| Parameters |
|-------------------------------------------------------------------------------------------------------|--------------------------------------|
| `logStackTraces: `[Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html) | Whether stack traces will be logged. |
### setLogger
```
java-static fun setLogger(logger: Log.Logger!): Unit
```
Sets a custom[Logger](https://developer.android.com/reference/kotlin/androidx/media3/common/util/Log.Logger)as the output.
| Parameters |
|------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------|
| `logger: `[Log.Logger](https://developer.android.com/reference/kotlin/androidx/media3/common/util/Log.Logger)`!` | The[Logger](https://developer.android.com/reference/kotlin/androidx/media3/common/util/Log.Logger). |
### w
```
@Pure
java-static fun w(tag: @Size(max = 23) String!, message: String!): Unit
```
Logs a warning-level message.
| Parameters |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------|
| `tag: @`[Size](https://developer.android.com/reference/kotlin/androidx/annotation/Size)`(max = 23) `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!` | The tag of the message. |
| `message: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!` | The message. |
### w
```
@Pure
java-static fun w(tag: @Size(max = 23) String!, message: String!, throwable: Throwable?): Unit
```
Logs a warning-level message with an optional associated[Throwable](https://developer.android.com/reference/java/lang/Throwable.html)..
| Parameters |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|
| `tag: @`[Size](https://developer.android.com/reference/kotlin/androidx/annotation/Size)`(max = 23) `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!` | The tag of the message. |
| `message: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!` | The message. |
| `throwable: `[Throwable](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-throwable/index.html)`?` | The[Throwable](https://developer.android.com/reference/java/lang/Throwable.html)associated with the message, or null if not specified. |
## Public properties
### logLevel
```
@GuardedBy(value = "lock")
java-static var logLevel: Int
```