heap dump in android

How to capture Heap Dumps from Android App? – 3 Options

Heap Dumps are vital artifacts to diagnose memory-related problems such as memory leaks, Garbage Collection problems, and java.lang.OutOfMemoryError. They are also vital artifacts to optimize memory usage as well.

In this article, we have given few different options to capture Heap Dumps from Android Apps. Once you have captured heap dumps, you can use great tools like HeapHero and Android studio’s heap analyzer to analyze heap dumps.

Memory Profiler

Below are the steps to capture heap dumps from Memory Profiler in Android studio:

a. Run the app and select the device you want to profile from Android Studio.

b. In your Android studio, click on View >> Tool Windows >> Android Profiler

c. There will be Memory timeline, which would be below the CPU timeline, but above the Network timeline. In this memory timeline, click on download button (highlighted in the below image) to generate heap dump from the Android app.

Andr HD2
Fig 2: Generate Android Heap Dump

d. To store heap dump in your system, click on the highlighted icon in the below image.

Screenshot (217)
Fig 3: Save the generated Android Heap Dump

e. Choose a location to save the generated heap dump file.

Screenshot (218)
Fig 4: select the file location to save the generated Android heap dump file

Android Debug Bridge (ADB)

Android Debug Bridge is a command line tool which allows you to interact with a device. ADB provides a variety of device actions, such as installing and debugging apps. It also gives access to the Unix shell to run a variety of commands on the device. You can use this tool to generate android heap dumps. Launch ADB shell and follow the below steps:

a. Identify your Android App’s Process Id

First step is to identify your Android App’s process Id.  You can do that by issuing below command:

adb shell ps | grep <APP-NAME> 
Android HD4
Fig: adb shell to get android process id

Above command will return details about the process. The second number will be the PID of your app. Please check the below screenshot.              

b. Create a Heap Dump:

adb shell am dumpheap <PID> <HEAP-DUMP-FILE-PATH>  

PID: Your Android App Process Id
HEAP-DUMP-FILE-PATH: Location where heap dump file should be generated

Example:

adb shell am dumpheap 1769 /data/local/tmp/android.hprof

c. Pull the file to your machine

Above step will generate the heap dump file in the device. For analysis, you need to pull the generated file to your machine. You do that by issuing below command:

adb pull <HEAP-DUMP-FILE-PATH>

HEAP-DUMP-FILE-PATH: Location where heap dump file

Example:

adb pull /data/local/tmp/android.hprof

Capture Heap Dumps on OutOfMemoryError

If you place the below code in your application, it will capture heap dumps whenever your application receives an OutOfMemoryError.

public class CaptureHeapDumps extends Application {
       private static final String FILE_NAME = "heap-dump.hprof";
       @Override
       public void onCreate() {
          super.onCreate();

Thread.currentThread().setUncaughtExceptionHandler(OutOfMemoryException());

       }
       @NonNull
       private Thread.UncaughtExceptionHandler OutOfMemoryException() {
               return new Thread.UncaughtExceptionHandler() {
               @Override
               public void uncaughtException(Thread t, Throwable e) {
                  String directory = getApplicationInfo().dataDir;
                  String absolutePath = new File(directory, FILE_NAME)
                         .getAbsolutePath();
                  try {
                      Debug.dumpHprofData(absolutePath);
                  } catch (IOException e) {
                      e.printStackTrace();
                  }
               }
        };
    }
}

This would generate the heap dump file in this location: /data/user/0/appname/heap-dump.hprof

 

*Important*: Join the AndroidVille SLACK  workspace for mobile developers where people share their learnings about everything latest in Tech, especially in Android Development, RxJava, Kotlin, Flutter, and mobile development in general.

Click on this link to join the workspace. It’s absolutely free!

Like what you read? Don’t forget to share this post on FacebookWhatsapp, and LinkedIn.

You can follow me on LinkedInQuoraTwitter, and Instagram where I answer questions related to Mobile Development, especially Android and Flutter.

If you want to stay updated with all the latest articles, subscribe to the weekly newsletter by entering your email address in the form on the top right section of this page.

 

About the author

shares