From cab7517144ef35df9479ca7455b9ae006a4e7215 Mon Sep 17 00:00:00 2001 From: Margaret Eker Date: Fri, 6 Mar 2020 20:22:13 -0600 Subject: [PATCH 1/9] Per PR #6708 - Improve instructions for configuring Starter projects for New Relic reporting - Add prerequisites for credentials and role access required to add the license key to an environment - Link to alternative instructions for getting the New Relic license key from New Relic account, and adding the license key from the Magento Admin - Added separate H3 headings for Configure Starter for New Relic and Remove license key from Starter to make content easier to scan --- src/cloud/project/new-relic.md | 126 +++++++++++++++++++++------------ 1 file changed, 81 insertions(+), 45 deletions(-) diff --git a/src/cloud/project/new-relic.md b/src/cloud/project/new-relic.md index 4af9f0abfb1..922dc3a981f 100644 --- a/src/cloud/project/new-relic.md +++ b/src/cloud/project/new-relic.md @@ -8,26 +8,26 @@ functional_areas: - Services --- -[New Relic for application performance management (APM)](https://docs.newrelic.com/docs/apm/new-relic-apm/getting-started/introduction-new-relic-apm) is a software analytics product that helps you analyze and improve application interactions. New Relic APM is available to all {{site.data.var.ece}} accounts and provides the following features: +[New Relic for application performance management (APM)] is a software analytics product that helps you analyze and improve application interactions. New Relic APM is available to all {{site.data.var.ece}} accounts and provides the following features: - **Focus on specific transactions**—Actively mark and monitor key customer actions in your site, such as adding to the cart, checking out, or processing a payment. - **Database query monitoring**—Locate and monitor database queries affecting performance. - **App Map**—View all application dependencies within your Magento site, extensions, and external services. -- **Apdex scores**—Evaluate performance and create alerts that identify issues and notify you when they occur, such as site performance affected by a flash sale or web event. [Apdex score](https://docs.newrelic.com/docs/apm/new-relic-apm/apdex/apdex-measure-user-satisfaction). +- **Apdex scores**—Evaluate performance and create alerts that identify issues and notify you when they occur, such as site performance affected by a flash sale or web event. [Apdex score]. - **Adobe-generated alert policies**–Monitor application and infrastructure performance using alert policies that monitor key performance indicators like apdex score, disk space, and error rate based on industry best practices. See [Monitor performance using alerts](#monitor-performance-with-alert-policies). Your {{site.data.var.ece}} account includes the software for the New Relic APM service along with a license key. You do not need to purchase or install any additional software. -On {{site.data.var.ece}} Pro accounts, the Production environment also includes the [New Relic Infrastructure (NRI)](https://newrelic.com/products/infrastructure) service, which automatically connects with the application data and performance analytics to provide dynamic server monitoring. +On {{site.data.var.ece}} Pro accounts, the Production environment also includes the [New Relic Infrastructure (NRI)][6] service, which automatically connects with the application data and performance analytics to provide dynamic server monitoring. {:.bs-callout-info} For Pro accounts, 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 a [support ticket]({{ site.baseurl }}/cloud/trouble/trouble.html) to request installation. ## Manage your New Relic account -When Magento provisions your {{site.data.var.ece}} project, the Project Owner receives an email from New Relic with credentials and instructions for accessing the account. If you did not receive the email, use the Project Owner email address to [reset the New Relic password](https://rpm.newrelic.com/forgot_password). +When Magento provisions your {{site.data.var.ece}} project, the License Owner receives an email from New Relic with credentials and instructions for accessing the account. If you did not receive the email, use the License Owner email address to [reset the New Relic password]. -An 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, then assign the Owner role to another user. See [Update the account owner](https://docs.newrelic.com/docs/accounts/accounts/roles-permissions/change-account-owner) in the New Relic documentation for instructions. +An 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, then assign the Owner role to another user. See [Update the account owner] in the New Relic documentation for instructions. {:.bs-callout-tip} Before assigning the Owner role to a user, verify that the user exists on the New Relic account for {{site.data.var.ece}}. If you need to add the user to that account and an existing account Owner or Admin cannot help, any Magento user with access to the [Magento Partnership Owner Account][3] for New Relic can add users on behalf of the customer. @@ -37,9 +37,9 @@ We recommend adding at least one Admin user to your New Relic account to manage {:.procedure} To add a user: -1. Using your Project Owner New Relic credentials, [log in to New Relic](https://login.newrelic.com/login). +1. Using your License Owner New Relic credentials, [log in to New Relic][5]. -1. From the [account dropdown](https://docs.newrelic.com/docs/using-new-relic/welcome-new-relic/getting-started/glossary#account-dropdown) menu, select **Account settings** > **Account** > **Users and roles**. +1. From the [account dropdown] menu, select **Account settings** > **Account** > **Users and roles**. 1. Click **New user**. @@ -69,40 +69,52 @@ runtime: To connect a Cloud environment to New Relic, you must add the New Relic license key to the environment. -- For Pro accounts, Magento adds the license key to your Cloud environments during the provisioning process. You can log in to your New Relic account and verify connectivity. +- For Pro accounts, Magento adds the license key to your Cloud environments during the provisioning process. You can log in to your New Relic account to verify connectivity between your Magento Commerce site and New Relic. -- For Starter accounts, you have a New Relic license key that supports up to three environments. You must add the New Relic license key to your Starter Project environments. We recommend adding the key to the Staging and Production (master) environments, and one other environment of your choice. If you have more than three active environments using the same New Relic license key, you must remove the license variable from an existing environment. +- For Starter accounts, you have a New Relic license key that supports up to three environments. You must add the key to your environment configurations manually. The license key is not pre-provisioned on Starter environments. + +### Configure New Relic for Starter environments + +For Starter environments, you must add the New Relic license key to the environment configuration to enable New Relic reporting. We recommend adding the key to the Staging and Production (master) 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 _Magento User Guide_. + +{:.bs-callout-warning} +Updating the environment configuration triggers a redeployment, which takes your site offline until deployment completes. For Production environments, we recommend completing this work during off-peak hours to avoid service disruptions. See [Working with variables]. + +{:.prerequisites} + +- Log in credentials for the Magento Cloud project account page, or for the New Relic account associated with your project +- [Admin level access]({{site.baseurl}}/cloud/project/user-admin.html) to the Starter environments to configure, or [Magento Admin credentials](https://docs.magento.com/m2/ce/user_guide/system/permissions.html) to access the Magento Admin page for the environment. {:.procedure} -To find your New Relic license key: +To configure New Relic on a Starter environment: -1. Open your [account page](https://accounts.magento.cloud/user/). +1. Find your New Relic license key from your Magento account page, or [from your New Relic account page]: -1. On the _Projects_ tab, find your project. + - Open your [account page]. -1. Click **View Details** to see the project infrastructure information. + - On the _Projects_ tab, find your project. -1. Expand the **NewRelic Service** section to view the license key. + - Click **View Details** to see the project infrastructure information. - ![Cloud project details page]({{ site.baseurl }}/common/images/cloud/cloud-project-details-new-relic.png){:width="650px"} + - Expand the **New Relic Service** section to view the license key. -1. Copy the license key. + - Copy the license key. -{:.procedure} -To add a license key to an environment: +1. Add the New Relic license key to an environment using an environment variable, or [add it from the Magento Admin]: -1. Change to the environment that needs the license key. For Starter accounts, you need to use the license key to set a variable in the environment. + - Change to the environment that needs the license key. -1. Set the variable. + - Set the variable using the following Magento Cloud CLI command: - ```bash - magento-cloud variable:set php:newrelic.license - ``` + ```bash + magento-cloud variable:set php:newrelic.license + ``` - {:.bs-callout-info} - Adding a variable to an environment triggers a redeployment to update the environment variables and values. See [Working with variables]({{ site.baseurl }}/cloud/env/working-with-variables.html). + - [Log in to New Relic][5] to verify that it is receiving data. -1. [Log in to New Relic](https://login.newrelic.com/login) to verify that it is receiving data. +### Remove New Relic license key from a Starter environment + +If three active Starter environments already use the same New Relic license key, and you want to configure New Relic reporting on a different environment, you must remove the key from one of the configured environments before you can reuse it. {:.procedure} To remove a license key from an environment: @@ -127,20 +139,17 @@ To remove a license key from an environment: {:.bs-callout-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 pvget` -1. Delete a variable. +1. Delete the license variable. ```bash magento-cloud variable:delete php:newrelic.license ``` - {:.bs-callout-info} - Removing a variable from an environment triggers a redeployment to update the environment variables and values. See [Working with variables]({{ site.baseurl }}/cloud/env/working-with-variables.html). - ## Investigate performance -New Relic connects and monitors your infrastructure and application using PHP agents. After a Cloud environment [connects to New Relic](#connect-to-new-relic), you can review the data collected by the agent by logging into your New Relic account. +New Relic connects and monitors your infrastructure and application using PHP agents. After a Cloud environment [connects to New Relic][4], you can log in to your New Relic account to review the data collected by the agent. -On the APM Applications page, use the [New Relic APM Overview](https://docs.newrelic.com/docs/apm/applications-menu/monitoring/apm-overview-page-view-transaction-apdex-usage-data) to view information about your application. +On the APM Applications page, use the [New Relic APM Overview] to view information about your application. ![Cloud project New Relic overview page]({{ site.baseurl }}/common/images/cloud/cloud-newrelic-dashboard-basic.png){:width="650px"} @@ -160,31 +169,31 @@ We recommend reviewing tracked data: All collected data details the time spent on an action transmitting data, queries, or _Redis_ data. If queries cause issues, New Relic provides information to track and respond to those issues. {:.bs-callout-info} -You can learn more about using the New Relic APM and Infrastructure agents to collect and analyze application data from the [New Relic APM](https://docs.newrelic.com/docs/apm/new-relic-apm/getting-started/introduction-new-relic-apm) and [New Relic Infrastructure](https://docs.newrelic.com/docs/infrastructure/new-relic-infrastructure/getting-started/introduction-new-relic-infrastructure) documentation. +You can learn more about using the New Relic APM and Infrastructure agents to collect and analyze application data from the [New Relic APM] and [New Relic Infrastructure][6] documentation. ## Monitor performance with alert policies Adobe provides a set of New Relic alert policies for {{ site.data.var.ece }} Pro and Starter Production environments to track the following key performance metrics: -- [Apdex score](https://docs.newrelic.com/docs/apm/new-relic-apm/apdex/apdex-measure-user-satisfaction) +- [Apdex score] - error rate - disk space (available on Pro Production environments only) Based on industry best practices, these policies set thresholds for warning and critical conditions that affect performance. When your site experiences an infrastructure or application issue that triggers an alert threshold, New Relic sends alert notifications so that you can proactively address the issue. To use these policies, you must configure notification channels to receive the alert messages. {:.bs-callout-info} -For Pro Staging and Integration environments and Starter environments, use [Health notifications]({{ site.baseurl }}/cloud/integrations/health-notifications.html) to monitor disk space. +For Pro Staging and Integration environments and Starter environments, use [Health notifications] to monitor disk space. {:.procedure} Prerequisites -- Credentials to log in to the [New Relic account](#manage-your-new-relic-account) for your Cloud project. -- Verify that your Cloud environment is [connected to New Relic](#connect-to-new-relic). +- Credentials to log in to the [New Relic account] for your Cloud project. +- Verify that your Cloud environment is [connected to New Relic][4]. {:.procedure} To review Adobe-generated alert policies: -1. Use your Project Owner New Relic credentials to [log in to your New Relic account](https://login.newrelic.com/login). +1. Use your Project Owner New Relic credentials to [log in to your New Relic account][5]. 1. From the navigation menu, select  **Alerts**  > **Alert Policies**. @@ -203,16 +212,16 @@ To review Adobe-generated alert policies: To use the Adobe-generated alert policies to monitor your Production sites, you must configure notification channels and map them to alert policies. Notifications about performance issues go to all channels associated with an alert policy when conditions on the application or infrastructure trigger an alert. You also receive notifications when an issue is acknowledged and closed. -New Relic provides templates for configuring different types of notification channels including email, Slack, PagerDuty, webhooks, and more. See the [Instructions for specific notification channels](https://docs.newrelic.com/docs/alerts/new-relic-alerts/managing-notification-channels/notification-channels-control-where-send-alerts#channel-types) in the New Relic documentation to review the prerequisites for using each type. +New Relic provides templates for configuring different types of notification channels including email, Slack, PagerDuty, webhooks, and more. See the [Instructions for specific notification channels] in the New Relic documentation to review the prerequisites for using each type. The following instructions describe the high level steps to configure a notification channel to receive alert messages triggered by an alert policy. {:.procedure} To configure a notification channel: -1. Choose a notification channel type, and complete any [prerequisite steps](https://docs.newrelic.com/docs/alerts/new-relic-alerts/managing-notification-channels/notification-channels-control-where-send-alerts#channel-types) required to connect the channel with the New Relic service. +1. Choose a notification channel type, and complete any [prerequisite steps] required to connect the channel with the New Relic service. -1. [Log in to your New Relic account](https://login.newrelic.com/login). +1. [Log in to your New Relic account][5]. 1. Navigate to the _New Relic APM_ page. @@ -234,9 +243,9 @@ To configure a notification channel: See the following New Relic documentation topics for additional information: -- [Configure notification channels using the New Relic Alerts user interface](https://docs.newrelic.com/docs/alerts/new-relic-alerts/managing-notification-channels/notification-channels-control-where-send-alerts) +- [Configure notification channels using the New Relic Alerts user interface] -- [Configure notification channels using the New Relic API](https://docs.newrelic.com/docs/alerts/rest-api-alerts/new-relic-alerts-rest-api/rest-api-calls-new-relic-alerts#channels) +- [Configure notification channels using the New Relic API] {:.bs-callout-warning} The Adobe-generated policies have default notification channels configured to notify Magento teams that support {{ site.data.var.ece }} customers. Do not modify the configuration for these default channels, and do not remove any alert policies assigned to them. @@ -245,11 +254,38 @@ The Adobe-generated policies have default notification channels configured to no Do not modify the Adobe-generated alert policies. We will automatically regenerate and improve them over time, which will overwrite any customizations you make. -If you want to modify the thresholds of an alert condition, create a new alert policy. Then, copy the alert condition to the new policy. See [Update policies or conditions](https://docs.newrelic.com/docs/alerts/new-relic-alerts/configuring-alert-policies/update-or-disable-policies-conditions) in the New Relic documentation. +If you want to modify the thresholds of an alert condition, create a new alert policy. Then, copy the alert condition to the new policy. See [Update policies or conditions] in the New Relic documentation. {:.bs-callout-tip} -See [Alerts concepts and workflow](https://docs.newrelic.com/docs/alerts/new-relic-alerts/getting-started/new-relic-alerts-concepts-workflow) in the New Relic documentation for more detailed information about Alerts, alert policies, and notification channels. +See [Alerts concepts and workflow] in the New Relic documentation for more detailed information about Alerts, alert policies, and notification channels. [1]: https://docs.newrelic.com/docs/accounts/accounts/roles-permissions/change-account-owner [2]: https://docs.newrelic.com/docs/accounts/accounts/roles-permissions/add-update-users#adding_users [3]: https://account.newrelic.com/accounts/1311131/users +[4]: #connect-to-new-relic +[5]: https://login.newrelic.com/login +[6]: https://newrelic.com/products/infrastructure + +[New Relic for application performance management (APM)]: https://docs.newrelic.com/docs/apm/new-relic-apm/getting-started/introduction-new-relic-apm + +[Working with variables]: {{site.baseurl}}/cloud/env/working-with-variables.html +[Update the account owner]: https://docs.newrelic.com/docs/accounts/accounts/roles-permissions/change-account-owner +[account dropdown]: https://docs.newrelic.com/docs/using-new-relic/welcome-new-relic/getting-started/glossary#account-dropdown +[account page]: https://accounts.magento.cloud/user +[Apdex score]: https://docs.newrelic.com/docs/apm/new-relic-apm/apdex/apdex-measure-user-satisfaction +[reset the New Relic password]: https://rpm.newrelic.com/forgot_password +[New Relic APM Overview]: https://docs.newrelic.com/docs/apm/applications-menu/monitoring/apm-overview-page-view-transaction-apdex-usage-data +[New Relic APM]: https://docs.newrelic.com/docs/apm/new-relic-apm/getting-started/introduction-new-relic-apm +[New Relic account]: #manage-your-new-relic-account +[Health notifications]: {{site.baseurl}}/cloud/integrations/health-notifications.html +[Magento Admin credentials]: https://docs.magento.com/m2/ce/user_guide/system/permissions.html +[View your license key]: https://docs.newrelic.com/docs/accounts/install-new-relic/account-setup/license-key#finding +[New Relic reporting]: https://docs.magento.com/m2/ce/user_guide/configuration/general/new-relic-reporting.html +[add it from the Magento Admin]: https://docs.magento.com/m2/ce/user_guide/reports/new-relic-reporting.html#step-3-configure-your-store +[from your New Relic account page]: https://docs.newrelic.com/docs/accounts/install-new-relic/account-setup/license-key#finding +[Instructions for specific notification channels]: https://docs.newrelic.com/docs/alerts/new-relic-alerts/managing-notification-channels/notification-channels-control-where-send-alerts#channel-types +[prerequisite steps]: https://docs.newrelic.com/docs/alerts/new-relic-alerts/managing-notification-channels/notification-channels-control-where-send-alerts#channel-types +[Configure notification channels using the New Relic Alerts user interface]: https://docs.newrelic.com/docs/alerts/new-relic-alerts/managing-notification-channels/notification-channels-control-where-send-alerts +[Configure notification channels using the New Relic API]: https://docs.newrelic.com/docs/alerts/rest-api-alerts/new-relic-alerts-rest-api/rest-api-calls-new-relic-alerts#channels +[Update policies or conditions]: https://docs.newrelic.com/docs/alerts/new-relic-alerts/configuring-alert-policies/update-or-disable-policies-conditions +[Alerts concepts and workflow]: https://docs.newrelic.com/docs/alerts/new-relic-alerts/getting-started/new-relic-alerts-concepts-workflow From 2f922e8248b1ca106bf92e2535a077a6dca65975 Mon Sep 17 00:00:00 2001 From: Margaret Eker Date: Mon, 9 Mar 2020 09:17:23 -0500 Subject: [PATCH 2/9] Update src/cloud/project/new-relic.md --- src/cloud/project/new-relic.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/src/cloud/project/new-relic.md b/src/cloud/project/new-relic.md index 922dc3a981f..36ff9669d42 100644 --- a/src/cloud/project/new-relic.md +++ b/src/cloud/project/new-relic.md @@ -80,7 +80,8 @@ For Starter environments, you must add the New Relic license key to the environm {:.bs-callout-warning} Updating the environment configuration triggers a redeployment, which takes your site offline until deployment completes. For Production environments, we recommend completing this work during off-peak hours to avoid service disruptions. See [Working with variables]. -{:.prerequisites} +{:.procedure} +Prerequisites - Log in credentials for the Magento Cloud project account page, or for the New Relic account associated with your project - [Admin level access]({{site.baseurl}}/cloud/project/user-admin.html) to the Starter environments to configure, or [Magento Admin credentials](https://docs.magento.com/m2/ce/user_guide/system/permissions.html) to access the Magento Admin page for the environment. From 5837b71b6f265e2a068a7e8b076a9d86f7b47693 Mon Sep 17 00:00:00 2001 From: Margaret Eker Date: Mon, 9 Mar 2020 12:25:44 -0500 Subject: [PATCH 3/9] Minor edits --- src/cloud/project/new-relic.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/src/cloud/project/new-relic.md b/src/cloud/project/new-relic.md index 36ff9669d42..dd18c203a06 100644 --- a/src/cloud/project/new-relic.md +++ b/src/cloud/project/new-relic.md @@ -75,7 +75,7 @@ To connect a Cloud environment to New Relic, you must add the New Relic license ### Configure New Relic for Starter environments -For Starter environments, you must add the New Relic license key to the environment configuration to enable New Relic reporting. We recommend adding the key to the Staging and Production (master) 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 _Magento User Guide_. +For Starter environments, you must add the New Relic license key to the environment configuration to enable the New Relic integration. We recommend adding the key to the Staging and Production (master) 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 _Magento User Guide_. {:.bs-callout-warning} Updating the environment configuration triggers a redeployment, which takes your site offline until deployment completes. For Production environments, we recommend completing this work during off-peak hours to avoid service disruptions. See [Working with variables]. @@ -84,14 +84,14 @@ Updating the environment configuration triggers a redeployment, which takes your Prerequisites - Log in credentials for the Magento Cloud project account page, or for the New Relic account associated with your project -- [Admin level access]({{site.baseurl}}/cloud/project/user-admin.html) to the Starter environments to configure, or [Magento Admin credentials](https://docs.magento.com/m2/ce/user_guide/system/permissions.html) to access the Magento Admin page for the environment. +- [Admin level access]({{site.baseurl}}/cloud/project/user-admin.html) to the Starter environments to configure, or [Magento Admin credentials](https://docs.magento.com/m2/ce/user_guide/system/permissions.html) the Magento Admin UI for the environment. {:.procedure} To configure New Relic on a Starter environment: 1. Find your New Relic license key from your Magento account page, or [from your New Relic account page]: - - Open your [account page]. + - Open your [Magento account page]. - On the _Projects_ tab, find your project. @@ -111,7 +111,7 @@ To configure New Relic on a Starter environment: magento-cloud variable:set php:newrelic.license ``` - - [Log in to New Relic][5] to verify that it is receiving data. +1. [Log in to New Relic][5] to verify that you can view data from the Magento Cloud environment. (See [Investigate performance](#investigate-performance).) ### Remove New Relic license key from a Starter environment @@ -283,6 +283,7 @@ See [Alerts concepts and workflow] in the New Relic documentation for more detai [View your license key]: https://docs.newrelic.com/docs/accounts/install-new-relic/account-setup/license-key#finding [New Relic reporting]: https://docs.magento.com/m2/ce/user_guide/configuration/general/new-relic-reporting.html [add it from the Magento Admin]: https://docs.magento.com/m2/ce/user_guide/reports/new-relic-reporting.html#step-3-configure-your-store +[Investigate performance]: #investigate-performance [from your New Relic account page]: https://docs.newrelic.com/docs/accounts/install-new-relic/account-setup/license-key#finding [Instructions for specific notification channels]: https://docs.newrelic.com/docs/alerts/new-relic-alerts/managing-notification-channels/notification-channels-control-where-send-alerts#channel-types [prerequisite steps]: https://docs.newrelic.com/docs/alerts/new-relic-alerts/managing-notification-channels/notification-channels-control-where-send-alerts#channel-types From 6e1f88fb5b74aa6a5699401dc284e63c6c96b58c Mon Sep 17 00:00:00 2001 From: Margaret Eker Date: Mon, 9 Mar 2020 14:05:33 -0500 Subject: [PATCH 4/9] Editorial fix --- src/cloud/project/new-relic.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/cloud/project/new-relic.md b/src/cloud/project/new-relic.md index dd18c203a06..19a15f89ba7 100644 --- a/src/cloud/project/new-relic.md +++ b/src/cloud/project/new-relic.md @@ -84,7 +84,7 @@ Updating the environment configuration triggers a redeployment, which takes your Prerequisites - Log in credentials for the Magento Cloud project account page, or for the New Relic account associated with your project -- [Admin level access]({{site.baseurl}}/cloud/project/user-admin.html) to the Starter environments to configure, or [Magento Admin credentials](https://docs.magento.com/m2/ce/user_guide/system/permissions.html) the Magento Admin UI for the environment. +- [Admin level access]({{site.baseurl}}/cloud/project/user-admin.html) to the Starter environments to configure, or credentials to access the [Magento Admin](https://docs.magento.com/m2/ce/user_guide/system/permissions.html) for the environment. {:.procedure} To configure New Relic on a Starter environment: From 2edf9fe050ad332d118502b12affc56f91b83642 Mon Sep 17 00:00:00 2001 From: Margaret Eker Date: Tue, 10 Mar 2020 09:26:55 -0500 Subject: [PATCH 5/9] Fixed broken link reference --- src/cloud/project/new-relic.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/cloud/project/new-relic.md b/src/cloud/project/new-relic.md index 19a15f89ba7..bb9ee498328 100644 --- a/src/cloud/project/new-relic.md +++ b/src/cloud/project/new-relic.md @@ -83,15 +83,15 @@ Updating the environment configuration triggers a redeployment, which takes your {:.procedure} Prerequisites -- Log in credentials for the Magento Cloud project account page, or for the New Relic account associated with your project +- Log in credentials for the Magento account page, or for the New Relic account associated with your project - [Admin level access]({{site.baseurl}}/cloud/project/user-admin.html) to the Starter environments to configure, or credentials to access the [Magento Admin](https://docs.magento.com/m2/ce/user_guide/system/permissions.html) for the environment. {:.procedure} To configure New Relic on a Starter environment: -1. Find your New Relic license key from your Magento account page, or [from your New Relic account page]: +1. Find your New Relic license key from your Magento Cloud account page, or [from your New Relic account page]: - - Open your [Magento account page]. + - Open your [account page]. - On the _Projects_ tab, find your project. From 6afb42d4d5816153eabbdbb298a31452105a4e4f Mon Sep 17 00:00:00 2001 From: Margaret Eker Date: Tue, 10 Mar 2020 16:17:48 -0500 Subject: [PATCH 6/9] Update src/cloud/project/new-relic.md Co-Authored-By: hguthrie --- src/cloud/project/new-relic.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/src/cloud/project/new-relic.md b/src/cloud/project/new-relic.md index bb9ee498328..9078cf49bdb 100644 --- a/src/cloud/project/new-relic.md +++ b/src/cloud/project/new-relic.md @@ -260,6 +260,8 @@ If you want to modify the thresholds of an alert condition, create a new alert p {:.bs-callout-tip} See [Alerts concepts and workflow] in the New Relic documentation for more detailed information about Alerts, alert policies, and notification channels. + + [1]: https://docs.newrelic.com/docs/accounts/accounts/roles-permissions/change-account-owner [2]: https://docs.newrelic.com/docs/accounts/accounts/roles-permissions/add-update-users#adding_users [3]: https://account.newrelic.com/accounts/1311131/users From 01d52dfdea42b268e2338991a1860432e33c92dc Mon Sep 17 00:00:00 2001 From: Margaret Eker Date: Tue, 10 Mar 2020 16:18:07 -0500 Subject: [PATCH 7/9] Update src/cloud/project/new-relic.md Co-Authored-By: hguthrie --- src/cloud/project/new-relic.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/cloud/project/new-relic.md b/src/cloud/project/new-relic.md index 9078cf49bdb..e6df8f934a5 100644 --- a/src/cloud/project/new-relic.md +++ b/src/cloud/project/new-relic.md @@ -13,7 +13,7 @@ functional_areas: - **Focus on specific transactions**—Actively mark and monitor key customer actions in your site, such as adding to the cart, checking out, or processing a payment. - **Database query monitoring**—Locate and monitor database queries affecting performance. - **App Map**—View all application dependencies within your Magento site, extensions, and external services. -- **Apdex scores**—Evaluate performance and create alerts that identify issues and notify you when they occur, such as site performance affected by a flash sale or web event. [Apdex score]. +- **Apdex scores**—Evaluate performance and create alerts that identify issues and notify you when they occur, such as site performance affected by a flash sale or web event. See [Apdex score]. - **Adobe-generated alert policies**–Monitor application and infrastructure performance using alert policies that monitor key performance indicators like apdex score, disk space, and error rate based on industry best practices. See [Monitor performance using alerts](#monitor-performance-with-alert-policies). Your {{site.data.var.ece}} account includes the software for the New Relic APM service along with a license key. You do not need to purchase or install any additional software. From 3f2f5093c8d1624173df187c1b7aedf86606813e Mon Sep 17 00:00:00 2001 From: Margaret Eker Date: Tue, 10 Mar 2020 16:18:19 -0500 Subject: [PATCH 8/9] Update src/cloud/project/new-relic.md Co-Authored-By: hguthrie --- src/cloud/project/new-relic.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/cloud/project/new-relic.md b/src/cloud/project/new-relic.md index e6df8f934a5..7e01767fd25 100644 --- a/src/cloud/project/new-relic.md +++ b/src/cloud/project/new-relic.md @@ -101,7 +101,7 @@ To configure New Relic on a Starter environment: - Copy the license key. -1. Add the New Relic license key to an environment using an environment variable, or [add it from the Magento Admin]: +1. Add the New Relic license key to an environment using the Magento Cloud CLI, or [add it from the Magento Admin]: - Change to the environment that needs the license key. From 7a7b400d43d4f05f23389afde56fb5e88e90f72a Mon Sep 17 00:00:00 2001 From: Margaret Eker Date: Wed, 11 Mar 2020 13:33:52 -0500 Subject: [PATCH 9/9] Clean up link references - Changed all anchor reference links to inline links - Alphabetized link reference list - Removed numeric references --- src/cloud/project/new-relic.md | 60 ++++++++++++++++------------------ 1 file changed, 28 insertions(+), 32 deletions(-) diff --git a/src/cloud/project/new-relic.md b/src/cloud/project/new-relic.md index 7e01767fd25..4aa5000cfa9 100644 --- a/src/cloud/project/new-relic.md +++ b/src/cloud/project/new-relic.md @@ -18,7 +18,7 @@ functional_areas: Your {{site.data.var.ece}} account includes the software for the New Relic APM service along with a license key. You do not need to purchase or install any additional software. -On {{site.data.var.ece}} Pro accounts, the Production environment also includes the [New Relic Infrastructure (NRI)][6] service, which automatically connects with the application data and performance analytics to provide dynamic server monitoring. +On {{site.data.var.ece}} Pro accounts, the Production environment also includes the [New Relic Infrastructure (NRI)][New Relic infrastructure] service, which automatically connects with the application data and performance analytics to provide dynamic server monitoring. {:.bs-callout-info} For Pro accounts, 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 a [support ticket]({{ site.baseurl }}/cloud/trouble/trouble.html) to request installation. @@ -30,14 +30,14 @@ When Magento provisions your {{site.data.var.ece}} project, the License Owner re An 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, then assign the Owner role to another user. See [Update the account owner] in the New Relic documentation for instructions. {:.bs-callout-tip} -Before assigning the Owner role to a user, verify that the user exists on the New Relic account for {{site.data.var.ece}}. If you need to add the user to that account and an existing account Owner or Admin cannot help, any Magento user with access to the [Magento Partnership Owner Account][3] for New Relic can add users on behalf of the customer. +Before assigning the Owner role to a user, verify that the user exists on the New Relic account for {{site.data.var.ece}}. If you need to add the user to that account and an existing account Owner or Admin cannot help, any Magento user with access to the [Magento Partnership Owner Account] for New Relic can add users on behalf of the customer. We recommend adding at least one Admin user to your New Relic account to manage all access, integrations, and tool usage. {{site.data.var.ece}} Project Owners and Admin users can add and remove users from the New Relic account. {:.procedure} To add a user: -1. Using your License Owner New Relic credentials, [log in to New Relic][5]. +1. Using your License Owner New Relic credentials, [log in to New Relic][New Relic login]. 1. From the [account dropdown] menu, select **Account settings** > **Account** > **Users and roles**. @@ -111,7 +111,7 @@ To configure New Relic on a Starter environment: magento-cloud variable:set php:newrelic.license ``` -1. [Log in to New Relic][5] to verify that you can view data from the Magento Cloud environment. (See [Investigate performance](#investigate-performance).) +1. [Log in to New Relic][New Relic login] to verify that you can view data from the Magento Cloud environment. (See [Investigate performance](#investigate-performance).) ### Remove New Relic license key from a Starter environment @@ -148,7 +148,7 @@ To remove a license key from an environment: ## Investigate performance -New Relic connects and monitors your infrastructure and application using PHP agents. After a Cloud environment [connects to New Relic][4], you can log in to your New Relic account to review the data collected by the agent. +New Relic connects and monitors your infrastructure and application using PHP agents. After a Cloud environment [connects to New Relic](#connect-to-new-relic), you can log in to your New Relic account to review the data collected by the agent. On the APM Applications page, use the [New Relic APM Overview] to view information about your application. @@ -170,7 +170,7 @@ We recommend reviewing tracked data: All collected data details the time spent on an action transmitting data, queries, or _Redis_ data. If queries cause issues, New Relic provides information to track and respond to those issues. {:.bs-callout-info} -You can learn more about using the New Relic APM and Infrastructure agents to collect and analyze application data from the [New Relic APM] and [New Relic Infrastructure][6] documentation. +You can learn more about using the New Relic APM and Infrastructure agents to collect and analyze application data from the [New Relic APM] and [New Relic Infrastructure][New Relic infrastructure] documentation. ## Monitor performance with alert policies @@ -188,13 +188,13 @@ For Pro Staging and Integration environments and Starter environments, use [Heal {:.procedure} Prerequisites -- Credentials to log in to the [New Relic account] for your Cloud project. -- Verify that your Cloud environment is [connected to New Relic][4]. +- Credentials to log in to the [New Relic account] for your Cloud project +- Verify that your Cloud environment is [connected to New Relic](#connect-to-new-relic) {:.procedure} To review Adobe-generated alert policies: -1. Use your Project Owner New Relic credentials to [log in to your New Relic account][5]. +1. Use your Project Owner New Relic credentials to [log in to your New Relic account][New Relic login]. 1. From the navigation menu, select  **Alerts**  > **Alert Policies**. @@ -222,7 +222,7 @@ To configure a notification channel: 1. Choose a notification channel type, and complete any [prerequisite steps] required to connect the channel with the New Relic service. -1. [Log in to your New Relic account][5]. +1. [Log in to your New Relic account][New Relic login]. 1. Navigate to the _New Relic APM_ page. @@ -262,34 +262,30 @@ See [Alerts concepts and workflow] in the New Relic documentation for more detai -[1]: https://docs.newrelic.com/docs/accounts/accounts/roles-permissions/change-account-owner [2]: https://docs.newrelic.com/docs/accounts/accounts/roles-permissions/add-update-users#adding_users -[3]: https://account.newrelic.com/accounts/1311131/users -[4]: #connect-to-new-relic -[5]: https://login.newrelic.com/login -[6]: https://newrelic.com/products/infrastructure -[New Relic for application performance management (APM)]: https://docs.newrelic.com/docs/apm/new-relic-apm/getting-started/introduction-new-relic-apm - -[Working with variables]: {{site.baseurl}}/cloud/env/working-with-variables.html -[Update the account owner]: https://docs.newrelic.com/docs/accounts/accounts/roles-permissions/change-account-owner [account dropdown]: https://docs.newrelic.com/docs/using-new-relic/welcome-new-relic/getting-started/glossary#account-dropdown [account page]: https://accounts.magento.cloud/user -[Apdex score]: https://docs.newrelic.com/docs/apm/new-relic-apm/apdex/apdex-measure-user-satisfaction -[reset the New Relic password]: https://rpm.newrelic.com/forgot_password -[New Relic APM Overview]: https://docs.newrelic.com/docs/apm/applications-menu/monitoring/apm-overview-page-view-transaction-apdex-usage-data -[New Relic APM]: https://docs.newrelic.com/docs/apm/new-relic-apm/getting-started/introduction-new-relic-apm -[New Relic account]: #manage-your-new-relic-account -[Health notifications]: {{site.baseurl}}/cloud/integrations/health-notifications.html -[Magento Admin credentials]: https://docs.magento.com/m2/ce/user_guide/system/permissions.html -[View your license key]: https://docs.newrelic.com/docs/accounts/install-new-relic/account-setup/license-key#finding -[New Relic reporting]: https://docs.magento.com/m2/ce/user_guide/configuration/general/new-relic-reporting.html [add it from the Magento Admin]: https://docs.magento.com/m2/ce/user_guide/reports/new-relic-reporting.html#step-3-configure-your-store -[Investigate performance]: #investigate-performance +[Alerts concepts and workflow]: https://docs.newrelic.com/docs/alerts/new-relic-alerts/getting-started/new-relic-alerts-concepts-workflow +[Apdex score]: https://docs.newrelic.com/docs/apm/new-relic-apm/apdex/apdex-measure-user-satisfaction +[Configure notification channels using the New Relic Alerts user interface]: https://docs.newrelic.com/docs/alerts/new-relic-alerts/managing-notification-channels/notification-channels-control-where-send-alerts +[Configure notification channels using the New Relic API]: https://docs.newrelic.com/docs/alerts/rest-api-alerts/new-relic-alerts-rest-api/rest-api-calls-new-relic-alerts#channels [from your New Relic account page]: https://docs.newrelic.com/docs/accounts/install-new-relic/account-setup/license-key#finding +[Health notifications]: {{site.baseurl}}/cloud/integrations/health-notifications.html [Instructions for specific notification channels]: https://docs.newrelic.com/docs/alerts/new-relic-alerts/managing-notification-channels/notification-channels-control-where-send-alerts#channel-types +[Magento Admin credentials]: https://docs.magento.com/m2/ce/user_guide/system/permissions.html +[Magento Partnership Owner Account]: https://account.newrelic.com/accounts/1311131/users [prerequisite steps]: https://docs.newrelic.com/docs/alerts/new-relic-alerts/managing-notification-channels/notification-channels-control-where-send-alerts#channel-types -[Configure notification channels using the New Relic Alerts user interface]: https://docs.newrelic.com/docs/alerts/new-relic-alerts/managing-notification-channels/notification-channels-control-where-send-alerts -[Configure notification channels using the New Relic API]: https://docs.newrelic.com/docs/alerts/rest-api-alerts/new-relic-alerts-rest-api/rest-api-calls-new-relic-alerts#channels +[reset the New Relic password]: https://rpm.newrelic.com/forgot_password +[Update the account owner]: https://docs.newrelic.com/docs/accounts/accounts/roles-permissions/change-account-owner [Update policies or conditions]: https://docs.newrelic.com/docs/alerts/new-relic-alerts/configuring-alert-policies/update-or-disable-policies-conditions -[Alerts concepts and workflow]: https://docs.newrelic.com/docs/alerts/new-relic-alerts/getting-started/new-relic-alerts-concepts-workflow +[View your license key]: https://docs.newrelic.com/docs/accounts/install-new-relic/account-setup/license-key#finding +[Working with variables]: {{site.baseurl}}/cloud/env/working-with-variables.html +[New Relic account]: #manage-your-new-relic-account +[New Relic APM]: https://docs.newrelic.com/docs/apm/new-relic-apm/getting-started/introduction-new-relic-apm +[New Relic APM Overview]: https://docs.newrelic.com/docs/apm/applications-menu/monitoring/apm-overview-page-view-transaction-apdex-usage-data +[New Relic for application performance management (APM)]: https://docs.newrelic.com/docs/apm/new-relic-apm/getting-started/introduction-new-relic-apm +[New Relic login]: https://login.newrelic.com/login +[New Relic infrastructure]: https://newrelic.com/products/infrastructure +[New Relic reporting]: https://docs.magento.com/m2/ce/user_guide/configuration/general/new-relic-reporting.html