@edx/new-relic-source-map-webpack-plugin
DefinitelyTyped icon, indicating that this package has TypeScript declarations provided by the separate @types/edx__new-relic-source-map-webpack-plugin package

2.1.0 • Public • Published

new-relic-source-map-webpack-plugin

Upload source maps to new relic as part of a webpack build.

Install

npm install @edx/new-relic-source-map-webpack-plugin --save-dev

Setup

Instantiate the plugin and add it to your plugins array.

applicationId, apiKey, and staticAssetUrl are required unless noop is true. Full list of options in the next section.

const NewRelicSourceMapPlugin = require('new-relic-source-map-webpack-plugin');

module.exports = {
    ...webpackConfig,
    plugins: [
        ...yourPlugins,
        new NewRelicSourceMapPlugin({
            applicationId: 'YOUR NEW RELIC APP ID',
            apiKey: process.env.NEW_RELIC_ADMIN_KEY,
            staticAssetUrl: 'http://examplecdn.com',
            noop: typeof process.env.NEW_RELIC_ADMIN_KEY === 'undefined', // upload source maps in prod builds only
        })
    ]   
}

If you're using releaseName and releaseId, make sure one or both are unique per build and that you use the newrelic.addRelease method in your code to identify the release.

Customize

Property Type Description
applicationId string applicationId as defined here
apiKey string API Key as defined here
staticAssetUrl string the domain your production assets are served from. Written as a complete url. Example: "https://www.examplecdn.com"
staticAssetUrlBuilder function A function for building the production url your js file is built from. Will be called for every javascript file with four arguments: staticAssetUrl, the public path from your webpack config, the filename, and the webpack stats instance. Defaults to ${removeLastCharIfSlash(url)}${removeLastCharIfSlash(publicPath)}/${file}
extensionRegex regex a regex used to find js files. Defaults to /\.js$/
noop boolean control boolean that decides whether or not to run the plugin. Set to true for builds where you don't want to upload assets to new relic.
releaseName string [Optional] unique identifier for the release name
releaseId string [Optional] unique version for the release identifier
errorCallback function [Optional] A function for error callback. Default is console.warn(`New Relic sourcemap upload error: ${err}`)

Package Sidebar

Install

npm i @edx/new-relic-source-map-webpack-plugin

Weekly Downloads

6,359

Version

2.1.0

License

AGPL-3.0

Unpacked Size

55.2 kB

Total Files

19

Last publish

Collaborators

  • openedx-semantic-release-bot
  • feanil
  • edx-old-org
  • edx-semantic-release