• English日本語한국어
  • Log inStart now

Install the infrastructure agent

New Relic's infrastructure monitoring agent is a lightweight executable file that collects data about your hosts. It also reports data from some third party services, if enabled, and also log data.

The infrastructure monitoring agent can currently run on many Linux distributions, Windows, and macOS. There are multiple ways to install and deploy the agent, depending on your setup and needs. This document describes how the infrastructure monitoring agent works and how to install it. You'll need a New Relic account, so if you don't have one already, create it for free, forever.

Quick start: Use our guided install

The quickest way to get started with our infrastructure monitoring agent is through our guided install. Our guided install not only installs the infrastructure agent, but also attempts to discover services and log sources in your environment and recommends which to instrument.

Ready to get started? Click a button based on your New Relic data center region.

Guided install for US region

The guided install works with most setups. But if it doesn't suit your needs, you can find other methods below.

For more on where you can run the agent, check the compatibility and requirements page.

Important

The New Relic CLI does not support FedRAMP servers. If you're a FedRAMP customer, please refer to the manual installation instructions for our infrastructure agent for Linux or Windows.

Install the infrastructure monitoring agent

Linux

If you don't have a New Relic account yet, the guided install won't work. If you want to follow the procedure manually, see our tutorial.

Windows

If you don't have a New Relic account yet, the guided install won't work. If you want to follow the procedure manually using our MSI installer, see our tutorial.

Other installation scenarios

The infrastructure monitoring agent can be deployed programmatically using several config management and deploy tools:

Infrastructure can also be deployed in macOS.

Did this doc help with your installation?

One agent, many capabilities

Our infrastructure monitoring agent collects performance and health data about the system resources and processes of the host where it's enabled (on-premises or virtualized). At the same time, it acts as a forwarder for two types of data: core services metrics, which are collected by on-host integrations, and logs.

If you want to collect data about core services running on your host, you need to install the infrastructure monitoring agent first, and then install or enable on-host integrations.

Our infrastructure monitoring agent and its integrations collect data from the system and core services. It can also forward logs to New Relic. Backend application metrics (APM) are collected by separate language agents. Notice how each integration and forwarder feed different data types in the New Relic database (NRDB).

Check the source code

The infrastructure monitoring agent is open source software. That means you can browse its source code and send improvements, or create your own fork and build it. For more information, see the README.

What's next

After you've installed the infrastructure monitoring agent:

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.