This document provides basic information for how to use New Relic's Ansible role to install and configure New Relic Infrastructure. For instructions on how to use Ansible, see the Ansible documentation. This is a community-supported effort.
New Relic provides source-available, configuration management sample code to help you install the New Relic Infrastructure agent using workflows and tools that are common with many Ops teams. To view an Ansible sample role and more integration information, see the Ansible Galaxy.
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.
Compatibility and requirements
The Ansible role with New Relic Infrastructure requires a supported Linux operating system.
- Adds the New Relic Infrastructure package repository source.
- Installs and configures the New Relic Infrastructure agent.
To get started using this role:
- Include the role in your playbook.
- Customize the required variables.
Use and install
All typical interactions with
newrelic.newrelic-infra use role configuration. Here is an example of configuring your role to install the Infrastructure agent:
- hosts: ap_northeast_1 roles: - name:
newrelic.newrelic-infravars: nrinfragent_os_name: YOUR_OS_NAME nrinfragent_os_version: YOUR_OS_VERSION nrinfragent_config: license_key: YOUR_LICENSE_KEY log_file: /var/log/newrelic/nr-infra.log log_to_stdout: false
Role configuration variables
Here are available variables for configuring the
||Required. A map of key-value pairs. Corresponds directly with the available general configuration settings.|
Describes what you want to do with the agent:
The version of the agent you want to install:
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
For more help
If you need additional help, file an issue at newrelic/infrastructure-agent-ansible on GitHub.