AppDynamics Application Intelligence Platform

3.9.x Documentation


Learn by Watching

Doc Maps

Skip to end of metadata
Go to start of metadata

Use these instructions to install the Node.js Agent using the Agent Download Wizard in the Controller.

If you downloaded the agent from the AppDynamics download zone, see Install the Node.js Agent.

Before You Begin

  1. Confirm you have access to a controller, the web application where you monitor your application performance:
    • If you use a SaaS controller, AppDynamics sent you the controller host in your Welcome Email.
    • If you use the on-premise controller, you supplied the host and port at install time.
  2. Verify you have root access to run the install.
  3. Verify support for your environment at Supported Environments and Versions for Node.js.


Instrumenting Your Node.js Application with the Node.js Agent

There are four steps to instrument your Node.js application and begin monitoring:

1. Setup: Use the Agent Download Wizard to set up the agent.
2. Install and Configure: Run the install script and configure the connection to the controller.
3. Apply Load: Restart your application and apply load to activate instrumentation.
4. View Your Application: Log on to the Controller to monitor application performance.

Set up the Node.js Agent

The Agent Download Wizard walks you through configuration steps and helps you download the agent.

1. Log on to the Controller and click the Agent Download Wizard tab.

The download wizard configures the agent with information to connect to the Controller.


2. Click Node.js, then click Next.


3. The Controller Location URL window displays the connection info for the Controller. Click Next.

Click SSL to enable SSL encryption between the agent and the Controller. Enter the SSL port. For AppDynamics SaaS, the SSL port is 443.


4. Enter an application name or, click an existing application name if one exists. Then click Next.

For new users, it is OK to use the default "MyApp". You can change it later when know more about how you want to organize your applications in AppDynamics.


5. Enter a tier name. Then click Next.

For new users, it is OK to use the default "MyTier". You can change it later when know more about how you want to organize your applications in AppDynamics.


Install and Configure

1. From the root directory of your Node.js application run this command: npm install appdynamics

2. Insert the require statement generated by the wizard in the application source code at the first line of the main module (such as the server.js file), before any other require statements. You can copy the code in the wizard and paste it directly into your application. Each require statement is especially generated for your app based on the values you configured in the previous setup steps.

Now you're ready to restart your application and put some load on it.

Apply load to your application

  1. Restart your application
  2. Apply load to your application.

    The agent instruments the application code and reports metrics back to the Controller. You're ready to begin monitoring.

View your application

Log on to the Controller to see your application in action.

From here, you can install more agents or you can begin monitoring your application. The links below will help you get started:

Learn More