New Relic account management

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.

Manage user access

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:

• Project Owners and Admin users can add and remove users from the New Relic account.
• Do not create more than five full-access Users.
• Only grant full access to users that strictly require access to the complete feature set.
• There is no specific guidance on free Restricted users.

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:

1. Log in to your New Relic account.

2. Select your username from the lower left navigation.

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

Configure New Relic for Starter environment

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:

.magento.app.yaml

runtime:
    extensions:
        - newrelic

Apply license key

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.

To configure New Relic for Starter environments:

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

2. Add the New Relic license key to an environment using the magento-cloud CLI.

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

3. Log in to your New Relic account to verify that you can view data from the Adobe Commerce environment. See Investigate performance.

Remove license key

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:

1. List environment variables.

   magento-cloud variable:list
   

   Sample response:

    +----------------------+-------------+----------------------+---------+
    | Name                 | Level       | Value                | Enabled |
    +----------------------+-------------+----------------------+---------+
    | php:newrelic.license | environment | newrelic-license-key | true    |
    +----------------------+-------------+----------------------+---------+
   

   WARNING

   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

2. Delete the license variable.

   magento-cloud variable:delete php:newrelic.license
   

Business.Adobe.com resources