elastic-apm-sourcemap-webpack-plugin

ElasticAPMSourceMapPlugin

ElasticAPMSourceMapPlugin is a Webpack plugin that uploads sourcemaps generated by Webpack to a Elastic APM server.

Installation

Use npm:

$ npm install elastic-apm-sourcemap-webpack-plugin --save-dev

Use yarn:

$ yarn add elastic-apm-sourcemap-webpack-plugin --dev

Example

An example of webpack.config.js:

const ElasticAPMSourceMapPlugin = require('elastic-apm-sourcemap-webpack-plugin');
const path = require('path');
const PUBLIC_PATH = 'path/to/assets';

const webpackConfig = {
  mode: 'production',
  entry: path.resolve(__dirname, './entry.js'),
  publicPath: PUBLIC_PATH,
  output: {
    path: 'build',
    filename: 'index-[hash].js'
  },
  plugins: [
    new ElasticAPMSourceMapPlugin({
      serviceName: 'SERVICE_NAME',
      serviceVersion: 'SERVICE_VERSION',
      serverURL: 'https://ELASTIC_APM_SERVER_URL',
      publicPath: PUBLIC_PATH,
      secret: 'SECRET',
      logLevel: 'debug'
    })
  ]
};

Configuration

Pass an object to ElasticAPMSourceMapPlugin to configure the plugin. Available fields are:

serviceName: string

Required. Need to be the same value as in the APM RUM JavaScript agent configuration.

serviceVersion: string

Required. Need to be the same value as in the APM RUM JavaScript agent configuration.

serverURL: string

Required. The URL of the APM server to upload sourcemaps to.

publicPath: string

Required. The base path for the assets.

secret?: string

Optional. The secret token for uploading sourcemaps. This field is required if the APM server needs it.

logLevel?: 'info' | 'warn' | 'error' | 'trace' | 'debug' | 'silent'

Optional. Default to 'warn'. Level of the messages that ElasticAPMSourceMapPlugin will log.

License

MIT