Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
branch: master
..
Failed to load latest commit information.
Compute
Execution
Parsing
RRD M3/RRD: added an XML generator for munin monitors
jiffy-web M3: added jiffy-web patch and sample configuration
ntop
AddMonitors.pl M3: added AddMonitors.pl back to be backward compatible with articles
DryRun.pl M3: moved API key and secret key to M3Templates.pm
DryRunMassLoad.pl M3: added DryRunMassLoad.pl and RunMassLoad.pl
Example.pl M3: replaced the 'template' support with regex and added concrete exa…
M3Templates.pm Update master
MonitisConnection.pm
MonitisMonitorManager.pm M3: fixed common problem of hash casting (happened too many times)
NagiosToM3Converter.pl Added NagiosToM3Converter.pl
README.md
Run.pl
RunMassLoad.pl M3: added DryRunMassLoad.pl and RunMassLoad.pl
TimerDryRun.pl M3: moved API key and secret key to M3Templates.pm
TimerRun.pl
config_nagios.xml
config_sample.xml
config_sample_json_extraction.xml
config_sample_regex_extraction.xml
config_sample_xpath_extraction.xml M3: moved API key and secret key to M3Templates.pm
cpu_memory_stats.xml Added Http load time monitor template for M3
dbi_sample.xml M3: moved API key and secret key to M3Templates.pm
etc_file_monitor.xml
hotwire_sample.xml
pgsql_statistics.xml M3: changed monitor names in pgsql_statistics.xml
snmp_test.xml M3: added SNMP query support
twitter_followers_sample.xml M3: moved API key and secret key to M3Templates.pm
yahoo_finance_sample.xml

README.md

M3

M3 => MMM => Monitis Monitor Manager

This is a utility that would help you to manage monitors in Monitis.

M3 helper scripts

  • Run.pl - Executes all agents, then sends the monitoring data to Monitis.
  • DryRun.pl - Same as Run.pl, however does not send monitoring data to Monitis. Can be used to debug your parsing.
  • TimerRun.pl - Runs M3 in a loop using timers to schedule invocation of monitors
  • TimerDryRun.pl - Same as TimerRun.pl but does not send monitoring data to Monitis.
  • RunMassLoad.pl - Operates on the output line by line, very useful for mass loading of data obtained from log files.
  • DryRunMassLoad.pl - Same as RunMassLoad.pl but goes with a dry run.\
  • NagiosToM3Converter.pl will convert a nagios configuration to M3 - still work in progress
  • RRD/munin_xml_generator - Creates a M3 configuration from munin data

Any of these scripts can be composed by yourself, it's a simple perl line.

M3 Plugin architecture

M3 has a plugin architecture. 3 types of plugins exist:

  1. Execution
  2. Parsing
  3. Compute And they sit in the Execution, Parsing and Compute directories respectively.

M3 phases

  • Execution plugins - Collecting output
  • Parsing plugins - picking the interesting data
  • Compute plugins - Post processing and transformation of data
  • Loading data to Monitis

Plugin documentation

Very simple example

Inspecting the simplest example of M3 - etc_file_monitor.xml it'll execute the command:

# find /etc -maxdepth 1 -type f | wc -l

In order to collect the output and upload to Monitis you have to form a

regular expression, in this example it is:

<regex>(.*)</regex> Anything enclosed in parenthesis would be collected by the regular expression plugin.

Further reading

Learn more about Montis Monitor Manager Framework here.

Something went wrong with that request. Please try again.