NAME

Monitoring::Generator::TestConfig - generate monitoring configurations (nagios/icinga/shinken)

SYNOPSIS

use Monitoring::Generator::TestConfig;
my $ngt = Monitoring::Generator::TestConfig->new( 'output_dir' => '/tmp/test_monitoring' );
$ngt->create();

DESCRIPTION

This modul generates test configurations for your monitoring. This can be useful if you want for doing load tests or testing addons and plugins.

CONSTRUCTOR

new ( [ARGS] )

Creates an Monitoring::Generator::TestConfig object. new takes at least the output_dir. Arguments are in key-value pairs.

verbose                     verbose mode
output_dir                  export directory
overwrite_dir               overwrite contents of an existing directory. Default: false
layout                      which config should be generated, valid options are "nagios", "icinga", "shinken" and "omd"
user                        user, defaults to the current user
group                       group, defaults to the current users group
prefix                      prefix to all hosts / services / contacts / contactgroups
binary                      path to your nagios/icinga bin
hostcount                   amount of hosts to export, Default 10
hostcheckcmd                use custom hostcheck command line
servicecheckcmd             use custom servicecheck command line
routercount                 amount of router to export, Default 5 ( exported as host and used as parent )
services_per_host           amount of services per host, Default 10
host_settings               key/value settings for use in the define host
service_settings            key/value settings for use in the define service
main_cfg                    overwrite/add settings from the nagios.cfg/icinga.cfg
hostfailrate                chance of a host to fail, Default 2%
servicefailrate             chance of a service to fail, Default 5%
host_types                  key/value settings for percentage of hosttypes, possible keys are up,down,flap,random,block
router_types                key/value settings for percentage of hosttypes for router
service_types               key/value settings for percentage of servicetypes, possible keys are ok,warning,critical,unknown,flap,random,block
skip_dependencies           no service dependencies will be exported
contacts_count              amount of contacts to export, Default 1
contactgroups_count         amount of contactgroups to export, Default 1
contacts_per_group          amount of contacts to export, Default 1
contacts_per_host           amount of contacts per host, Default 0
contactgroups_per_host      amount of contactgroups per host, Default 1
contacts_per_service        amount of contacts per service, Default 0
contactgroups_per_service   amount of contactgroups per service, Default 1
skip_hostgroups             no hostgroups will be exported
skip_servicegroups          no servicegroups will be exported

METHODS

create

create()

generates and writes the configuration
Returns true on success or undef on errors.

EXAMPLE

OMD Users

Using OMD makes generating test configs really easy:

#> create site test
#> su - test
OMD[test]:~$ cpan
...
Would you like me to configure as much as possible automatically? [yes] <enter>
...
cpan[1]> install Monitoring::Generator::TestConfig
...
cpan[2]> exit
OMD[test]:~$ ./local/lib/perl5/bin/create_monitoring_test_config.pl

After the first installation, configuration can be adjusted in the recreate.pl in your SITE directory.

Sample Script

Create a sample config with manually overriden host/service settings:

use Monitoring::Generator::TestConfig;
my $mgt = Monitoring::Generator::TestConfig->new(
                    'output_dir'                => '/tmp/test-conf',
                    'verbose'                   => 1,
                    'overwrite_dir'             => 1,
                    'user'                      => 'testuser',
                    'group'                     => 'users',
                    'hostcount'                 => 50,
                    'services_per_host'         => 20,
                    'main_cfg'                  => {
                            'debug_level'     => 1,
                            'debug_verbosity' => 1,
                        },
                    'hostfailrate'              => 2, # percentage (only for the random ones)
                    'servicefailrate'           => 5, # percentage (only for the random ones)
                    'host_settings'             => {
                            'normal_check_interval' => 10,
                            'retry_check_interval'  => 1,
                        },
                    'service_settings'          => {
                            'normal_check_interval' => 10,
                            'retry_check_interval'  => 2,
                        },
                    'host_types'                => {
                                    'down'         => 5, # percentage
                                    'up'           => 50,
                                    'flap'         => 5,
                                    'pending'      => 5,
                                    'random'       => 30,
                                    'block'        => 5,
                        },
                    'service_types'             => {
                                    'ok'           => 50, # percentage
                                    'warning'      => 5,
                                    'unknown'      => 5,
                                    'critical'     => 5,
                                    'pending'      => 5,
                                    'flap'         => 5,
                                    'random'       => 20,
                                    'block'        => 5,
                        },
);
$mgt->create();

AUTHOR

Sven Nierlein, <nierlein@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2009 by Sven Nierlein

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.