Logcat

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.

Logcat Breadcrumbs

Installation With the Sentry Android Gradle Plugin

Install

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

app/build.gradle
Copied
plugins {
  id "io.sentry.android.gradle" version "4.3.0"
}

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
Copied
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

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

Copied
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"))
  }
}

To view and resolve the recorded message, log into 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.

Help improve this content
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) or suggesting an update ("yeah, this would be better").