Server-side agent configuration

Server-side configuration transitions some core settings from your language agent's configuration file to the New Relic collector. Depending on the language agent, available settings may include:

  • Transaction tracing
  • SQL recording and logging
  • SQL query plans
  • Error collection
  • Thread profiling
  • Cross application tracing

Centralization and security

Server-side configuration provides an easy way to manage the available settings from the New Relic UI. Centralized configuration settings can also help you ensure standards compliance and security management for your settings.

Any change automatically applies to all New Relic APM agents, even if they run across multiple hosts. The agent still follows the local configurations for any settings not available from the UI.

Server-side configuration precedence

This feature provides the convenience of managing the available configuration settings directly within the New Relic UI, without the need for deployments or restarts. Available options to change settings, and the order of precedence they take when you utilize environment variables or other configuration options, will depend on the language agent used.

For more information about the hierarchy of settings, see the illustration for the specific agent:

Enable server-side configuration

Owner, Admins or Add-on Managers

Neither the PHP agent nor the Go agent support server-side configuration. To enable server-side configuration settings for apps that use other New Relic agents:

  1. Go to rpm.newrelic.com/apm > (select an app) > Settings > Application > Server-side agent configuration.

    OR

    Go to rpm.newrelic.com/apm. Next, from the index of applications, select the app's gear fa-gear icon, then select View settings > Server-side agent configuration.

  2. Set the Server-side configuration enabled toggle to On.
  3. Select Save server-side configuration.

After you enable server-side configuration, you can view and change the available settings through the UI.

View or change server-side configuration settings

Owner, Admins or Add-on Managers

If you use server-side configuration, you must still include your license_key and app_name in the local config file. These settings are required for the agent to communicate with the New Relic collector. (Neither the PHP agent nor the Go agent support server-side configuration.)

To view or change the available server-side configuration settings through the UI:

  1. Go to rpm.newrelic.com/apm > (select an app) > Settings > Application > Server-side agent configuration.

    OR

    Go to rpm.newrelic.com/apm. Next, from the index of applications, select the app's gear fa-gear icon, then select View settings > Server-side agent configuration.

  2. View or change the available configuration settings for your agent.
  3. If you make changes, select Save server-side configuration.

Once you set any of these options from the UI, they will override any conflicting options in the agent's configuration file.

Disable server-side configuration

To disable individual server-side configuration settings:

  1. Follow standard procedures to change server-side configuration settings.
  2. For each configuration option you want to disable, set its toggle to Off.
  3. Select Save server-side configuration.

To disable server-side configuration completely, get support at support.newrelic.com. This helps mitigate issues that could arise from conflicts with configuration settings if you need to transition back to a local configuration setup.

For more help

Recommendations for learning more: