Mon-soon misc components

The root of the mon-soon project.

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

Download monsoon-lib

Filename	Size
monsoon-lib-2.3.1.pom
monsoon-lib-2.3.1.jar	50 KB
monsoon-lib-2.3.1-sources.jar	22 KB
monsoon-lib-2.3.1-javadoc.jar	100 KB

How to add to project

Apache Maven

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

Gradle Groovy

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

Gradle Kotlin

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

Apache Buildr

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

Apache Ivy

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

Groovy Grape

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

Scala SBT

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

Leiningen

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

Dependencies

compile (3)

Group / Artifact	Type	Version
joda-time : joda-time	jar	2.8
args4j : args4j	jar	2.33
javax.servlet : javax.servlet-api	jar	3.1.0

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