To ensure your applications run smoothly, they need to be actively monitored so that the information is available in order to do the following:
- Avoid performance problems
- Diagnose performance problems when they occur
New Relic is a flexible application performance management tool that provides information to help you achieve the above goals.
This how-to will teach you how to do the following:
- Set up application performance management for your Mendix application on New Relic
New Relic is not supported for apps deployed to the Mendix Cloud.
Before starting with this how-to, make sure you have completed the following prerequisite:
- Create a New Relic account by signing up here: https://newrelic.com/signup
3 Setting Up
In this section, we will walk through all the steps to configure New Relic so that it can be used for the application performance diagnostics of your Mendix application.
3.1 Setting up New Relic (On-Premises Only)
The following steps are only relevant for on-premises deployments (skip to 2.2.1 Cloud Foundry if you are deploying your Mendix application to Cloud Foundry).
Sign in to New Relic and create a new application:
Download the Java agent archive and save your license key:
Add your license key to the newrelic.yml file from the downloaded archive as described here: https://docs.newrelic.com/docs/agents/java-agent/installation/java-agent-manual-installation#h2-download-files.
3.2 Setting Up Your Mendix Deployment
Follow these buildpack instructions to set up New Relic for Cloud Foundry deployments: https://github.com/mendix/cf-mendix-buildpack#new-relic.
3.2.2 On Premise Linux & Windows Service Console
javaopts list in your m2ee.yaml file, add “-javaagent:
javaopts: [ "-Dfile.encoding=UTF-8", "-XX:MaxPermSize=128M", "-Xmx512M", "-Xms512M", "-Djava.io.tmpdir=/srv/mendix/data/tmp", "-javaagent:/opt/newrelic/javaagent.jar" ]
3.2.3 Mendix Studio Pro (Development Mode Only)
Open your Mendix application, and click Settings in the App Explorer.
Open a configuration:
In the Extra JVM parameters field on the Server tab, add:
After completing the steps described above, all the requests handled by your Mendix application should become visible together with various graphs and statistics:
Your database calls and queries will now be visible on the database page:
6 Further Documentation
For more information on New Relic, see the New Relic documentation here: https://docs.newrelic.com/.
7 Read More
- Find the Root Cause of Runtime Errors
- Clear Warning Messages in Mendix
- Monitor Mendix Using JMX
- Debug Java Actions Remotely
- Set Log Levels
- Debug Microflows and Nanoflows
- Debug Java Actions
- Solve Load & Import Errors
- Debug Microflows Remotely
- Monitoring Tools in the cf-mendix-buildpack repo on GitHub