puppet_configure_collectd_plugins

Table of Contents

1. Overview
2. Module Description - What the module does and why it is useful
3. Setup - The basics of getting started with configure_collectd_plugins
   • What configure_collectd_plugins affects
4. Usage - Configuration options and additional functionality

Overview

The configure_collectd_plugins module enables and configures a set of collectd plugins that work well with SignalFx.

This is one of three modules provided by SignalFx for managing collectd. See Module Description.

Module Description

Collectd is a system statistics collection daemon. This module configures collectd plugins to collect useful and interesting metrics about your system.

This is one of three modules provided by SignalFx for managing collectd.

Setup

Install the latest release of configure_collectd_plugins module from SignalFx using:

puppet module install signalfx/configure_collectd_plugins

What configure_collectd_plugins affects

The configure_collectd_plugins module configures an existing instance of collectd to collect useful and interesting system metrics. You must have collectd installed in order to use this module.

SignalFx provides additional modules to install collectd and send metrics to SignalFx. See Module Description.

Usage

The configure_collectd_plugins module accepts parameters that enable or disable each of the plugins that it configures. The default value for all parameters is 'present'. To disable data collection by a plugin, change the value of its named parameter to 'absent'.

class { 'configure_collectd_plugins':
    log_file => present,
    aggregation => present,
    chain => present,
    cpu => present,
    cpufreq => present,
    df => present,
    load => present,
    memory => present,
    uptime => present,
    disk => present,
    interface => present,
    protocols => present,
    vmem => present
}

You can also use this module to install collectd plugins to monitor third-party software. To install a plugin, add its configuration snippet to your manifest file, and replace default configuration values with values that make sense for your environment as necessary.

Apache

class { 'configure_collectd_plugins::plugins::apache':
  instanceName  => 'myapacheinstance',
  url           => 'http://localhost/mod_status?auto'
}

Cassandra

class { 'configure_collectd_plugins::plugins::cassandra':
  hostname => $::hostname
}

Docker

include 'configure_collectd_plugins::plugins::docker'

Elasticsearch

class { 'configure_collectd_plugins::plugins::elasticsearch':
  clustername         => 'elasticsearch',
  indexes             => '_all'
}

Kafka version 0.8.2.1 and up

class { 'configure_collectd_plugins::plugins::kafka_82':
  hostname => $::hostname
}

Memcached

class { 'configure_collectd_plugins::plugins::memcached':
  hostname => '127.0.0.1',
  port     => '11211'
}

MySQL

class { 'configure_collectd_plugins::plugins::mysql':
  hostname,
  user,
  password,
  database
}

Nginx

class { 'configure_collectd_plugins::plugins::nginx':
  url => 'http://localhost:80/nginx_status'
}

PostgreSQL

class { 'configure_collectd_plugins::plugins::postgresql':
  hostname,
  user,
  password
}

Redis Master

class { 'configure_collectd_plugins::plugins::redis_master':
  hostname,
  port
}

Use this configuration for Redis masters.

Redis Slave

class { 'configure_collectd_plugins::plugins::redis_slave':
  hostname,
  port
}

Use this configuration for Redis slaves.

Varnish

class { 'configure_collectd_plugins::plugins::varnish':
  hostname,
  port
}

Zookeeper

include 'configure_collectd_plugins::plugins::zookeeper'