Skip to content

Puppet module to install and configure smokeping. Including target and slave definition

License

Notifications You must be signed in to change notification settings

PolyLAN/puppet-smokeping

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SmokePing Puppet module

Puppet module to completely manage a SmokePing installation. Includes managing of Master/Slave installation and the menu hierarchy.

Some background information can be found here: Puppet module to manage SmokePing

Features

  • Master/Slave/Standalone SmokePing configuration possible
  • Menu hierarchy implemented
  • Define Probes and Alert patterns
  • Config files managed with templates
  • Uses exported resources to configure Slaves on the Master (tag: smokeping-slave)
  • Automatically generates a shared secret for Master/Slave configuration (tag: smokeping-slave-secret)

Tested on Ubuntu 12.04 LTS

Dependencies

Example

Standalone SmokePing instance

# install a standalone instance on a server with default values (see init.pp for 
# parameter documentation
class { '::smokeping':
    mode => 'standalone',
}

Master SmokePing instance

# install a master instance on a server with default values (see init.pp for 
# parameter documentation. You must have a slave, or this will not work!
class { '::smokeping':
    mode => 'master',
}

Slave SmokePing instance

class { '::smokeping':
    mode           => 'slave',
    slave_name     => $::hostname,
    master_url     => 'http://myserver.tld/smokeping/smokeping.cgi',
    slave_location => 'zurich',
}

This configures the server as slaves and adds the slave definition automatically to the master using exported resources.

Probes

$probes = [
    { name => 'FPing', binary => '/usr/bin/fping' },
    { name => 'FPing6', binary => '/usr/bin/fping6' },
]
Class['::smokeping'] {
  probes => $probes
}

Alerts

$alerts = [ {
  { name    => 'bigloss',
  type    => 'loss',
  pattern => '==0%,==0%,==0%,==0%,>0%,>0%,>0%',
  comment => 'suddenly there is packet loss' },

  { name    => 'startloss',
  type    => 'loss',
  pattern => '==S,>0%,>0%,>0%',
  comment => 'loss at startup' },

  { name    => 'noloss',
  type    => 'loss',
  pattern => '>0%,>0%,>0%,==0%,==0%,==0%,==0%',
  comment => 'there was loss and now its reachable again' },
] }
Class['::smokeping'] {
  alerts => $alerts
}

Targets

# Top Level
smokeping::target { 'World':
    menu      => 'World',
    pagetitle => 'Connection to the World',
    alerts    => [ 'bigloss', 'noloss' ]
}

smokeping::target { 'GoogleCH':
    hierarchy_parent => 'World',
    hierarchy_level  => 2,
    menu             => 'google.ch',
    pagetitle        => 'Google',
}
smokeping::target { 'GoogleCHIPv4':
    hierarchy_parent => 'GoogleCH',
    hierarchy_level  => 3,
    menu             => 'google.ch IPv4',
    host             => 'google.ch',
    slaves           => ['slave1'],
}
smokeping::target { 'GoogleCHIPv6':
    hierarchy_parent => 'GoogleCH',
    hierarchy_level  => 3,
    menu             => 'google.ch IPv6',
    host             => 'google.ch',
    probe            => 'FPing6'
    slaves           => ['slave1'],
}

License / Author

The module is written by

Licensed under Apache License, Version 2.0, Copyright 2013 by Tobias Brunner

Contibutors

The following nice peoples have contributed to this puppet module:

  • Andreas Jaggi: @x-way
  • André Timmermann: @darktim

About

Puppet module to install and configure smokeping. Including target and slave definition

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published