newrelic-infra Cookbook

This cookbook installs and configures the New Relic Infrastructure agent.

Requirements

Platforms

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

Chef

• Chef 12+

Cookbooks

• none

Recipes

default

Include the default recipe to install and configure the New Relic Infrastructure agent.

agent

The agent recipe will validate required attributes and do basic platform detection to decide which platform specific recipe to include.

agent_linux

The agent_linux recipe:

1. Adds the newrelic-infra package repository source
2. Installs|upgrades|removes newrelic-infra package
3. Sets up the newrelic-infra agent service
4. Sets the newrelic-infra.yml config file

agent_windows

(Available in the future)

Attributes

See attributes/defaults.rb for default values.

• node['newrelic-infra']['license_key'] - Your New Relic license key.
• node['newrelic-infra']['agent_action'] - newrelic-infra package actions. Values:
  • 'install': (Default) Installs package. If 'agent_version' is specified, installs specific version.
  • 'upgrade': Installs package and/or ensures it's the latest version.
  • 'remove': Removes the package.
• node['newrelic-infra']['agent_version'] - Specify newrelic-infra package version to pin.

Usage

1. Add the newrelic-infra cookbook dependency to your metadata.rb or Berksfile
2. Set node['newrelic-infra']['license_key'] attribute with your New Relic license key
3. Include default recipe or add it to your run list

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