newrelic-infra 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 newrelic-infra affects

• Adds the New Relic Infrastructure package repository source
• Installs and configures the New Relic Infrastructure agent

Beginning with newrelic-infra

Include the role in your playbook. Customize the required variables.

Usage

All typical interactions with newrelic-infra will be done through role configuration.

Installing the Infrastructure agent

---
- hosts: ap_ne_1
  roles:
    - name: newrelic.newrelic-infra
      vars:
        nrinfragent_config:
          license_key: YOUR_LICENSE_KEY
          log_file: /var/log/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. Also present.
• '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

nrinfragent_license_key

DEPRECATED

Specify the license key. For backward compatibility. Use license_key in nrinfragent_config instead. If both are specified the one in nrinfragent_config will be used.

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.