Forge Home

monitoring

Autodetect and install monitoring and metrics for supported services

108,171 downloads

7,029 latest version

4.6 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 1.0.6 (latest)
  • 1.0.5
  • 1.0.4
  • 1.0.3
  • 1.0.2
  • 1.0.1
  • 1.0.0
  • 0.3.6
  • 0.3.5
  • 0.3.4
  • 0.3.3
  • 0.3.2
  • 0.3.1
  • 0.3.0
released Dec 7th 2016
This version is compatible with:
  • , , , , ,

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'yuav-monitoring', '0.3.6'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add yuav-monitoring
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install yuav-monitoring --version 0.3.6

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

yuav/monitoring — version 0.3.6 Dec 7th 2016

Puppet Monitoring

Build Status

Module to install monitoring for any detected service supported by the module

Module Description

Deployment of monitoring tools which detect already installed services. This is useful to avoid adding monitoring code into the modules themselves, and provides a completely decoupled monitoring module. By using custom facts, which are updated during runtime, the module will magically install monitoring of everything installed on a machine without any hard dependencies between the module that install the service and the monitoring module.

Usage

Install the module using:

puppet module install yuav-monitoring

simply include the module

class { 'monitoring':
  collectd_network_server_hostname => 'influxdb',
}

This will install the default metrics collector CollectD, and configure it to send metrics to hostname 'influxdb'.

Using defaults, the module will enable the following collectd plugins:

Always:

  • cpu
  • disk
  • df
  • fhcount
  • interface
  • load
  • memory
  • uptime

If present:

  • apache (if statuspage is enabled)
  • ntpd
  • rabbitmq (if management interface enabled)
  • redis

Custom Facts

This module relies on a set of custom facts to detect any services installed. These facts are refreshed at the end of any ordinary Puppet run using the yuav-refacter module. This ensures that if another module installs any of these services, the fact values will be updated to reflect this new state before installing monitoring plugins

Apache facts

Checks if Apache is installed on the system

$::apache_present

Checks if apache status page with metrics is available from localhost

$::apache_statuspage_present

NTPD facts

Checks if ntpd is installed on the system

$::ntpd_present

RabbitMQ facts

Checks if RabbitMQ is installed on the system

$::rabbitmq_present

Retrieves RabbitMQ management port if enabled

$::rabbitmq_management_port

Redis facts

Checks if Redis is installed on the system

$::redis_present