Neo4j application performance profiling management with New Relic


We currently need a way to have performance profiling management solution in place for Neo4j running in Windows Azure cloud. The benefits of course is on going data analysis and performance statistics, not to mention assisting in debugging issues with performance. The best part of it all, is the agent that collects the data just runs as part of the JVM and the data is automatically uploaded to the website where you can view it online.

New Relic Account

The first thing you will need to do is create a new relic account at:

Once, this is done, you can then download the java agent which will contain two files:



The yml file contains the license key and the application name to display on the new relic performance dashboard website. When you use New Relic it has a trial option, so it is easy to test out.


What we do is store these zip files in blob storage and when the worker role is bootstrapping, it will then download the zip file, and then automatically edit the neo4j config files before starting up neo4j.


Neo4j configuration

It is extremely simple to configure the relic agent to run and profile neo4j, all you need to do is edit the neo4j-wrapper.conf file and add this line of code.\newrelic.jar

We use a relative path, as we store the newrelic jar relative to the neo4j binaries, so all you need to do is store the newrelic.jar file in a location where neo4j can access it from when starting up.


Once this has been deployed to the cloud, we then have performance statistic automatically made available to use via the neo4j JVM on the New Relic web site!


From here, you can actually click a segment on the graph and drill into the method level calls that occurred in the JVM.


Notice that you can get details about the timing of method invocation timings.


Comparing environments

What is really cool, is comparing response times between environments, so you can see how fast UAT/Prod/Dev are compared to one another



It is a relatively easy task to get application performance statistics for neo4j running in or out of the cloud and New Relic seems to be a really useful tool with minimal overhead to get up and running, so I would highly recommend using the combination together. This coupled with VisualJM should provide enough performance data and profiling when collecting performance data and compiling reports.


3 thoughts on “Neo4j application performance profiling management with New Relic

  1. Thanks Romiko! This post is very helpful. We are using the HTTP REST interface to issue Cypher queries via HTTP POST requests. Do you know if there’s a way to get the query recorded in the NewRelic transaction traces, to see the query responsible for fast/slow queries? It seems difficult for some reason.

  2. Thanks! I second Jason Morrison’s question. I assume you can just run the agent on the JVM that runs the Neo4j server and hook this plugin up to it, right?

Leave a Reply

Please log in using one of these methods to post your comment: Logo

You are commenting using your account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s