The Browser Logs in Context (LIC) Open Source Project is a collaborative effort to display and provide additional context when dealing with JavaScript errors. Specifically this use case is looking at scenarios where the a JavaScript error has occured in the Browser AND the Browser is yet to interact with backend service. In these cases, the user will not be able to take advantage of standard New Relic Distributed Tracing. As such since there is no trace.id that has been produced, the user will also not be able to take advantage of New Relic Logs in Context.
The Browers LIC is an opinionated first release. It is assumed that users who take advantage of this open source application have the ability to produce their own universal ID that can be utilized by this application. For the sake of this release, the author has utilized an attribute called UUID or Universal User Id. The UUID in concert with the entityGUID is utilized to locate relevant content from New Relic logs.
Once the application has been deployed, please proceed to New Relic Browser Application and click on JS Error Logs
Examples of User Code and references will be posted here. It is with this code that the user will be sending Browser specific content that can be ingested by New Relic log forwarder
This project is distributed under the Apache 2 license.
New Relic One Community A community-driven library of useful components for building on New Relic One's programmability platform.
First, ensure that you have Git, NPM, and NR1 CLI installed. If you're unsure whether you have one or both of them installed, run the following command(s) (If you have them installed these commands will return a version number, if not, the commands won't be recognized):
git --version
npm -v
nr1 --version
Next, clone this repository and run the following scripts:
nr1 nerdpack:clone -r https://github.com/evanhaxton/Browser-LIC.git
nr1 nerdpack:uuid -gf
npm install
npm start
Visit https://one.newrelic.com/?nerdpacks=local, navigate to the Nerdpack, and ✨
Open a command prompt in the nerdpack's directory and run the following commands.
# To create a new uuid for the nerdpack so that you can deploy it to your account:
# nr1 nerdpack:uuid -g [--profile=your_profile_name]
# To see a list of APIkeys / profiles available in your development environment:
# nr1 profiles:list
nr1 nerdpack:publish [--profile=your_profile_name]
nr1 nerdpack:deploy [-c [DEV|BETA|STABLE]] [--profile=your_profile_name]
nr1 nerdpack:subscribe [-c [DEV|BETA|STABLE]] [--profile=your_profile_name]
Visit https://one.newrelic.com, navigate to the Nerdpack, and ✨
Please do not report issues with Browser LIC to New Relic Global Technical Support. Instead, visit the Explorers Hub
for troubleshooting and best-practices.
Issues and enhancement requests can be submitted in the Issues tab of this repository. Please search for and review the existing open issues before submitting a new issue.
As noted in our security policy, New Relic is committed to the privacy and security of our customers and their data. We believe that providing coordinated disclosure by security researchers and engaging with the security community are important means to achieve our security goals.
If you believe you have found a security vulnerability in this project or any of New Relic's products or websites, we welcome and greatly appreciate you reporting it to New Relic through HackerOne.
Contributions are welcome (and if you submit a Enhancement Request, expect to be invited to contribute it yourself 😁). Please review our Contributors Guide.
Keep in mind that when you submit your pull request, you'll need to sign the CLA via the click-through using CLA-Assistant. If you'd like to execute our corporate CLA, or if you have any questions, please drop us an email at opensource@newrelic.com.