Mon-soon engine

The root of the mon-soon project.

License	BSD
GroupId	com.github.groupon.monsoon
ArtifactId	monsoon-engine
Last Version	2.3.1
Release Date	Dec 19, 2017
Type	jar
Description	Mon-soon engine The root of the mon-soon project.
Project URL	https://github.com/groupon/monsoon
Source Code Management	https://github.com/groupon/monsoon

Download monsoon-engine

Filename	Size
monsoon-engine-2.3.1.pom
monsoon-engine-2.3.1.jar	1021 KB
monsoon-engine-2.3.1-sources.jar	368 KB
monsoon-engine-2.3.1-javadoc.jar	3 MB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.github.groupon.monsoon/monsoon-engine/ -->
<dependency>
    <groupId>com.github.groupon.monsoon</groupId>
    <artifactId>monsoon-engine</artifactId>
    <version>2.3.1</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.github.groupon.monsoon/monsoon-engine/
implementation 'com.github.groupon.monsoon:monsoon-engine:2.3.1'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.github.groupon.monsoon/monsoon-engine/
implementation ("com.github.groupon.monsoon:monsoon-engine:2.3.1")

Apache Buildr

'com.github.groupon.monsoon:monsoon-engine:jar:2.3.1'

Apache Ivy

<dependency org="com.github.groupon.monsoon" name="monsoon-engine" rev="2.3.1">
  <artifact name="monsoon-engine" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.github.groupon.monsoon', module='monsoon-engine', version='2.3.1')
)

Scala SBT

libraryDependencies += "com.github.groupon.monsoon" % "monsoon-engine" % "2.3.1"

Leiningen

[com.github.groupon.monsoon/monsoon-engine "2.3.1"]

Dependencies

compile (15)

Group / Artifact	Type	Version
com.github.groupon.monsoon : monsoon-collector-base	jar	2.3.1
com.github.groupon.monsoon : monsoon-lib	jar	2.3.1
com.github.groupon.monsoon : monsoon-expr	jar	2.3.1
com.github.groupon.monsoon : monsoon-impl-intf	jar	2.3.1
com.github.groupon.monsoon : monsoon-collector-http	jar	2.3.1
com.github.groupon.monsoon : monsoon-collector-collectd	jar	2.3.1
com.github.groupon.monsoon : monsoon-collector-jmx	jar	2.3.1
com.github.groupon.monsoon : monsoon-collector-tcp	jar	2.3.1
com.github.groupon.monsoon : monsoon-api	jar	2.3.1
org.apache.httpcomponents : httpcore-nio	jar	4.4.4
org.antlr : antlr4-runtime	jar	4.7
joda-time : joda-time	jar	2.8
com.google.guava : guava	jar	19.0
javax.servlet : javax.servlet-api	jar	3.1.0
net.sf.trove4j : trove4j	jar	3.0.3

provided (1)

Group / Artifact	Type	Version
org.projectlombok : lombok	jar	1.16.8

test (6)

Group / Artifact	Type	Version
junit : junit	jar	4.12
org.hamcrest : hamcrest-all	jar	1.3
org.hamcrest : hamcrest-library	jar	1.3
org.mockito : mockito-all	jar	1.10.19
org.powermock : powermock-module-junit4	jar	1.6.2
org.powermock : powermock-api-mockito	jar	1.6.2

Project Modules

There are no modules declared in this project.

Mon-soon

An extensible monitor system that checks java processes and exposes metrics based on them.

The project is extensible and allows for new datasources to be created, so it's not just Java it can monitor.

It should be easy to implement a new processor, to direct monitored data to other systems.

Monsoon supports:

1. collectd Metrics
2. JMX local and remote.
3. URL HTTP (think a simple pingdom)
4. Scrape a JSON endpoint over HTTP, I.E Hadoop metricz endpoint.
5. A history module that will write time series to disk.
6. It has metrics API endpoint for graphing ( work in progress).
7. It also has a prometheus exporter.
8. A simple TCP collector (can be used to see if a port is open).

Usage

The system uses processors to hook up to external metric and alerting systems. Processors are what turns the system from a pile of code into a useful component of your production deployment.

Configuration

Please refer to the configuration documentation.

---

Prometheus Integration

The Prometheus exporter will take all jmx metrics and convert them to a format that Prometheus can scrape prometheus.jar.

Development

Development documentation has its own section.

Groupon

Versions

Version
2.3.1 Dec 19, 2017
2.3 Dec 7, 2017
2.2.1 Nov 3, 2016
2.2 Oct 22, 2016
2.1.1 Sep 28, 2016
2.1 Sep 17, 2016
2.0 Aug 31, 2016