nad cookbook

Install and configure nad, a nodejs-based monitoring agent.

More info on nad: https://github.com/circonus-labs/nad

Platforms

centos, ubuntu

Other un*xes likely; windows unlikely.

Recipes

nad (nad::default)

Runs the install and configure recipes.

nad::install

Installs nad by downloading tarballs from updates.circonus.com .

nad::configure

nad doesn't have much configuration; this just sets the port, SSL options, and scripts directory.

LWRPs

nad_script

Actions

:enable - Link a script into the config directory, enabling it (default)
:disable - Delete a link

Attributes

name - Name of the script (if.sh, cpu.elf, etc)
subdir - Subdirectory within nad config directory where the actual script lives; required for :enable

Examples

# Enable postgres replication script
nad_script pg_replication.sh do
subdir 'postgres'
end

# Disable vm script
nad_script vm.sh do
action :disable
end

Attributes

Defaults are shown below.

:nad => {

    #------
    #  Cookbook Toggle
    #------
    # Set to false to disable the cookbook 
    # (will not disable nad if running)        
    :enabled => true, 

    #------
    #  Installation
    #------
    # Where to store the tarball during installation
    :tmp_path => '/tmp',

    # URL without filename
    :download_url => 'http://updates.circonus.com/node-agent',

    # File to download.  nad::install will find an appropriate file if possible.
    :download_file => "nad-omnibus-20130712T154029Z-rhel5-x86_64.tar.gz",

    # You can also just override the release.  nad::install will find an appropriate release if possible.
    :release => "20130712T154029Z"

    #-----
    # Daemon Config
    #-----
    :port => 2609,
    :config_dir => '/opt/circonus/etc/node_agent.d',

    # These are nil by default
    # Listen on a specific interface
    :ip => nil, 
    # Use SSL (must place na.crt and na.key in conf dir).  If ssl_port is provided, :ip and :port are not used.
    :ssl_port => nil, 
    :ssl_ip => nil,
}

See Also

https://github.com/modcloth-cookbooks/nad