NAME

Monitis Monitor Manager => MMM => M3

M3 is the shortened name for Monitis Monitor Manager.

This Perl module helps you manage Custom Monitors on Monitis (www.monitis.com).

SYNOPSIS

  use MonitisMonitorManager;

  # dry run dictates whether to upload data to Monitis - yes or no
  my $dry_run = 0;

  # configuration_xml is a file with the configuration XML, refer to some
  # examples here: https://github.com/monitisexchange/Monitis-Linux-Scripts/tree/master/M3v3/monitis-m3/usr/local/share/monitis-m3/sample_config
  my $configuration_xml = "/etc/m3.d/config.xml";

  # test_config dictates whether to just test the configuration or actually
  # do a proper run
  my $test_config = 0;

  # initialize the M3 instance
  my $M3 = MonitisMonitorManager->new(
    configuration_xml => $xmlfile,
    dry_run => $dry_run,
    test_config => $test_config);

  # handle a raw command in the form of:
  # 'add_monitor memory memory free:free:Bytes:2;active:active:Bytes:2'
  # 'update_data memory memory free:305594368;active:879394816'
  $M3->handle_raw_command($raw);

  # runs just one iteration of the agents defined in the XML
  $M3->invoke_agents();

  # invoke the agents in a loop (using the defined interval in the XML)
  $M3->invoke_agents_loop();

DESCRIPTION

For full proper documentation please refer to: https://github.com/monitisexchange/Monitis-Linux-Scripts/blob/master/M3v3/README.md

M3 Perl module comes with an init.d service. If you're using a RPM or DEB package then you're good to do, however the CPAN installation will not take care of this... Find it here: https://github.com/monitisexchange/Monitis-Linux-Scripts/tree/master/M3v3

EXPORT

MonitisMonitorManager

SEE ALSO

See also Monitis' blog with entries about M3: http://blog.monitis.com/index.php/tag/m3/

Monitis main website: http://www.monitis.com

Github repository: https://github.com/monitisexchange/Monitis-Linux-Scripts/tree/master/M3v3

AUTHOR

Dan Fruehauf, <malkodan@gmail.com>

COPYRIGHT AND LICENSE

Copyright (C) 2012 by Dan Fruehauf

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.14.2 or, at your option, any later version of Perl 5 you may have available.