newrelic-infra

Table of Contents

1. Description
2. Setup - The basics of getting started with newrelic-infra
   • What newrelic-infra affects
   • Beginning with newrelic-infra
3. Usage - Configuration options and additional functionality
4. Reference - An under-the-hood peek at what the module is doing and how
5. Limitations - OS compatibility, etc.

Description

This module installs and configures the New Relic Infrastructure agent.

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

Declare the main ::agent class.

Usage

All interactions with newrelic-infra will be done through the main agent class.

Installing the Infrastructure agent

class { 'newrelic_infra::agent':
    ensure      => 'latest',
    license_key => 'YOUR_LICENSE_KEY',
}

Reference

Classes

Public Classes

• newrelic_infra::agent: Installs and configures the Infrastructure agent.

newrelic_infra::agent

Parameters

ensure

Specifies the Infrastructure agent ensure status.

Valid values include:

• 'latest' - (default) Installs the latest agent version
• 'absent' - Uninstalls the agent
• string - String containing a specific version to pin

license_key

Specifies the New Relic license key to use.

display_name

Optional. Override the auto-generated hostname for reporting.

verbose

Optional. Enables verbose logging for the agent when set the value with 1, the default value is 0.

log_file

Optional. To log to another location, provide a full path and file name. When not set, the agent logs to the system log files. Typical default locations:

• Amazon Linux, CentOS, RHEL: /var/log/messages
• Debian, Ubuntu: /var/log/syslog
• Windows Server: C:\Program Files\New Relic\newrelic-infra\newrelic-infra.log

proxy

Optional. Set the proxy server the agent should use. Examples:

• https://myproxy.foo.com:8080
• http://10.10.254.254

custom_attributes

Optional. A hash of custom attributes to annotate the data from this agent instance.

package_repo_ensure

Optional. A flag for omitting the New Relic package repo. Meant for environments where the newrelic-infra package has been mirrored to another repo that's already present on the system (set to absent to achieve this)

Limitations

Platforms

• RHEL
  • CentOS 7
  • CentOS 6
• Ubuntu
  • 16 Xenial
  • 14 Trusty
  • 12 Precise
• Debian
  • 8 Jessie
  • 7 Wheezy

Copyright (c) 2016 New Relic, Inc. All rights reserved.