---
title: "Logcat"
description: "Learn more about the Sentry Logcat integration for the Android SDK."
url: https://docs.sentry.io/platforms/android/integrations/logcat/
---

# Logcat | Sentry for Android

##### Did you mean logs instead?

This integration captures Logcat logs as breadcrumbs (great for error context!). But if you need to search and query your logs across your entire application, use [Sentry Logs](https://docs.sentry.io/platforms/android/logs.md) instead. Logcat logs at or above the `minLevel` are automatically sent as Sentry Logs when enabled. See the [Support With Sentry Logs](https://docs.sentry.io/platforms/android/integrations/logcat.md#support-with-sentry-logs) section below.

Supported in Sentry's Android SDK version `6.17.0` and above.

Supported in Sentry Android Gradle Plugin version `3.5.0` and above.

The Sentry Logcat integration adds support for automatically reporting log calls above a minimum logging level as breadcrumbs. Any matching `android.Log.*` calls inside your app package are captured as breadcrumbs, including `android.Log.*` calls originating from bundled third party libraries.

## [Installation With the Sentry Android Gradle Plugin](https://docs.sentry.io/platforms/android/integrations/logcat.md#installation-with-the-sentry-android-gradle-plugin)

### [Install](https://docs.sentry.io/platforms/android/integrations/logcat.md#install)

To use the Logcat integration, add the Sentry Android Gradle plugin in `build.gradle`:

`app/build.gradle`

```groovy
plugins {
  id "io.sentry.android.gradle" version "6.4.0"
}
```

### [Configure](https://docs.sentry.io/platforms/android/integrations/logcat.md#configure)

Auto-instrumentation is enabled by default, so no further configuration is required. If you'd like to disable the Logcat instrumentation feature, or change the minimum log level the following options are provided:

`app/build.gradle`

```groovy
import io.sentry.android.gradle.extensions.InstrumentationFeature
import io.sentry.android.gradle.instrumentation.logcat.LogcatLevel

sentry {
  tracingInstrumentation {
    enabled = true

    logcat {
      enabled = true
      minLevel = LogcatLevel.WARNING
    }
  }
}
```

## [Verify](https://docs.sentry.io/platforms/android/integrations/logcat.md#verify)

This snippet captures an intentional error, so you can test that everything is working once you've set it up:

```kotlin
import androidx.appcompat.app.AppCompatActivity
import android.os.Bundle
import io.sentry.Sentry
import android.util.Log

class MyActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    Log.w("MyTag", "Warning message.")

    Sentry.captureException(Exception("My Exception"))
  }
}
```

Learn more about manually capturing an error or message in our [Usage documentation](https://docs.sentry.io/platforms/android/usage.md).

To view and resolve the recorded message, log into [sentry.io](https://sentry.io) and open your project. Click on the error's title to open a page where you can see error details and mark errors as resolved.

## [Support With Sentry Logs](https://docs.sentry.io/platforms/android/integrations/logcat.md#support-with-sentry-logs)

Sentry Logs for Logcat are supported in Sentry Android SDK version `8.17.0` and above.

Logcat logs at or above the `minLevel` captured by Sentry are automatically sent as [Sentry Logs](https://docs.sentry.io/platforms/android/logs.md), if enabled.