Install the infrastructure monitoring agent for macOS

With New Relic's infrastructure monitoring agent for macOS, you can monitor key performance metrics on macOS hosts. The agent can run on your own hardware or in cloud systems such as Amazon EC2.

The infrastructure monitoring agent is compatible with all generally available, Apple supported macOS versions.

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.

Install for macOS

Before installation, be sure to review the requirements. Then, to install the infrastructure monitoring agent for macOS, you can use our Guided Install, or follow the instructions in this document to complete a basic installation.

Limitations

The following capabilities of the infrastructure agent are not yet available on macOS:

Log forwarder.
On-host integrations (including built-in integrations such as Docker and Flex).
Automated deployment via Configuration Management tools (Chef, Ansible, Puppet).

Step-by-step instructions

To install the infrastructure monitoring agent, follow the step-by-step instructions:

Review the agent requirements and supported operating systems.
Make sure Homebrew is installed in the system. You can check if Homebrew is installed with:
```
which brew
```
If it's not installed, you can install it with this command (or check Homebrew up-to-date instructions):
```
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

Create the configuration file and add your license key:

echo "license_key: YOUR_LICENSE_KEY" | sudo tee -a /usr/local/etc/newrelic-infra/newrelic-infra.yml

Then, open the terminal and run the following command:
```
brew install newrelic/tap/newrelic-infra-agent -q
```
Start the infrastructure agent service:
```
brew services start newrelic-infra-agent
```

Wait a few minutes, then view your server in the Infrastructure UI. If no data appears after waiting a few minutes, follow the troubleshooting steps.

What's next?

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

Add custom attributes to annotate your infrastructure data.
Connect your AWS account if your servers are hosted on Amazon EC2.
Add other New Relic infrastructure integrations to collect data from external services.

Update the agent

To upgrade to the latest version, follow standard procedures to update the infrastructure monitoring agent.