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.
The infrastructure agent supports these processor architectures:
- Linux: 64-bit for x86 processor architectures (also requires 64-bit package manager and dependencies)
- Windows: both 32 and 64-bit for x86 processor architectures
- ARM: arm64 architecture including AWS Graviton 2 processor is supported on compatible Linux operating sytems. On-host integrations are also supported (with the exception of the Oracle integration). Built-in log forwarding is not yet available.
- macOS (Beta): 64-bit x86 processor (M1 processor is not supported yet).
The infrastructure agent supports these operating systems up to their manufacturer's end-of-life.
Supported by the infrastructure agent
Version 7 or higher
Version 8 ("Jessie") or higher
Tested with versions 1.10 to 1.21
Version 6 or higher
Versions 11.4, 12.1, 12.2, 12.3, and 12.4
LTS versions 16.04.x, 18.04.x, 20.04.x
Windows Server 2012, 2016, and 2019, and their service packs.
Windows 10 (only the infrastructure agent is supported).
macOS 10.14 (Mohave), 10.15 (Catalina), 11 (Big Sur).
You can also monitor Amazon BottleRocket workloads:
- When running EC2 instances, use the containerized agent.
- On EKS, install the Kubernetes integration.
- For ECS clusters, deploy the ECS integration.
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_namesetting to override the default hostname.
- Servers named
localhostare not reported because this is a default name and inherently non-unique.
The infrastructure agent requires these permissions:
- Linux: By default, the agent runs and installs as root. You can also select privileged or unprivileged run modes.
- Windows: The agent must be installed from an Administrator account and requires Administrator privileges to run.
- macOS: The agent can be installed from any user account.
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.
The infrastructure agent instruments Docker containers when installed on the host server. We support Docker versions 1.12 or higher.
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.
The infrastructure agent can be deployed programmatically using several config management and deploy tools:
If you need more help, check out these support and learning resources:
- Browse the Explorers Hub to get help from the community and join in discussions.
- Find answers on our sites and learn how to use our support portal.
- Run New Relic Diagnostics, our troubleshooting tool for Linux, Windows, and macOS.
- Review New Relic's data security and licenses documentation.