Information for: DEVELOPERS   PARTNERS   SUPPORT

Claiming your New Relic APM Pro account

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 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: support-systems+newrelic@acquia.com

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 follow steps one through four outlined in the Adding a New Relic license key to a Cloud Platform environment section. The organization Owner must then complete the following steps:

  1. Under the Performance Monitoring section, click Claim New Relic Account.

  2. On the Add-ons page for the subscription associated with the desired application, click Claim Account.

    Claim New Relic account on the Application Performance Monitoring page

    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.

  3. 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:

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 has been added to a New Relic APM Pro account as an Admin user, the Owner can add and manage users and their permissions. The Owner shouldn’t remove the default Acquia Support email address associated with the account, and also shouldn’t use the associated New Relic license key outside of Cloud Platform.

To add a new user to your New Relic account:

  1. Go to Account > Account Setting > Users and roles > Users.
  2. In the upper right corner, click New user.
  3. Enter the appropriate name and email address.
  4. Select their base role as either Admin, User, or Restricted.
  5. 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:

  1. Sign in to the Cloud Platform user interface.

  2. Click the name of the application containing the environments for which you want to add New Relic monitoring.

    new relic

  3. Select your desired environment, and click Configuration.

  4. Access the New Relic tab.

  5. In the Provider drop-down list, select New Relic.

  6. In Installed New Relic License Key, enter the license key associated with your New Relic APM account.

  7. (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.

  8. Click Save.

You can also install your New Relic license key on non-production environments using the previous instructions.