# DCMonitor

**Repository Path**: m_aleen/DCMonitor

## Basic Information

- **Project Name**: DCMonitor
- **Description**: Data Center monitor, included zookeeper, kafka, druid
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2018-08-10
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

DCMonitor

A simple, lightweight Data Center monitor, currently includes Zookeeper, Kafka, [Druid](http://druid.io/)(in progress). Motivated by [KafkaOffsetMonitor](https://github.com/quantifind/KafkaOffsetMonitor), but faster and more stable.

It is written in java, and use [Prometheus](http://prometheus.io/) as historical metrics storage.

	
##License

[The MIT License (MIT)](https://opensource.org/licenses/MIT)

###Zookeeper monitor


![](img/zk.png)

###Kafka monitor


![](img/kafka_sum.png)
![](img/kafka_offset.png)

###Druid monitor

![](img/druid_sum.png)

##Dependences

* Run
	* java(1.7 or later)
	* [Prometheus](http://prometheus.io/)
* Compile
	* maven
	* java(1.7 or later)

##Installation

* Set up your Zookeeper, Kafka, Druid(If you have) for monitoring.

* Set up [Prometheus/](http://prometheus.io/).
	* Download a Prometheus release 0.16.0 from [https://github.com/prometheus/prometheus/releases](https://github.com/prometheus/prometheus/releases) and set it up following [http://prometheus.io/docs/introduction/getting_started/](http://prometheus.io/docs/introduction/getting_started/), you can stop before [here](http://prometheus.io/docs/introduction/getting_started/#using-the-graphing-interface) if you don't want to go deep into prometheus. And don't worry, it is extremely easy.
	* Add a job to scrape DCMonitor's metrics, job config should looks like:
	
		```
		  - job_name: 'dcmonitor'
		    scrape_interval: 5s
		    scrape_timeout: 10s
		    target_groups:
		      - targets: ['localhost:8075']
		```
    	Here `localhost:8075` is the DCMonitor's host:port which web service listen on (configured in `application.properties`). The completed example is [here](https://github.com/shunfei/DCMonitor/blob/master/config/prometheus.yml).

		After that go to `http://<hostname>:9090/status`, expected to see the dcmonitor endpoints in targets section. It is in `UNHEALTHY` state because we havn't set up DCMonitor web service yet!
    
    ![](img/prometheus_status.png)


* Compile & deploy DCMonitor

	* Compile
	
		```
		git clone git@github.com:shunfei/DCMonitor.git
		cd DCMonitor
		./build.sh
		```
		Then a `target` folder will be generated under root folder.
	
	* Deploy
	
		You only need to deploy `target`, `run.sh`, `config` to target machine. 
		
		Modify configurations in `config/config.json` and `application.properties`.
		
		Run `run.sh`, will start the DCMonitor web service. If every thing is fine, visit `http://<hostname>:8075` to enjoy!