Amazon CodeGuru Profiler demo application

Simple application for demonstrating the features of Amazon CodeGuru Profiler.

Quick demo

The results of this app are available to play with in the AWS console. There is no need to run the code, if you just want to see the results.

1. Sign into the AWS console
2. Head to CodeGuru Profiler and check out the demo app

How it works

The application does some basic image processing, with some CPU-heavy operations alongside some IO-heavy operations.

It consists chiefly of two components which run in parallel, the task publisher and the image processor.

CodeGuru Profiler runs inside the application, in the same way any real application would use it. It collects and reports profiling data about the application, ready to be viewed in the AWS console.

TaskPublisher

Checks the S3 bucket for available images, and submits the name of some of these images to the SQS queue.

ImageProcessor

Polls SQS for names of images to process. Processing an image involves downloading it from S3, applying some image transforms (e.g. converting to monochrome), and uploading the result back to S3.

Setup

Make sure you have installed the latest version of AWS CLI.

Setup the required components by running the following aws commands:

1. Create two profiling groups in CodeGuru Profiler, named DemoApplication-WithIssues and DemoApplication-WithoutIssues
2. Create an SQS queue
3. Create an S3 bucket
4. Install Maven (to build and run the code)
5. Create/use an IAM role with permissions to access SQS, S3 and CodeGuru Profiler

aws configure # set up your AWS credentials and region as usual
aws codeguruprofiler create-profiling-group --profiling-group-name DemoApplication-WithIssues
aws codeguruprofiler create-profiling-group --profiling-group-name DemoApplication-WithoutIssues
aws s3 mb s3://demo-application-test-bucket-1092734-REPLACE-ME
aws sqs create-queue --queue-name DemoApplicationQueue

How to run

export DEMO_APP_SQS_URL="https://eu-west-1.queue.amazonaws.com/YOUR-ACCOUNT-ID/DemoApplicationQueue"
export DEMO_APP_BUCKET_NAME="demo-application-test-bucket-1092734-REPLACE-ME"
mvn clean install
mvn exec:java -P without-issues # or try with-issues to demonstrate common performance issues

Run this for 24 hours to get plenty of data, along with a recommendations report.

Note: When running with-issues, you'll see plenty of Expensive exception, Pointless work and other debug gibberish being logged. This is expected! This is an example of a badly coded application, and you'll be able to see how these issues show up on the CodeGuru Profiler console.

So don't worry 😎 -- we totally know about it.

License

This code is licensed under the MIT-0 License. See the LICENSE file.