New Relic


New Relic can be used on Clever Cloud with Java, Node.js, PHP, Ruby and Scala applications.

New Relic is a software analytics company based in the United States. New Relic’s technology monitors Web and mobile applications in real-time that run in cloud, on-premise, or hybrid environments. You can easily setup a New Relic based monitoring on your application to monitor it and find performances problems.

New Relic for Node.js and Ruby

New Relic is very simple to install in a Node.js or Ruby application as it is a simple dependency. Install instructions for Node.js and Ruby are available in the New Relic documentation.

New Relic for Python

To use New Relic in Python, you have to add the newrelic dependency into your requirements.txt file.

New Relic for Java, Scala and PHP

To use New Relic in Java, Scala or PHP instances, you need to configure it as it is provided directly inside the instances.

New Relic trigger auto-insertion of JavaScript fragments on PHP applications, for browser monitoring. You can disable it with newrelic.browser_monitoring.auto_instrument in .user.ini. Learn more on New Relic’s documentation.

New Relic configuration

Necessary information

Before setting up your app, be sure to have a New Relic Account.


To configure your New Relic, you need to set the environment variables NEW_RELIC_LICENSE_KEY and NEW_RELIC_APP_NAME (optional).

Alternatively you can create and add a ./clevercloud/newrelic.json file in your project, with the following fields:

  "license": "licenceID",
  "appname": "NameOfYourApp(optional)"

If the appname or NEW_RELIC_APP_NAME is not specified, we use your application id for the name.

Optional configuration (PHP only)

If you need to fine-tune agent settings, you can use the following environment variables:



Redeploy your application on Clever Cloud for the changes to take effect. A few minutes later, your application will begin sending data to New Relic. Once New Relic receives the data, your application will be listed in the dashboard.

Last updated on

Did this documentation help you ?