• /
  • Log in
  • Free account

Requirements for the infrastructure agent

Before installing our infrastructure agent, make sure your system and any on-host integrations you configure meet the requirements.

Processor architectures

The infrastructure agent supports only x86 processor architectures:

  • Linux: 64-bit architecture (also requires 64-bit package manager and dependencies)
  • Windows: both 32 and 64-bit architectures
  • ARM: AWS Graviton 2 processor (using the tarball setup instructions). Support is limited to infrastructure monitoring. Integrations, such as log forwarding, may not work as expected.

Operating systems

The infrastructure agent supports these operating systems:

Operating system

Supported by the infrastructure agent

amazon linux.png Amazon Linux

All versions

centos icon CentOS

Version 7 or higher

Debian.png Debian

Version 8 ("Jessie") or higher

Docker icon Docker

Docker 1.12

Kubernetes icon Kubernetes

Tested with versions 1.10 to 1.16

redhat icon Red Hat Enterprise Linux (RHEL)

Version 6 or higher

suse icon SUSE Linux Enterprise Server (SLES)

Versions 11.4, 12.1, 12.2, 12.3, and 12.4

ubuntu icon Ubuntu

LTS versions 14.04.x, 16.04.x, 18.04.x, 20.04.x

Windows Server icon Windows

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

Windows 10 (only the infrastructure agent is supported).

Important

Operating systems are not supported beyond end-of-life.

Tip

You can 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.

Important

Servers named localhost are not reported: it's 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 Infrastructure. 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:

For more help

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

Create issueEdit page
Copyright © 2021 New Relic Inc.