nrinfragent Ansible role
Description
This role installs and configures the New Relic Infrastructure agent.
Note that this is a simple role and is intended for you to use as a starting place for your own customized workflow.
Setup
What nrinfragent affects
- Adds the New Relic Infrastructure package repository source
- Installs and configures the New Relic Infrastructure agent
Beginning with nrinfragent
Include the role in your playbook. Customize the required variables.
Usage
All typical interactions with nrinfragent
will be done through role configuration.
Installing the Infrastructure agent
---
hosts: ap_ne_1
roles:
- name: nrinfragent
vars:
nrinfragent_config:
license_key: YOUR_LICENSE_KEY
log_file: /var/log/newrelic/nr-infra.log
log_to_stdout: false
Reference
Role Configuration
Variables
nrinfragent_state
(OPTIONAL)
Describes what you want to do with the agent:
'latest'
- [default] install the latest version of the agent. Alsopresent
.'absent'
- Uninstall the agent.
nrinfragent_version
(OPTIONAL)
What version of the agent do you want to install:
'*'
- [default] install the latest version of the agent.'X.Y.ZZZ'
- string of the specific version number you want to install, e.g. 1.0.280
nrinfragent_os_name
(OPTIONAL)
Specifies the target OS that the Infrastructure agent will be installed on.
Defaults to ansible_os_family
. See list in the meta/main.yml
file for latest list that is supported.
nrinfragent_os_version
(OPTIONAL)
Specifies the OS version of the installer package needed for this machine.
Defaults to ansible_lsb.major_release
. Mostly used for RedHat
family OSs. See list in the meta/main.yml
file for latest list.
nrinfragent_os_codename
(OPTIONAL)
Specifies the OS codename of the installer package needed for this machine.
Defaults to ansible_lsb.codename
. Mostly used for Debian
family OSs. See list in the meta/main.yml
file for latest list.
nrinfragent_config
(REQUIRED)
Used to populate agent configuration. At a minimum you must provide license_key
.
See the NewRelic documentation for current configuration options:
https://docs.newrelic.com/docs/infrastructure/new-relic-infrastructure/configuration/configure-infrastructure-agent)
Limitations
Platforms
- RHEL
- CentOS 7
- CentOS 6
- Ubuntu
- 16 Xenial
- 14 Trusty
- 12 Precise
- Debian
- 10 Buster
- 9 Stretch
- 8 Jessie
- 7 Wheezy
Copyright (c) 2017 New Relic, Inc. All rights reserved.