AppEngine Profiler

AppEngine Profiler is an unique tool which allows to profile java applications deployed to the local or production Google App Engine server.

Currently AppEngine Profiler is capable to collect information about system time and API ? time spent in methods of application ? as well as collect information about the top data store and memcache query statistics. Notice that on local server you will get estimations only.

Getting started

This section describes how to start using AppWrench Profiler.

  1. Select Profiler in AppWrench Tools menu and click 'Enable profiler instrumentation'.
  2. Select project to profile if needed (otherwise currently selected project will be instrumented).
  3. Wait till project is built, you will see clock icon on profiled project.
  4. Deploy instrumented application to Google App Engine or restart local server if you are going to profile locally.
  5. Your application is being profiled now, so you should perform several HTTP request to load parts of your application that you are interested in.
  6. Select 'Capture Snapshot' option in 'Google' or 'Local Server' menu.



  7. Enjoy performance snapshot of your application:

Overview

'Overview' page presents general analysis of where time is spent in your application. It displays charts with hot packages and hot methods.

Method List

'Method list' page provides detailed view of how much time in what methods is spent.

Call Tree

'Call Tree' page allows to analyze the way the time is spread inside your application call graph.

Packages

'Packages' page provides a view of the way the running time is distributed between packages in your application.

Top Data Store calls

'Top Data Store calls' page was designed to help to determine what calls to data store consume most of API Time.

Clearing profiling data

It is often useful to clear profiling data from time to time and start gather statistics from scratch. This is implemented through 'Clear profiling data' action of profiler menus.

Stopping profiling

You should perform following actions to stop profiling your application:
  1. Select Profiler in AppWrench Tools menu and click 'Disable profiler instrumentation'.
  2. Select project to profile if needed (otherwise currently selected project will be instrumented).
  3. Wait while project will be builded, you will see clock decoration on profiled project.
  4. Deploy instrumented application to Google App Engine or restart local server if you are going to profile locally.

Links: