= Reconnoiter =

{{{
#!html
<img src="https://labs.omniti.com/labs/reconnoiter/browser/docs/assets/Noit_72dpi_noBkgrnd.png?format=raw" style="float:right;">
}}}

Reconnoiter's goal is to better the world of monitoring by marrying fault detection and trending together.  Through ease of configuration and ongoing maintenance, Reconnoiter encourages monitoring important technical metrics along side critical business metrics to improve awareness and ultimately accountability.

 * [wiki:ReconnoiterName Reconnoiter?  Who names this stuff?  Honestly?]
 * Read about the [wiki:Goals goals of Reconnoiter]. [http://lethargy.org/~jesus/archives/121-Reconnoiter-and-another-platform.html Rant version].

== Architecture ==

 * Web console to provide a view into the world.
 * Core database, holds metrics and business logic for determining faults, fault notification and escalation procedures
 * Strategy daemon to collect information from Scout nodes
 * Scout nodes that perform checks.  Scout nodes run extremely efficiently -- tens of thousands of services monitored per scout.

  [source:/docs/assets/noit-network-arch.png A picture is worth a thousand words].

  [http://omniti.com/video/noit-oscon-demo Watch the 2009 OSCON Reconnoiter presentation].

== Documentation ==

 * [http://labs.omniti.com/labs/reconnoiter/docs Reconnoiter documentation]
 * And some more ad-hoc [wiki:ReconnoiterHowTo wiki documentation]

=== Mini HOWTOs ===

 * [http://blog.taborsky.cz/2011/11/jmx-metrics-in-reconnoiter.html Using Jezebel to collect JMX]
 * [http://blog.taborsky.cz/2011/03/collecting-oracle-metrics-with.html Monitoring Oracle] [http://blog.taborsky.cz/2011/03/drcp-monitoring-with-reconnoiter.html and DRCP]

== Download ==

[source:/ master] access is available to all.
{{{
git clone git://github.com/omniti-labs/reconnoiter.git
}}}

Development at this point is pretty rapid.  As such, decisions are made that might cause what we call a "flag-day".  A flag-day is when an upgrade through a specific version will prevent some functionality between that version and an older version.  Commits that do this (like a change in protocol) will be marked as "flag-day" commits and note the system components that must be lock-step upgraded.  [http://labs.omniti.com/trac/reconnoiter/search?q=flag-day&noquickjump=1&changeset=on Review flag-day commits].

Specific (significant) [wiki:UpgradeNotes upgrade notes].

Installation can be a bit tricky, it might help to look at this [http://www.ducea.com/2010/07/13/howto-install-reconnoiter-on-debian-lenny/ step-by-step guide to installing on Debian].

== Support ==

[wiki:Support Commercial support] is a available from [http://omniti.com OmniTI].

== Participation ==

Reconnoiter (like all projects at OmniTI Labs) is open to participation from individuals (and companies) outside of OmniTI.  Just contact the project maintainer and let them know what you'd like to do.  Reconnoiter's maintainer is Theo Schlossnagle < jesus [at] omniti [dot] com >.  Feel free to join the mailing lists:

 * [http://labs.omniti.com/labs/reconnoiter/lists/users/ Users' List]
 * [http://labs.omniti.com/labs/reconnoiter/lists/devel/ Developers' List]