With New Relic's infrastructure 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 hardware or in cloud systems such as Amazon EC2 or Windows Azure, and supports Windows Server and Windows 10 and 11. You can also install with Chef. Before installation, be sure to review the requirements.
Install for Windows using our guided install
Create a New Relic account for free! No credit card required.
Manual installation
If you'd like to do a manual installation, follow the next steps:
Review the agent requirements and supported operating systems.
Download the latest .MSI installer image from:
For 32-bit Windows:
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.
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.msiFor 64-bit Windows:
bash$msiexec.exe /qn /i PATH\TO\newrelic-infra.msi
For a scripted installation, you can pass a limited set of agent settings as configuration parameters. You must first add
GENERATE_CONFIG=true
andLICENSE_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'}" METRICS_SYSTEM_SAMPLE_RATE=30 METRICS_STORAGE_SAMPLE_RATE=30 METRICS_NETWORK_SAMPLE_RATE=30 METRICS_PROCESS_SAMPLE_RATE=30 PAYLOAD_COMPRESSION_LEVEL=6Advanced customization is available via
NRIA_
environment variables and agent configuration file, learn how to configure the agent.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'}"Add your to the
license_key
attribute in yournewrelic-infra.yml
file, located inC:\Program Files\New Relic\newrelic-infra\
. When you're finished, yournewrelic-infra.yml
file should look like the following:license_key: YOUR_LICENSE_KEYTo 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 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 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:
- Learn to use your host data to troubleshoot an incident.
- Add custom attributes to annotate your infrastructure data.
- Connect your AWS account if your servers are hosted on Amazon EC2.
- Enable log forwarding.
- Add other New Relic infrastructure integrations to collect data from external services.
Update the agent
To upgrade to the latest version, follow standard procedures to update the infrastructure agent.