lchi / alphard-chef-newrelic

Chef cookbook for installing New Relic Infrastructure agent

Cookbook 'alphard-chef-newrelic'

This cookbook installs and configures New Relic agents.

Requirements

Platforms

• RHEL
  • CentOS 7
  • CentOS 6
  • Amazon Linux (all versions)
• 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.

default

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

linux

The 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

Attributes

See attributes/default.rb for default values.

• node['alphard']['newrelic']['license'] - Your New Relic license key.

Infra

• node['alphard']['newrelic']['infra']['license'] - Your New Relic license key.
• node['alphard']['newrelic']['infra']['action'] - newrelic-infra package actions. Values:
  • 'install': (Default) Installs package. If 'version' is specified, installs specific version.
  • 'upgrade': Installs package and/or ensures it's the latest version.
  • 'remove': Removes the package.
• node['alphard']['newrelic']['infra']['version'] - Specify newrelic-infra package version to pin.
• node['alphard']['newrelic']['infra']['configuration'] - A hash to add all newrelic.yml configuration file settings
• node['alphard']['newrelic']['infra']['configuration']['verbose'] - Log verbosity setting. Type: String
• node['alphard']['newrelic']['infra']['configuration']['proxy'] - Your proxy url if required.
• node['alphard']['newrelic']['infra']['configuration']['log_file'] - Your log file path
• node['alphard']['newrelic']['infra']['configuration']['display_name'] - Your infrastructure display name

Java

• TODO

Usage

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

Contributing

1. Fork the repository on Github
2. Create a named feature branch (like add_component_x)
3. Write your change
4. Write tests for your change (if applicable)
5. Run the tests, ensuring they all pass
6. Submit a Pull Request using Github

License

Copyright 2009-2016, Hydra Technologies, Inc

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Authors

• Frédéric Nowak - [e-mail]