Skip to content

Latest commit

 

History

History
87 lines (57 loc) · 4.31 KB

install-infrastructure-monitoring-agent-macos.mdx

File metadata and controls

87 lines (57 loc) · 4.31 KB
title tags metaDescription freshnessValidatedDate
Install the infrastructure agent for macOS
Infrastructure
Install the infrastructure agent
macOS installation
Install New Relic infrastructure agent for macOS using Homebrew.
never

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 [#install-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 [#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 [#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:

      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)"
  3. Then, open the terminal and run the following command::

      brew install newrelic-infra-agent -q
  4. Start the infrastructure agent service:

      brew services start newrelic-infra-agent
  5. Create the configuration file and add your :

    Intel x86:

      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:

      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? [#configure]

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

Update the agent [#update]

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