Skip to content

NPM version


This document details how to download and install the Node.js agent. Before installing the agent, review the requirements below. YOUTUBE


  • Node.js 10+

Install guide

  1. Install the NerdVision package npm i @nerdvision/agent
  2. Import it into your application const {nerdvision} = require('@nerdvision/agent')
  3. As early as possible in the Node app, add nerdvision.init('API_KEY')
  4. Replace 'API_KEY' with your API key from NerdVision Account
  5. The init function returns a promise. Once this has resolved, you're good to go


To see what options are available for configuring the agent, take a look at the Configuration

Known issues

  • When using a pre-processor for JavaScript, such as TypeScript, if files are lazy loaded at runtime their tracepoints may not trigger until they have been run for a second time.

What's next?

After you install the agent, here are some suggestions for what to do next:

  • Login to NerdVision and create a workspace for your app.
  • Set a tracepoint on a line of real code (not comments) by clicking in the gutter.
  • Execute an action in the app that will cause the tracepoint to fire and a snapshot should arrive.
  • Look at the snapshot to see what live data from you app looks like.
  • Debug all your apps!

Need more help?