Read on to learn how to use New Relic's Chef recipes to install and configure New Relic's infrastructure agent. For instructions on how to use Chef recipes, see the Chef documentation.
The New Relic cookbook is available from the public Chef Supermarket. This is a community-supported effort.
Compatibility and requirements
The Infrastructure Chef recipe has the following requirements:
- Chef versions 12 or higher
- Supports all operating systems compatible with the infrastructure agent
Chef recipes
Infrastructure monitoring has one default recipe: default
. Include this recipe to install and configure the infrastructure agent. If this recipe detects an unsupported platform or version, the Chef run fails. Configuration depends on your specific setup and standards.
Chef attributes
The default
recipe supplies the following Chef attributes:
default['newrelic_infra']['config']['license_key']
(REQUIRED)-
Type String Default (none) Defines your New Relic license key.
default['newrelic_infra']['packages']['agent']['action']
-
Type String Default install
Valid values install
,upgrade
, orremove
Select what type of package resource actions action you want to perform:
-
install
: Installs the infrastructure agent. If[agent_version]
is specified, that version will be installed. The first time the cookbook runs on each host, it will install the latest infrastructure agent. However, the agent will not be upgraded withinstall
on subsequent Chef runs. Useupgrade
to install newer versions. -
upgrade
: Upgrades hosts to the latest infrastructure agent version. -
remove
: Uninstalls the infrastructure agent.
-
default['newrelic_infra']['packages']['agent']['retries']
-
Type Integer Default 0 The number of times to catch exceptions and retry the resource.
default['newrelic_infra']['packages']['agent']['version']
-
Type String Default (none) Use with
'install'
to set a specific agent version. If no value is set, the recipe defaults to the latest agent version.
Use the basic recipe
The New Relic cookbook is available from the public Chef Supermarket. To install and configure New Relic's infrastructure agent using Chef:
- Add the
newrelic-infra
dependency in your own Chefmetadata.rb
orBerksfile
. -
Set the New Relic license key attribute. For example, add the following to your
recipes/default.rb
:default['newrelic_infra']['config']['license_key'] = 'YOUR_LICENSE_KEY'
- Optional: To control version usage and updating, customize the recipe with Chef attributes.
- Include the default New Relic recipe by using
include_recipe ‘newrelic-infra::default'
or by adding the recipe to your run list.
For more help
If you need additional help, file an issue at newrelic/infrastructure-agent-chef on GitHub.