Skip to content

syntactic-salt/browserslist-new-relic

Repository files navigation

browserslist-new-relic

A CLI tool that generates a custom usage data file for Browserslist from your New Relic Browser data.

npm package total downloads node version license open issues Tests

How to use

Before you can run the command you'll need to prepare the following information:

  • New Relic Browser application ID
  • New Relic account ID
  • New Relic Insights query API key

Check out the Options section for specific details.

In the root of your project run

npx browserslist-new-relic --appId <application id> --accountId <account id> --apiKey <api key>

Now that you've successfully run the command you'll have generated browserslist-stats.json in your project's root directory. This file contains your custom usage data from New Relic. In your browserslist config you can now do things like:

> 0.5% in my stats

or

> 0.5% in my stats, > 1% in US

Options

--version    Show version number                                     [boolean]
--accountId  New Relic account ID                          [string] [required]
--apiKey     New Relic Insights query API key              [string] [required]
--appId      New Relic Browser application ID              [string] [required]
--debug      Turn on debugging output               [boolean] [default: false]
--duration   Days of browser usage to fetch              [number] [default: 7]
--help       Show help                                               [boolean]

--accountId

The New Relic account ID that you want to retrieve data for. For information on where to find your account ID, check the New Relic docs.

  • Default: None
  • Environment Variable: BROWSERSLIST_NEW_RELIC_ACCOUNT_ID
  • Required: Yes

--apiKey

A New Relic Insights query API key. For information on creating a query API key, check the New Relic docs.

  • Default: None
  • Environment Variable: BROWSERSLIST_NEW_RELIC_API_KEY
  • Required: Yes

--appId

The New Relic Browser application ID that you want to retrieve data for. For more information on where to find your application ID, check the New Relic docs.

  • Default: None
  • Environment Variable: BROWSERSLIST_NEW_RELIC_APP_ID
  • Required: Yes

--debug

Turns on output used for debugging issues.

  • Default: false
  • Environment Variable: None
  • Required: No

--duration

The number of days of browser usage data to fetch.

  • Default: 7
  • Environment Variable: None
  • Required: No

--help

Outputs information about the options.

  • Default: None
  • Environment Variable: None
  • Required: No

--version

Outputs some helpful information about the command.

  • Default: None
  • Environment Variable: None
  • Required: No

Example Usage

With all required options

browserslist-new-relic --appId 48927374561 --accountId 45182429 --apiKey Hus4-hsSDFjls802dsSfjI82-PZhsqotm2H86

With all required options as environment variables

browserslist-new-relic

With duration of 2 days

browserslist-new-relic --duration 2 --appId 48927374561 --accountId 45182429 --apiKey Hus4-hsSDFjls802dsSfjI82-PZhsqotm2H86

With debugging output

browserslist-new-relic --debug --appId 48927374561 --accountId 45182429 --apiKey Hus4-hsSDFjls802dsSfjI82-PZhsqotm2H86

Issues

Please report any issues on GitHub.