New Relic Application Performance Monitoring (APM) is a third-party web application performance management tool that lets IT teams monitor live Drupal and other PHP applications, troubleshoot issues, and tune applications for optimal performance. New Relic Application Performance Monitoring (APM) Pro is available for all non-trial Cloud Platform subscriptions.
To claim your New Relic APM Pro account, see Claiming your New Relic APM pro account.
If you already have a New Relic APM Pro account, the Acquia Support team cannot
access New Relic accounts not provisioned by Acquia, even if the license key
associated with the account is installed on Cloud Platform. To provide Acquia
Support access to New Relic accounts outside Acquia’s control, add the
following email address to the list of users associated with your paid New
Relic account: [email protected]
If you already have a New Relic APM Pro free account, you can upgrade your account to the New Relic APM Pro account through your Acquia subscription. Reach out to your New Relic account manager to request to move your existing subscription to Acquia’s subscription.
Acquia offers paid add-ons to the APM Pro subscription that is included with Cloud Platform. To learn more about additional New Relic products available through Acquia, see Upgrading your New Relic account.
Claiming your New Relic APM Pro account
To claim the New Relic account associated with your Cloud Platform Professional or Cloud Platform subscription, your organization Owner must perform the following steps:
Click the name of the application containing the environments for which you want to add New Relic monitoring.
Select your desired environment and click Configuration.
Select the New Relic tab.
In the New Relic Settings section, click Claim New Relic account.
Note
If you are not the organization Owner, you do not see the Claim New Relic account link.
On the Add-ons page for the subscription associated with the desired application, click Claim Account.
Note
If you have already claimed your New Relic account, Cloud Platform will display the New Relic license key included with your Cloud Platform subscription.
In the Enable New Relic APM Pro License dialog, click Claim Account.
The Cloud Platform user interface will send the organization Owner’s name and email address to New Relic and make the Owner an Admin user on the New Relic APM Pro account Acquia has provisioned for that subscription.
New Relic will then send an email to the organization Owner with login instructions.
Note
Claiming your New Relic APM Pro account won’t overwrite any New Relic License Keys you installed on your environments before.
The free New Relic APM Pro account will also give the Organization Owner access to:
New Relic Synthetics (Lite License)
New Relic Browser (Lite License)
New Relic Mobile (Lite License)
New Relic Insights (Free)
If you are interested in upgrading to Synthetics Pro, Browser Pro, Mobile Pro, or extended retention for custom events, reach out to your Acquia account team.
Managing New Relic users and permissions
After an organization’s Owner is added to a New Relic APM Pro account as an Admin user, the Owner can add and manage users and their permissions. The Owner must not remove the default Acquia Support email address associated with the account, and also must not use the associated New Relic license key outside of Cloud Platform.
To add a new user to your New Relic account:
Go to Account > Users and roles > Users.
In the upper right corner, click Add user.
Enter the appropriate name and email address.
Select the user type. Full is billable and Basic is free.
Select their base role as either Admin, User, or Restricted.
Select Add user.
Upgrading your New Relic account
Reach out to your Acquia account team to learn about upgrading your New Relic subscription to include Synthetics Pro, Browser Pro, Mobile Pro, or extended retention for custom events. Your Acquia account team will help you to determine the solution that best fits your needs.
Adding a New Relic license key to a Cloud Platform environment
To add a New Relic APM license key to a Cloud Platform environment, users with permission to change the environment’s settings can complete the following steps:
Click the name of the application containing the environments for which you want to add New Relic monitoring.
Select your desired environment, and click Configuration.
Access the New Relic tab.
In the Provider drop-down list, select New Relic.
In Installed New Relic License Key, enter the license key associated with your New Relic APM account.
(Optional) To customize the name of the environment reporting into New Relic, define the value in Application Name in New Relic. Otherwise, the application reports into New Relic with the format:
sitename.env.Click Save.
You can also install your New Relic license key on non-production environments using the previous instructions.