Install the infrastructure monitoring agent for Windows

With New Relic's infrastructure monitoring agent for Windows, you can monitor individual servers and also analyze how your service performs as a whole. The Windows agent can run on your own hardware or in cloud systems such as Amazon EC2 or Windows Azure, and supports Windows Server and Windows 10. You can also install with Chef. Before installation, be sure to review the requirements.

Install for Windows Server and Windows 10 using our guided install

Create a New Relic account for free! No credit card required.

Get an account

Manual installation

If you'd like to do a manual installation, follow the next steps:

  1. Review the agent requirements and supported operating systems.
  2. Download the latest .MSI installer image from:
  • For 32-bit Windows:

    https://download.newrelic.com/infrastructure_agent/windows/386/newrelic-infra-386.msi‚Äč
  • For 64-bit Windows:

Important

Don't double-click the installer. This won't install the local agent fully and can result in permissions issues.

  1. Open PowerShell as an administrator, and run the install script using an absolute path:
  • For 32-bit Windows:

    bash
    $
    msiexec.exe /qn /i PATH\TO\newrelic-infra-386.msi
  • For 64-bit Windows:

    bash
    $
    msiexec.exe /qn /i PATH\TO\newrelic-infra.msi

For a scripted installation, you can pass in configuration parameters. You must first add GENERATE_CONFIG=true and LICENSE_KEY=YOUR_LICENSE_KEY, and then, you can add the following optional parameters:

bash
$
DISPLAY_NAME=YOUR_DISPLAY_NAME PROXY=http://YOUR_PROXY_SERVER:PROXY_PORT CUSTOM_ATTRIBUTES="{'ATTRIBUTE_1':'VALUE_1','ATTRIBUTE_2':'VALUE_2'}"

The following example sets the and configures a proxy server for outbound communication, as well as adding one custom attribute:

bash
$
msiexec.exe /qn /i PATH\TO\newrelic-infra.msi GENERATE_CONFIG=true LICENSE_KEY=YOUR_LICENSE_KEY PROXY=http://YOUR_PROXY_SERVER:PROXY_PORT CUSTOM_ATTRIBUTES="{'ATTRIBUTE_1':'VALUE_1'}"
  1. Add your to the license_key attribute in your newrelic-infra.yml file, located in C:\Program Files\New Relic\newrelic-infra\. When you're finished, your newrelic-infra.yml file should look like the following:

    license_key: YOUR_LICENSE_KEY
  2. To start the newrelic-infra service, run:

    bash
    $
    net start newrelic-infra

Wait a few minutes, then view your server in the Infrastructure UI. If no data appears after waiting a few minutes, follow the troubleshooting steps.

Install using zip files

For custom setup scenarios, you can install the infrastructure monitoring agent using our zip files in assisted or manual modes. This is especially useful when you need to adapt the default installation settings to your environment.

Caution

Installing the infrastructure monitoring agent using zip files isn't supported.

Did this doc help with your installation?

What's next?

The only required configuration option is the license_key setting, which is created as part of the installation procedures. You may also want to:

Update the agent

To upgrade to the latest version, follow standard procedures to update the infrastructure monitoring agent.

Remember. if you haven't already, create your free New Relic account below to start monitoring your data today.