• EnglishEspañol日本語한국어Português
  • Log inStart now

Requirements for the infrastructure agent

Before installing our infrastructure agent, make sure your system and any on-host integrations you configure meet the requirements. You also need a New Relic account. Sign up for free. No credit card required.

Processor architectures

The infrastructure agent supports these processor architectures:

Operating systems

The infrastructure agent supports these operating systems up to their manufacturer's end-of-life. The agent might still be compatible with older versions, but please refer to the step-by-step instructions for each operating system if the guided installation is no longer available for a specific operating system version.

Operating system

Supported by the infrastructure agent

amazon linux.pngAmazon Linux 2, Amazon Linux 2023

All versions

centos iconCentOS

CentOS Stream 9 or higher

Debian.pngDebian

Version 11 ("bullseye") or higher

Docker iconDocker

See container monitoring requirements

Kubernetes iconKubernetes

See Kubernetes integration requirements

redhat iconRed Hat Enterprise Linux (RHEL)

Version 7.9 or higher

Oracle iconOracle Linux

Version 7.9 or higher

suse iconSUSE Linux Enterprise Server (SLES)

Versions 12.5, 15.2, 15.3, 15.4, 15.5

ubuntu iconUbuntu

LTS versions 16.04.x, 18.04.x, 20.04.x, 22.04.x, 24.04.x Interim releases 20.10, 21.04.

Windows Server iconWindows

Windows Server 2016, 2019, and 2022, and their service packs.

Windows 10, Windows 11, and their service packs.

macOS iconmacOS

3 most recent major versions. Currently: 12 (Monterey), 13 (Ventura), 14 (Sonoma).

You can also monitor Amazon BottleRocket workloads:

Unique hostname

The infrastructure agent uses the hostname to uniquely identify each server. To avoid inaccurate metrics from combining multiple servers under a single hostname, make sure that each monitored server has a unique hostname.

  • You can use the optional display_name setting to override the default hostname.
  • Servers named localhost are not reported because this is a default name and inherently non-unique.

Permissions

The infrastructure agent requires these permissions:

Libraries

For agent versions 1.1.19 or higher, you need the libcap library in order to install. It's available in the official repositories of your distribution.

Network access

In order to report data to New Relic, our infrastructure agent must have outbound access to certain domains and ports. If your system needs a proxy to connect to these domains, use the proxy setting.

Container software

The infrastructure agent instruments Docker containers when installed on the host server. We support Docker versions 1.12 or higher.

CPU, memory, and disk usage

The infrastructure agent is fairly lightweight. For typical CPU, memory, and disk usage, see our page on agent performance overhead. For more information on supported file systems, see Storage sample attributes.

Configuration management tools

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

Other integrations

If you're installing the Kubernetes integration, make sure that you meet the Kubernetes compatibility and requirements.

Copyright © 2024 New Relic Inc.

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