Skip to main content

New Relic

Create deployment markers in New Relic APM to track code changes alongside performance data.

Setup

  1. Create a New Relic User API Key (format: NRAK-XXXXXXXXXXXXXXXXXXXXXX).
  2. Add NEWRELIC_ENABLED (or VORTEX_NOTIFY_NEWRELIC_ENABLED) to hosting environment variables for environments where New Relic is configured.
  3. Add VORTEX_NOTIFY_NEWRELIC_USER_KEY to your hosting provider's environment variables.
Enable only where needed

Set NEWRELIC_ENABLED=true only in environments where New Relic APM is configured (typically production and staging). This avoids API calls and potential errors in development or feature branch environments.

Environment variables

VariableRequiredDefaultLocationDescription
VORTEX_NOTIFY_NEWRELIC_ENABLEDYesNEWRELIC_ENABLEDHostingEnable New Relic notifications
VORTEX_NOTIFY_NEWRELIC_USER_KEYYesHostingNew Relic User API Key
VORTEX_NOTIFY_NEWRELIC_PROJECTNoVORTEX_NOTIFY_PROJECT.envProject name
VORTEX_NOTIFY_NEWRELIC_APP_NAMENoAuto-generated.envApplication name
VORTEX_NOTIFY_NEWRELIC_DESCRIPTIONNoDefault template.envDeployment description
VORTEX_NOTIFY_NEWRELIC_CHANGELOGNoDescription.envDeployment changelog
VORTEX_NOTIFY_NEWRELIC_USERNoDeployment robot.envUser performing deployment
VORTEX_NOTIFY_NEWRELIC_ENDPOINTNohttps://api.newrelic.com/v2.envAPI endpoint
VORTEX_NOTIFY_NEWRELIC_BRANCHESNomain,master,develop.envRestrict to specific branches (comma-separated)

Example

New Relic deployment marker