You can use New Relic's Ansible role to install and configure our infrastructure monitoring agent. For instructions on how to use Ansible, see the Ansible documentation. This is a community-supported effort.
Want to configure the infrastructure agent using Ansible? Create a New Relic account for free! No credit card required.
Sample code
New Relic provides configuration management sample code to help you install our infrastructure monitoring agent using workflows and tools that are common with many Ops teams. This is a basic Ansible role and is intended to be used as a starting place for creating your own customized workflow.
Configuration depends on your specific setup and standards. To view an Ansible sample role and more integration information, see the Ansible Galaxy documentation.
Compatibility and requirements
The Ansible role with New Relic's infrastructure monitoring agent requires a supported Linux operating system.
Set up New Relic with Ansible
The newrelic.newrelic-infra
role:
- Adds the New Relic infrastructure agent package repository source.
- Installs and configures the infrastructure agent.
To get started using this role:
- Include the role in your playbook.
- Customize the required variables.
All typical interactions with newrelic.newrelic-infra
use role configuration. Here is an example of configuring your role to install the infrastructure agent:
---- hosts: webservers roles: - role: newrelic.newrelic-infra vars: nrinfragent_config: license_key: YOUR_LICENSE_KEY
Role configuration variables
Here are available variables for configuring the newrelic.newrelic-infra
role:
Variable | Description |
---|---|
| Required. A map of key-value pairs. It corresponds directly with the available general configuration settings. |
| Describes what you want to do with the agent:
|
| Specifies the target OS that the infrastructure agent will be installed on. See the |
| Specifies the OS version of the installer package needed for this machine. See the |