Activate New Relic
On WordPress VIP, New Relic is an Integration that can be added to an organization then activated on any application environment. By default, New Relic is disabled for an environment.
Prerequisite
To activate or deactivate New Relic for an environment, a user must have an an App admin role for that application or an Org admin role.
To activate the New Relic Integration for an environment:
- Navigate to the VIP Dashboard for an application.
- Select “Integrations” from the sidebar navigation at the left of the screen to access the App Integrations panel.
- Select “New Relic” from the list of Integrations in the App Integrations panel.
- Integration activation is environment-specific. If needed, select a different environment (e.g., staging, develop) from the dropdown located at the upper left of the VIP Dashboard application view.
- On the right-hand side of the New Relic row, select the linked text with the value “Configure” to access the Configure Integration panel.
- In the section labeled “Activate Integration“, activate New Relic for the environment by toggling the switch to “Active” (green background with a white check mark).
- In the modal titled “Confirm New Relic activation?” select the button labeled “Confirm“.
After about 5 minutes have elapsed, the New Relic dashboard for the environment can be accessed by selecting the button labeled “View in New Relic“. Allow up to 10 minutes to elapse before data appears in the New Relic dashboard.
Activation for Node.js environments
After New Relic is activated on a Node.js environment, the New Relic NPM package must be installed in the Node.js application for the New Relic Integration to work as expected. The necessary commands for installation are provided in the Configure Integration panel after the “Activate Integration“ option is toggled on for a Node.js environment. The application’s entrypoint is the file called to start the Node.js application. Loading New Relic as early as possible is crucial for allowing it to monitor the entire application.
- If New Relic is enabled for a Node.js site’s WordPress backend environment, and both environments are hosted at VIP, the Node.js application environments and the WordPress application environments will be accessible from within the same New Relic dashboard.
- The Node.js agent API can be used to create custom errors and metrics and report them to New Relic.
- The environment variables supplied by VIP will not be present in a local environment. As a result, when a local development environment is started, a warning that New Relic is not available may appear in the console. This warning can be ignored.
Caution
VIP configures New Relic automatically using environment variables. Do not configure the New Relic agent via newrelic.js or attempt to override the environment variables.
Activation for non-production environments
The New Relic Integration can also be activated for an application’s non-production environments. New Relic activation on non-production environment is temporary and will auto-deactivate after 7 days.
Deactivate
To deactivate the New Relic Integration from an environment:
- Navigate to the VIP Dashboard for an application.
- Select “Integrations” from the sidebar navigation at the left of the screen to access the App Integrations panel.
- Select “New Relic” from the list of Integrations on the App Integrations panel.
- Integration activation is environment-specific. If needed, select a different environment (e.g., staging, develop) from the dropdown located at the upper left of the VIP Dashboard application view.
- On the right-hand side of the New Relic row, select the linked text with the value “Configure” to access the Configure Integration panel.
- In the section labeled “Activate Integration“, deactivate New Relic by toggling the switch to “Inactive” (grey background with a white “x”).
- In the modal titled “Confirm New Relic deactivation?” select the button labeled “Confirm“.
Last updated: December 02, 2025