• /
  • Log in

Install the infrastructure monitoring agent for Linux

Our infrastructure monitoring agent for Linux can be installed using several package managers. You can use our launcher, or follow the instructions in this document to complete a basic installation.

Tip

To use infrastructure monitoring and the rest of our observability platform, join the New Relic family! Sign up to create your free account in only a few seconds. Then ingest up to 100GB of data for free each month. Forever.

Quick start

The quickest way to get started with our infrastructure monitoring agent is through our guided install.

Tip

Try our guided install for yourself. (If you're hosted in the EU, use our EU guided install.)

Install using the launcher

Before installing our infrastructure monitoring agent for Linux, be sure to:

To install our infrastructure monitoring agent, click the button for your Linux distribution, then follow the instructions:

Amazon Linux
Amazon Linux
CentOS
CentOS
Docker
Container (Docker)
Debian
Debian
Red Hat
RHEL
SLES
SLES
Ubuntu
Ubuntu
Other Linux OS
Other Linux distros

To use the links above, you must be logged to your New Relic account.

If you don't have a New Relic account yet, or prefer to follow the procedure manually, see our step-by-step tutorial in the next section.

Step-by-step instructions

To install the infrastructure monitoring agent in Linux, follow these instructions:

  1. Create the configuration file and add your license key:

    echo "license_key: YOUR_LICENSE_KEY" | sudo tee -a /etc/newrelic-infra.yml
  2. Determine the distribution version number:

  3. Enable New Relic's GPG key.

  4. Add the infrastructure monitoring agent repository:

  5. Refresh the repositories:

  6. Install the newrelic-infra package in root (default), privileged user, or unprivileged user mode. For more information on each running mode, see Linux agent running modes.

Once the infrastructure monitoring agent is installed or updated, you can start, stop, or check the agent status.

Important

As of version 1.4.0, the infrastructure monitoring agent package includes the additional newrelic-infra-ctl binary, which is used to help troubleshoot a running agent. Although this binary is not required to execute the agent, we recommend to add it in your path.

Install using configuration management tools

To install the infrastructure monitoring agent with a configuration management tool, see the documentation for:

Install for Docker containers on instrumented hosts

See Docker instrumentation for infrastructure monitoring.

Install using Azure extensions

See Azure extensions for infrastructure monitoring.

Install using tarball files

For custom setup scenarios, you can install the infrastructure monitoring agent using our tarball files in assisted or manual modes.

This is especially useful when you need to adapt the default installation settings to your environment, or to install the infrastructure monitoring agent on distributions that lack the newrelic-infra package in their repositories.

Important

Installing the agent using tarball files is officially supported only for the AWS Graviton 2 processor.

Update the agent

Follow standard procedures to update the infrastructure monitoring agent.

If you are using sudo to install or update the agent, use the -E argument to allow bypassing the environment variables, or specify the NRIA_MODE environment variable just after sudo.

export NRIA_MODE="SET_MODE_HERE"

OR

sudo -E YOUR_PACKAGE_MANAGER_UPDATE_COMMAND

What's next?

Generate some traffic and wait a few minutes, then view your hosts in the New Relic One UI. If necessary, follow our troubleshooting procedures if no data appears.

Important

The hostname for your server cannot be localhost. Data will not be reported for servers with that name. Make sure the host name uses a unique name.

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

For more help

If you need more help, check out these support and learning resources:

Create issueEdit page
Copyright © 2021 New Relic Inc.