The Monkey is a tool you run on your device to generate a random system level userr events. It generates the specified number of events without any user interaction. This is generally helpful for performing stress test. This tool generates the random events from set of commands and collect the crashes or memory reports.

Note that this tool is not used for automation testing. This only helps to find the crashes that may not appear during regular use of application.

This tool uses Android Device Bridge ADB toolkit. To run this command you need to provide the application package name and total number of random events that you want to generate. The following command shows how to start monkey tool.

$  adb shell monkey -p com.javatechig.myapp 5000

When you run this test, you can watch your device or emulator. You will notice random events on UI elements are being generated. When the application crashes, it will stop the exerciser and prints the report on terminal window. The following screenshot depicts a crash report while testing my application.
Performing Stress Test in Android Using  Monkey Application Exerciser

There are a variety of ways to control the behavior of Monkey tool by passing different arguments. Let us go through some of the important ones.

You can see a complete list of all options by typing:

$  adb shell monkey --help

You must have noticed in the previous command, when the Monkey starts, it always starts the default application of the package specified. However in some cases your application may depend on some other third party apps such as device native camera to capture photo or integrating with Google Maps. For such cases, any event that launches something external will be dropped by default by Monkey tool.

This behavior can be controlled by providing an additional package -p argument to the Monkey command.

$  adb shell monkey -p com.javatechig.myapp -p 5000

Now let us run the Monkey tool more intelligently by controlling the type of events that are triggered. For example if you want to ensure that 30 percent of the events are touch events, ypou need to specify the –pct-touch argument as follows.

$  adb shell monkey --pct-touch 30 -p com.javatechig.myapp 5000
This article is about: Monkey, Testing,


A blogger, a bit of tech freak and a software developer. He is a thought leader in the fusion of design and mobile technologies. He is the author of Xamarin Mobile Application Development for Android Book (, DZone MVB and founder of

Join The Discussion

Please note: We reserve the right to delete comments that contains snarky remarks, offensive or off-topic. To know more read our comments policy.