Install Node.js agent manually

Install the latest version of the agent from npm by running this command from the application's root directory:

npm install @contrast/agent

Alternatively, if you use yarn, run this command to install the agent:

yarn add @contrast/agent

Set authentication keys with environment variables. Make sure your Node.js application has access to the environment variables at runtime.

Alternatively, set the configuration with YAML configuration using this template. Make sure the contrast_security.yaml is in the applications root directory.

Add this command to the scripts section of your application's package.json file:

"scripts": {
    "contrast": "node --import @contrast/agent app-main.js [app arguments]",
    "start": ...,
    "test": ...
}

Run your application with the agent:

npm run contrast

Exercise your application by performing either manual or automated testing to ensure your application is functioning correctly with the agent installed.

Verify that your server is registered in Contrast and reports an instance of your application.