When Adobe provisions your cloud infrastructure project, the License Owner receives an email from New Relic with credentials and instructions for accessing the New Relic account. If you did not receive the email, use the License Owner email address to reset the New Relic password.
A New Relic account can have only one person assigned to the Owner role. If you must change the account owner, assign the Admin role to the current Owner, and then assign the Owner role to another user. See Update the account owner in the New Relic documentation for instructions.
Guidelines for managing New Relic access:
Before assigning the Owner role to a user, verify that the user exists on the New Relic account for Adobe Commerce on cloud infrastructure. If you must add the user to that account and an existing account Owner or Admin cannot help, any user with access to the Adobe Partnership Owner Account for New Relic can add users on behalf of the customer.
Add at least one Admin user to your New Relic account that can manage all access, integrations, and tool usage.
To access User management in New Relic:
Log in to your New Relic account.
Select your username from the lower left navigation.
Click Administration and select one of the following from the list:
User management to add a user and manage active users and pending invites.
Access management to manage user groups, roles, and accounts.
See User management in the New Relic documentation.
Pro environments are preconfigured to use New Relic services and can skip enable and connect instructions. If New Relic APM is not installed on the Staging and Production environments or New Relic Infrastructure is not available in the Production environment, submit an Adobe Commerce Support ticket to request installation.
For Starter environments, you must check the
.magento.app.yaml file to verify that the
runtime section includes the New Relic extension. If the extension has not been configured, add the following:
runtime: extensions: - newrelic
To connect a Cloud environment to New Relic, add the New Relic license key to the environment.
For Pro projects, Adobe adds the license key to your Production and Staging environments during the provisioning process. You can log in to your New Relic account to verify connectivity between your Adobe Commerce on cloud infrastructure site and New Relic.
For Starter projects, you have a New Relic license key that supports up to three environments. You must add the key to your environment configurations manually. Starter environments are not pre-provisioned to use the New Relic service.
For Starter environments, enable the New Relic integration by adding the New Relic license key to the environment configuration. Add the key to the Staging and Production environments and one other environment of your choice. Only the New Relic license key is required for configuration. You can find information about additional configuration options in the New Relic Reporting topic in the Adobe Commerce User Guide.
The deployment process begins when you perform a merge, push, or synchronization of your environment, or when you trigger a manual redeployment, during which the Commerce application is in maintenance mode. For a Production environment, Adobe recommends completing this work during off-peak hours to avoid service disruptions.
To configure New Relic for Starter environments:
Find your New Relic license key from the Project Web UI or the Cloud CLI.
Project Web UI method:
Open your cloud project account page.
On the Projects tab, find your project.
Click View Details for project infrastructure information.
Expand the New Relic Service section to view the license key.
Copy the license key.
Cloud CLI method:
magento-cloud subscription:info services.newrelic
Add the New Relic license key to an environment using the
Change to the environment that needs the license key.
Update the variable value using the following
magento-cloud CLI command:
magento-cloud variable:update php:newrelic.license --value <newrelic-license-key>
Optionally, you can add it from the Commerce Admin.
You can only use your New Relic license key on three active environments. If the key is in use in three environments, you must remove the key from one of the environments before you can add it to a different environment.
To remove a license key from an environment:
List environment variables.
+----------------------+-------------+----------------------+---------+ | Name | Level | Value | Enabled | +----------------------+-------------+----------------------+---------+ | php:newrelic.license | environment | newrelic-license-key | true | +----------------------+-------------+----------------------+---------+
If you added the license key as a project variable, you must remove that project-level variable. A project variable adds the license to every environment branch created, which can consume or exceed the license limit. To list project variables:
magento-cloud variable:list --level project
Delete the license variable.
magento-cloud variable:delete php:newrelic.license