blob: 09684dc87497e046e81f9a8b82ad7f0a71b12103 [file] [log] [blame]
<!DOCTYPE html>
<!--
| Generated by Apache Maven Doxia at 2018-01-03
| Rendered using Apache Maven Fluido Skin 1.3.0
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="Date-Revision-yyyymmdd" content="20180103" />
<meta http-equiv="Content-Language" content="en" />
<title>Metron &#x2013; Monit Integration</title>
<link rel="stylesheet" href="../../../css/apache-maven-fluido-1.3.0.min.css" />
<link rel="stylesheet" href="../../../css/site.css" />
<link rel="stylesheet" href="../../../css/print.css" media="print" />
<script type="text/javascript" src="../../../js/apache-maven-fluido-1.3.0.min.js"></script>
<script type="text/javascript">$( document ).ready( function() { $( '.carousel' ).carousel( { interval: 3500 } ) } );</script>
</head>
<body class="topBarDisabled">
<div class="container-fluid">
<div id="banner">
<div class="pull-left">
<a href="http://metron.apache.org/" id="bannerLeft">
<img src="../../../images/metron-logo.png" alt="Apache Metron" width="148px" height="48px"/>
</a>
</div>
<div class="pull-right"> </div>
<div class="clear"><hr/></div>
</div>
<div id="breadcrumbs">
<ul class="breadcrumb">
<li class="">
<a href="http://www.apache.org" class="externalLink" title="Apache">
Apache</a>
</li>
<li class="divider ">/</li>
<li class="">
<a href="http://metron.apache.org/" class="externalLink" title="Metron">
Metron</a>
</li>
<li class="divider ">/</li>
<li class="">
<a href="../../../index.html" title="Documentation">
Documentation</a>
</li>
<li class="divider ">/</li>
<li class="">Monit Integration</li>
<li id="publishDate" class="pull-right">Last Published: 2018-01-03</li> <li class="divider pull-right">|</li>
<li id="projectVersion" class="pull-right">Version: 0.4.2</li>
</ul>
</div>
<div class="row-fluid">
<div id="leftColumn" class="span3">
<div class="well sidebar-nav">
<ul class="nav nav-list">
<li class="nav-header">User Documentation</li>
<li>
<a href="../../../index.html" title="Metron">
<i class="icon-chevron-down"></i>
Metron</a>
<ul class="nav nav-list">
<li>
<a href="../../../Upgrading.html" title="Upgrading">
<i class="none"></i>
Upgrading</a>
</li>
<li>
<a href="../../../metron-analytics/index.html" title="Analytics">
<i class="icon-chevron-right"></i>
Analytics</a>
</li>
<li>
<a href="../../../metron-contrib/metron-docker/index.html" title="Docker">
<i class="none"></i>
Docker</a>
</li>
<li>
<a href="../../../metron-deployment/index.html" title="Deployment">
<i class="icon-chevron-down"></i>
Deployment</a>
<ul class="nav nav-list">
<li>
<a href="../../../metron-deployment/Kerberos-ambari-setup.html" title="Kerberos-ambari-setup">
<i class="none"></i>
Kerberos-ambari-setup</a>
</li>
<li>
<a href="../../../metron-deployment/Kerberos-manual-setup.html" title="Kerberos-manual-setup">
<i class="none"></i>
Kerberos-manual-setup</a>
</li>
<li>
<a href="../../../metron-deployment/amazon-ec2/index.html" title="Amazon-ec2">
<i class="none"></i>
Amazon-ec2</a>
</li>
<li>
<a href="../../../metron-deployment/other-examples/index.html" title="Other-examples">
<i class="icon-chevron-right"></i>
Other-examples</a>
</li>
<li>
<a href="../../../metron-deployment/packaging/ambari/index.html" title="Ambari">
<i class="none"></i>
Ambari</a>
</li>
<li>
<a href="../../../metron-deployment/packaging/docker/ansible-docker/index.html" title="Ansible-docker">
<i class="none"></i>
Ansible-docker</a>
</li>
<li>
<a href="../../../metron-deployment/packaging/docker/rpm-docker/index.html" title="Rpm-docker">
<i class="none"></i>
Rpm-docker</a>
</li>
<li>
<a href="../../../metron-deployment/packaging/packer-build/index.html" title="Packer-build">
<i class="none"></i>
Packer-build</a>
</li>
<li>
<a href="../../../metron-deployment/roles/index.html" title="Roles">
<i class="icon-chevron-down"></i>
Roles</a>
<ul class="nav nav-list">
<li class="active">
<a href="#"><i class="none"></i>Monit</a>
</li>
<li>
<a href="../../../metron-deployment/roles/opentaxii/index.html" title="Opentaxii">
<i class="none"></i>
Opentaxii</a>
</li>
<li>
<a href="../../../metron-deployment/roles/pcap_replay/index.html" title="Pcap_replay">
<i class="none"></i>
Pcap_replay</a>
</li>
<li>
<a href="../../../metron-deployment/roles/sensor-stubs/index.html" title="Sensor-stubs">
<i class="none"></i>
Sensor-stubs</a>
</li>
<li>
<a href="../../../metron-deployment/roles/sensor-test-mode/index.html" title="Sensor-test-mode">
<i class="none"></i>
Sensor-test-mode</a>
</li>
</ul>
</li>
<li>
<a href="../../../metron-deployment/vagrant/index.html" title="Vagrant">
<i class="icon-chevron-right"></i>
Vagrant</a>
</li>
</ul>
</li>
<li>
<a href="../../../metron-interface/metron-alerts/index.html" title="Alerts">
<i class="none"></i>
Alerts</a>
</li>
<li>
<a href="../../../metron-interface/metron-config/index.html" title="Config">
<i class="none"></i>
Config</a>
</li>
<li>
<a href="../../../metron-interface/metron-rest/index.html" title="Rest">
<i class="none"></i>
Rest</a>
</li>
<li>
<a href="../../../metron-platform/index.html" title="Platform">
<i class="icon-chevron-right"></i>
Platform</a>
</li>
<li>
<a href="../../../metron-sensors/index.html" title="Sensors">
<i class="icon-chevron-right"></i>
Sensors</a>
</li>
<li>
<a href="../../../metron-stellar/stellar-3rd-party-example/index.html" title="Stellar-3rd-party-example">
<i class="none"></i>
Stellar-3rd-party-example</a>
</li>
<li>
<a href="../../../metron-stellar/stellar-common/index.html" title="Stellar-common">
<i class="icon-chevron-right"></i>
Stellar-common</a>
</li>
<li>
<a href="../../../use-cases/index.html" title="Use-cases">
<i class="icon-chevron-right"></i>
Use-cases</a>
</li>
</ul>
</li>
</ul>
<hr class="divider" />
<div id="poweredBy">
<div class="clear"></div>
<div class="clear"></div>
<div class="clear"></div>
<a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
<img class="builtBy" alt="Built by Maven" src="../../../images/logos/maven-feather.png" />
</a>
</div>
</div>
</div>
<div id="bodyColumn" class="span9" >
<h1>Monit Integration</h1>
<p><a name="Monit_Integration"></a></p>
<p>This role will leverage Monit as a process watchdog to manage sensors, topologies, and core services. </p>
<ul>
<li>Monit can be used to start, stop, or check status of any of the sensors or topologies.</li>
<li>When monitoring is enabled (on by default) if a process dies, it will be restarted.</li>
<li>The Monit web interface is exposed at <a class="externalLink" href="http://hostname:2812">http://hostname:2812</a>.</li>
<li>The web interface username and password is defined by the <tt>monit_user</tt> and <tt>monit_password</tt> variables. These default to <tt>admin</tt>/<tt>monit</tt>.</li>
<li>Monit CLI tools can also be used to simplify the process of managing Metron components.</li>
<li>
<p>The post-deployment report for Amazon-EC2 provides links to Monit&#x2019;s web interface labeled as &#x2018;Sensor Status&#x2019; and &#x2018;Topology Status.&#x2019;</p>
<div class="source">
<div class="source">
<pre> ok: [localhost] =&gt; {
&quot;Success&quot;: [
&quot;Apache Metron deployed successfully&quot;,
&quot; Metron @ http://ec2-52-39-143-62.us-west-2.compute.amazonaws.com:5000&quot;,
&quot; Ambari @ http://ec2-52-39-4-93.us-west-2.compute.amazonaws.com:8080&quot;,
&quot; Sensor Status @ http://ec2-52-39-4-93.us-west-2.compute.amazonaws.com:2812&quot;,
&quot; Topology Status @ http://ec2-52-39-130-62.us-west-2.compute.amazonaws.com:2812&quot;,
&quot;For additional information, see https://metron.apache.org/'&quot;
]
}
</pre></div></div></li>
</ul>
<div class="section">
<h2><a name="Usage"></a>Usage</h2>
<p>Start all Metron components</p>
<div class="source">
<div class="source">
<pre>monit start all
</pre></div></div>
<p>Stop all Metron components</p>
<div class="source">
<div class="source">
<pre>monit stop all
</pre></div></div>
<p>Start an individual Metron component</p>
<div class="source">
<div class="source">
<pre>monit start bro-parser
</pre></div></div>
<p>Start all components required to ingest Bro data</p>
<div class="source">
<div class="source">
<pre>monit -g bro start
</pre></div></div>
<p>Start all parsers</p>
<div class="source">
<div class="source">
<pre>monit -g parsers start
</pre></div></div>
<p>What is running?</p>
<div class="source">
<div class="source">
<pre>monit summary
</pre></div></div></div>
</div>
</div>
</div>
<hr/>
<footer>
<div class="container-fluid">
<div class="row span12">Copyright &copy; 2018
<a href="https://www.apache.org">The Apache Software Foundation</a>.
All Rights Reserved.
</div>
</div>
</footer>
</body>
</html>