Install the infrastructure agent for macOS

With New Relic's infrastructure 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.

Our infrastructure agent has compatiblity with all generally available, Apple-supported macOS versions.

Install for macOS

Before installation, you should review the requirements. Then, to install the infrastructure 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 agent, follow the step-by-step instructions:

1. Review the agent requirements and supported operating systems.

2. Make sure Homebrew is installed in the system. You can check your Homebrew installation with:

   bash

   Copy

   $
   which brew

   If it's not installed, you can install it with this command (or check Homebrew up-to-date instructions):

   bash

   Copy

   $
   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

3. Then, open the terminal and run the following command::

   bash

   Copy

   $
   brew install newrelic-infra-agent -q

4. Start the infrastructure agent service:

   bash

   Copy

   $
   brew services start newrelic-infra-agent

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

   Intel x86:

   bash

   Copy

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

   Apple Silicon:

   bash

   Copy

   $
   sudo mkdir -p /opt/homebrew/etc/newrelic-infra/
   $
   echo "license_key: YOUR_LICENSE_KEY" | sudo tee -a /opt/homebrew/etc/newrelic-infra/newrelic-infra.yml

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 agent.