Information for: DEVELOPERS   PARTNERS

Configuring performance monitoring tools

Acquia Cloud provides configurations for the New Relic application, a performance monitoring (APM) tool that you can use with an environment.

About New Relic

New Relic Application Performance Monitoring (APM) is a web application performance management tool that lets IT teams monitor live Drupal (and other PHP) applications, troubleshoot issues, and tune for optimal performance.

Note

  • This doesn’t include the New Relic Infrastructure service, which isn’t supported on Acquia Cloud.

  • For issues with legacy alerts failing, see Legacy alerts from New Relic fail with the removal of TLS 1.0.

  • By default, the Acquia Support team can’t access subscribers’ New Relic accounts. To enable Acquia Support to access New Relic for your applications, add the following email address to the list of users associated with your New Relic account:

    support-systems+newrelic@acquia.com

Configuring New Relic performance monitoring for an environment

To configure New Relic as the APM tool for an environment, complete the following steps:

  1. Sign in to Acquia Cloud.

  2. Select an application.

  3. Select an environment, and then click Configure. The Performance monitoring section includes the New Relic Pro Account ID.

    New Relic account ID

  4. Send an email to acquia@newrelic.com from the subscription owner’s email address that includes the following information:

    • Your full name
    • Your company name
    • Your New Relic Pro Account ID
    • Your company’s email address
    • Your account ID for your existing, paid New Relic APM subscription, if you have one.
  5. If you are new to New Relic and don’t have a paid Application Performance Monitoring (APM) subscription

    New Relic will contact you to discuss the subscription that fits your needs. You will be given temporary access to your data in the New Relic Pro account during this evaluation period. After you purchase APM, you will be provided indefinite access to your New Relic pro account, until you choose to cancel your paid APM subscription. Make sure to request a copy of your New Relic key, if it isn’t provided to you.

  6. If you already have a paid APM subscription

    Include your APM account ID in your email to New Relic. New Relic will make the New Relic Pro account a sub-account of your existing, paid New Relic account, which will enable your existing subscription to monitor your Acquia environment. You may need to purchase additional licenses, depending on how large your Acquia environment is and whether your current licenses are able to accommodate the additional hosts. Make sure to request a copy of your New Relic key, if it isn’t provided to you.

  7. Contact Acquia Support and provide your New Relic key in the support ticket.

  8. If you are enabling New Relic performance monitoring on a multisite environment, including Acquia Cloud Site Factory, review the instructions at Using New Relic monitoring in a multisite environment if you want to configure New Relic for per-website reporting.

Acquia Support will notify you when New Relic performance monitoring has been enabled for your environment.

If you need to remove the New Relic code from your website due to a conflict with JavaScript included in your codebase, contact Acquia Support.

Note

If your non-production environments are on shared hardware, performance data provided by these environments may be skewed by the activity of other websites on the instance during periods of high activity.

Additional features

In addition to monitoring your production website, enhanced capabilities are also available:

Non-production environments

Your non-production Acquia environments can also report to your existing paid New Relic account. To set this up, create an Acquia Support ticket.

New Relic multisite capabilities

New Relic can be used with multisite installations. For additional information, see Using New Relic monitoring in a multisite environment.

Using New Relic to monitor Drush

You can use New Relic to monitor Drush and its use of external calls by adding this code snippet to your drush.ini file:

extension=newrelic.so
newrelic.license = "[INSERT LICENSE KEY HERE]"
newrelic.appname = "[sitename].[env]"
newrelic.daemon.port = /run/newrelic.sock

where the [LICENSE_KEY] is your New Relic key, and [sitename].[env] is the environment that you want to monitor.

For more information, see Profile Drush Commands in New Relic in the Acquia Knowledge Base.

Compatibility statement

Acquia Cloud is compatible with only the Application Monitoring services provided by New Relic. Acquia doesn’t support New Relic Server Monitoring services, or any plug-ins.

Note

Acquia can’t make changes to the New Relic agent on a per-client basis.

Acquia doesn’t support the installation of New Relic on any non-web instances, except for dedicated search instances. While New Relic routinely makes updates to their services and periodically adds new features, Acquia will only update versions of this service running on Acquia Cloud after thoroughly testing the updates to ensure that any new features or feature changes included in these updates are in a stable, non-beta state prior to release.